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