The sources for this guide are kept in a Git repository on GitHub. If you spot any error or outdated information, you are encouraged to submit a pull request following the steps outlined below.
$ git clone https://github.com/macports/macports-guide.git $ cd macports-guide $ git remote add username https://github.com/username/macports-guide.git
Install the required ports:
$ sudo port install libxslt docbook-xsl
For each change you want to make:
Make your changes to the file in the guide/xml/ directory that corresponds to the section you want to make changes to.
$ $EDITOR guide/xml/guide.xml
Verify your changes are still valid XML. If the +make validate+ command reports errors, fix the XML sources until you see no more error messages
$ make validate
Convert the guide to HTML and view the new version in your browser.
$ make guide $ open guide/html/index.html
Commit your changes to the local branch and describe your changes in the commit message. See also our wiki page CommitMessages that explains how to write good commit messages.
$ git commit -a