boost_mirror/boostbook
1
0
Fork 0
mirror of https://github.com/boostorg/boostbook.git synced 2025-05-09 15:03:57 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update the docs for initializing the fop tool. Try to clarify them a bit,

Browse Source 
too.


[SVN r26736]
This commit is contained in:
Vladimir Prus 2005-01-19 07:37:54 +00:00
parent 6623659c07
commit fd0d572950
1 changed files with 20 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
doc/boostbook.xml
View File

@ -262,34 +262,33 @@ using boostbook : DOCBOOK_XSL_DIR
</section> </section>
<section id="boostbook.fop"> <section id="boostbook.fop">
<title>Configuring Apache FOP for PostScript/PDF Output</title> <title>Configuring PDF and PostScript Output</title>
<para>This section describes the steps required to configure <para>In order to generate PDF and PostScript output, you have to
<ulink url="http://xml.apache.org/fop/index.html">Apache install two tools:
FOP</ulink> to generate PostScript and PDF output for BoostBook
documents. To begin, you will need two pieces of software:
<itemizedlist> <itemizedlist>
<listitem><simpara>A Java interpreter, available at <ulink url="http://java.sun.com"/>.</simpara></listitem> <listitem><simpara>A Java interpreter, available at <ulink url="http://java.sun.com"/>.</simpara></listitem>
<listitem><simpara>Apache FOP, available at <ulink url="http://xml.apache.org/fop/download.html"/>. Version 0.20.4 seems to be most stable.</simpara></listitem> <listitem><simpara>Apache FOP, available at <ulink url="http://xml.apache.org/fop/download.html"/>. Version 0.20.4 seems to be most stable.</simpara></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
<para>Once Java is installed (we'll call Java's directory <para>Install the Java interpreter and then unpack Apache FOP to some
<code>JAVA_HOME</code>) and Apache FOP has been extracted into a directory. The top level directory of the FOP tool should contain a main
directory (we'll call FOP's directory <code>FOP_DIR</code>), we script called <filename>fop.sh</filename> on Unix and
need to configure Boost.Build to use FOP. Edit your <filename>fop.bat</filename> on Windows. You need to specify the
<filename>user-config.jam</filename> or location of that script and Java location to Boost.Build. Add the
<filename>site-config.jam</filename> and add the following, following to your <filename>user-config.jam</filename> or
replacing <code>FOP_DIR</code> with the directory where Apache <filename>site-config.jam</filename>:
FOP is installed, and replace <code>JAVA_HOME</code> with the <programlisting>
directory where Java is installed: using fop : FOP_COMMAND
: JAVA_HOME
<programlisting>using fop : FOP_DIR ;
: JAVA_HOME </programlisting> replacing
;</programlisting> <code>FOP_COMMAND</code> with the full path to the FOP main script, and
replacing <code>JAVA_HOME</code> with the directory where Java is
In some cases, <code>JAVA_HOME</code> is optional, but it often installed. If the <envar>JAVA_HOME</envar> environment variable is
helps to specify it.</para> already set, you don't need to specify it above.
</para>
<para>To test PDF generation, switch to the directory <filename <para>To test PDF generation, switch to the directory <filename
class="directory">$BOOST_ROOT/doc</filename> and execute the class="directory">$BOOST_ROOT/doc</filename> and execute the