|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
|
|
Packit Service |
76cb02 |
<section id="sec-pub-output">
|
|
Packit Service |
76cb02 |
<title>Publishing Outputs</title>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<section>
|
|
Packit Service |
76cb02 |
<title>Publishing a single document</title>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>The default publishing document units are: <sgmltag>article</sgmltag>
|
|
Packit Service |
76cb02 |
and <sgmltag>book</sgmltag>. The output file name is optionnaly specified by
|
|
Packit Service |
76cb02 |
the <option>-o</option> option.</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>You can also publish an article or book subset, i.e. you can run dblatex
|
|
Packit Service |
76cb02 |
on an XML input whose root element is a <sgmltag>chapter</sgmltag>, a
|
|
Packit Service |
76cb02 |
<sgmltag>section</sgmltag>, or anything else. In this case, dblatex wraps the
|
|
Packit Service |
76cb02 |
root element in an <sgmltag>article</sgmltag> or in a <sgmltag>book</sgmltag>
|
|
Packit Service |
76cb02 |
and print out a warning. The output subset does not contain any front matter
|
|
Packit Service |
76cb02 |
data found in an article or in a book (cover page, revision history, etc.),
|
|
Packit Service |
76cb02 |
but it can contain some back matter materials like an index.</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<programlisting>$ dblatex subset.xml
|
|
Packit Service |
76cb02 |
Build the book set list...
|
|
Packit Service |
76cb02 |
Build the listings...
|
|
Packit Service |
76cb02 |
XSLT stylesheets DocBook - LaTeX 2e (0.2.11)
|
|
Packit Service |
76cb02 |
===================================================
|
|
Packit Service |
76cb02 |
Warning: the root element is not an article nor a book
|
|
Packit Service |
76cb02 |
Warning: element section(sec-subset) wrapped with article
|
|
Packit Service |
76cb02 |
Build subset.pdf
|
|
Packit Service |
76cb02 |
...
|
|
Packit Service |
76cb02 |
</programlisting>
|
|
Packit Service |
76cb02 |
</section>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<section id="sec-book-set">
|
|
Packit Service |
76cb02 |
<title>Publishing a Set of Books</title>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>When the document root element is a <sgmltag>set</sgmltag>, and when
|
|
Packit Service |
76cb02 |
<parameter>set.book.num</parameter> is set to '<literal>all</literal>',
|
|
Packit Service |
76cb02 |
dblatex ouputs a file per book contained in the set (and in the nested sets).
|
|
Packit Service |
76cb02 |
In this case the <option>-o</option> option is ignored, and only the
|
|
Packit Service |
76cb02 |
<option>-O</option> option is taken into account to specify the output
|
|
Packit Service |
76cb02 |
directory that will contain the generated files.</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>Instead of building all the books, the user can publish a single book
|
|
Packit Service |
76cb02 |
from the set, by setting the <parameter>set.book.num</parameter> parameter to
|
|
Packit Service |
76cb02 |
the absolute position of the book in the set(s). By default
|
|
Packit Service |
76cb02 |
<parameter>set.book.num</parameter> is set to 1 to publish only the first
|
|
Packit Service |
76cb02 |
book.</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>The output file names are the book identifiers when
|
|
Packit Service |
76cb02 |
<parameter>use.id.as.filename</parameter> is non zero, and when an identifier
|
|
Packit Service |
76cb02 |
exists. If one of the two conditions are not met, the filename pattern is
|
|
Packit Service |
76cb02 |
"<filename>book<replaceable><position in set></replaceable></filename>".
|
|
Packit Service |
76cb02 |
</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para>Example: given the following set:</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para><programlisting language="XML"><?xml version="1.0" encoding="UTF-8"?>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<!-- setfile.xml. An example of set. All the books have an @id except one -->
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<!DOCTYPE set PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
|
|
Packit Service |
76cb02 |
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
|
|
Packit Service |
76cb02 |
<set lang="en" id="a_set" xmlns:xi="http://www.w3.org/2001/XInclude">
|
|
Packit Service |
76cb02 |
<title>Set Title</title>
|
|
Packit Service |
76cb02 |
<set>
|
|
Packit Service |
76cb02 |
<xi:include href="book1.xml"/> <!-- book #1 -->
|
|
Packit Service |
76cb02 |
<xi:include href="book2.xml"/> <!-- book #2 -->
|
|
Packit Service |
76cb02 |
<xi:include href="book3.xml"/> <!-- book #3 -->
|
|
Packit Service |
76cb02 |
</set>
|
|
Packit Service |
76cb02 |
<set>
|
|
Packit Service |
76cb02 |
<set>
|
|
Packit Service |
76cb02 |
<xi:include href="bookA.xml"/> <!-- book #4 -->
|
|
Packit Service |
76cb02 |
<xi:include href="bookB.xml"/> <!-- book #5 -->
|
|
Packit Service |
76cb02 |
</set>
|
|
Packit Service |
76cb02 |
<set>
|
|
Packit Service |
76cb02 |
<xi:include href="bookC.xml"/> <!-- book #6 -->
|
|
Packit Service |
76cb02 |
</set>
|
|
Packit Service |
76cb02 |
</set>
|
|
Packit Service |
76cb02 |
<set>
|
|
Packit Service |
76cb02 |
<xi:include href="book4.xml"/> <!-- book #7 -->
|
|
Packit Service |
76cb02 |
<!-- The following book, at 8th position in the sets, has no @id -->
|
|
Packit Service |
76cb02 |
<xi:include href="book5.xml"/> <!-- book #8 -->
|
|
Packit Service |
76cb02 |
<xi:include href="book6.xml"/> <!-- book #9 -->
|
|
Packit Service |
76cb02 |
</set>
|
|
Packit Service |
76cb02 |
</set></programlisting>Publishing this set produces 9 books in the
|
|
Packit Service |
76cb02 |
<filename>pdfdir</filename> directory:</para>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<programlisting>$ dblatex -O./pdfdir -Pset.book.num=all -Puse.id.as.filename=1 setfile.xml
|
|
Packit Service |
76cb02 |
Build the book set list...
|
|
Packit Service |
76cb02 |
Build the listings...
|
|
Packit Service |
76cb02 |
XSLT stylesheets DocBook - LaTeX 2e (0.2.11)
|
|
Packit Service |
76cb02 |
===================================================
|
|
Packit Service |
76cb02 |
Output all the books from the set
|
|
Packit Service |
76cb02 |
Writing sec1-mybook.rtex for book(sec1-mybook)
|
|
Packit Service |
76cb02 |
Writing sec2-mybook.rtex for book(sec2-mybook)
|
|
Packit Service |
76cb02 |
Writing sec3-mybook.rtex for book(sec3-mybook)
|
|
Packit Service |
76cb02 |
Writing secA-mybook.rtex for book(secA-mybook)
|
|
Packit Service |
76cb02 |
Writing book8.rtex for book
|
|
Packit Service |
76cb02 |
Writing secC-mybook.rtex for book(secC-mybook)
|
|
Packit Service |
76cb02 |
Writing sec4-mybook.rtex for book(sec4-mybook)
|
|
Packit Service |
76cb02 |
Writing sec5-mybook.rtex for book(sec5-mybook)
|
|
Packit Service |
76cb02 |
Writing sec6-mybook.rtex for book(sec6-mybook)
|
|
Packit Service |
76cb02 |
...
|
|
Packit Service |
76cb02 |
Files successfully built in '/path/to/set/pdfdir':
|
|
Packit Service |
76cb02 |
sec1-mybook.pdf
|
|
Packit Service |
76cb02 |
sec2-mybook.pdf
|
|
Packit Service |
76cb02 |
sec3-mybook.pdf
|
|
Packit Service |
76cb02 |
sec4-mybook.pdf
|
|
Packit Service |
76cb02 |
book8.pdf
|
|
Packit Service |
76cb02 |
sec6-mybook.pdf
|
|
Packit Service |
76cb02 |
secA-mybook.pdf
|
|
Packit Service |
76cb02 |
secB-mybook.pdf
|
|
Packit Service |
76cb02 |
secC-mybook.pdf</programlisting>
|
|
Packit Service |
76cb02 |
|
|
Packit Service |
76cb02 |
<para></para>
|
|
Packit Service |
76cb02 |
</section>
|
|
Packit Service |
76cb02 |
</section>
|