<pre style='margin:0'>
Rainer Müller (raimue) pushed a commit to branch master
in repository macports-guide.

</pre>
<p><a href="https://github.com/macports/macports-guide/commit/b4f8c99d76ae4451d5e01b08d436290bbc05c26b">https://github.com/macports/macports-guide/commit/b4f8c99d76ae4451d5e01b08d436290bbc05c26b</a></p>
<pre style="white-space: pre; background: #F8F8F8"><span style='display:block; white-space:pre;color:#808000;'>commit b4f8c99d76ae4451d5e01b08d436290bbc05c26b
</span>Author: Rainer Müller <raimue@macports.org>
AuthorDate: Sun Apr 15 05:23:11 2018 +0200

<span style='display:block; white-space:pre;color:#404040;'>    README: More detailed instructions
</span>---
 README.md | 42 ++++++++++++++++++++++++++++++++++--------
 1 file changed, 34 insertions(+), 8 deletions(-)

<span style='display:block; white-space:pre;color:#808080;'>diff --git a/README.md b/README.md
</span><span style='display:block; white-space:pre;color:#808080;'>index ca494d9..8b1027e 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/README.md
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/README.md
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -14,17 +14,43 @@ master to make the documentation available.
</span> 
 ## Building
 
<span style='display:block; white-space:pre;background:#ffe0e0;'>-To generate it you have to checkout the entire "macports-guide" repository,
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-and you need the "docbook-xsl", "docbook-xml-5.0" and "libxslt" ports.
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-If your port installation isn't in /opt/local, edit or override the
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-PREFIX Makefile variable.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+To generate  the guide, clone the macports-guide repository:
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+```
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+$ git clone https://github.com/macports/macports-guide.git
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+$ cd macports-guide/
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+```
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+You will also need the following tools which are required to convert the
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+DocBook XML sources to the desired output format. You can install them from
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+MacPorts with this command:
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+```
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+$ sudo port install libxml2 libxslt docbook-xsl docbook-xml-5.0
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+```
</span> 
 ### HTML Output
 
<span style='display:block; white-space:pre;background:#ffe0e0;'>-To generate the guide just run "make" in this directory; the HTML version will
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-be placed in guide/html.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+To generate the guide just run `make` in this directory; the HTML version will
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+be placed in `guide/html/`.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+```
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+$ make
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+$ open guide/html/index.html
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+```
</span> 
 ### PDF Output
 
<span style='display:block; white-space:pre;background:#ffe0e0;'>-To generate a PDF version of the guide, use "make guide-dblatex". This
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>-requires the "dblatex" port.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+In addition to the dependencies listed above, the PDF output format also
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+requires the `dblatex` port.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+```
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+$ sudo port install dblatex
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+```
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+To generate a PDF version of the guide, use `make guide-dblatex`.
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+```
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+$ make guide-dblatex
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+$ open guide/dblatex/macports-guide.pdf
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+```
</span></pre><pre style='margin:0'>

</pre>