Only One Package Manager at a Time: A Guide to Installing DocBook Tools

When it comes to installing third-party DocBook tools on Mac OS X, there are two primary package managers to choose from: MacPorts and Homebrew (Brew). While both options can be effective, it is essential to note that only one package manager should be used at a time.

Installing Using Yum or EPEL

For those familiar with the yum package manager, installing DocBook tools is relatively straightforward. You can use the following commands:

* `yum install libxml2 libxslt fop docbook5-style-xsl docbook5-schemas`

* `yum localinstall fop xmlgraphics-commons-1.4-3`

* `yum install deja`

Alternatively, you can install these packages from EPEL, CentOS, source, or Whamcloud toolkit.

Installing Using Brew

For those who prefer to use Homebrew (Brew), the process is similar:

* `brew install fop libxml2 libxslt docbook5-style-xsl docbook5-schemas`

Original Development and Testing Environments

The original development work for the manual was completed using Ubuntu, with testing conducted on Ubuntu 18.04, RHEL7 Linux, and Mac OS X.

Reference Materials and Writing Style

For those new to DocBook XML syntax, reference materials are readily available online. The manual is written in Docbook XML version 5, with each chapter residing in a separate xml file.

Contributing to the Manual

Anyone can create changes that modify the current Lustre manual. Minor changes and fixes can be committed against the existing LUDOC-11 issue. To browse all existing issues or submit your own change, please visit the JIRA project, LUDOC.

Remember to always follow the rules on proper use of other party trademarks when contributing to the manual.

By following these guidelines, you can effectively install and contribute to the DocBook tools required for writing and maintaining the Lustre manual.

Brew install adobe reader