<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Publishing Principles</title><link rel="stylesheet" type="text/css" href="manual.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /><link rel="home" href="index.html" title="DocBook to LaTeX Publishing" /><link rel="up" href="ch01.html" title="Chapter 1. Introduction" /><link rel="prev" href="sec-changelog.html" title="Change History" /><link rel="next" href="sec-install.html" title="Chapter 2. Installing the Package" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Publishing Principles</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="sec-changelog.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Introduction</th><td width="20%" align="right"> <a accesskey="n" href="sec-install.html">Next</a></td></tr></table><hr /></div><div class="section" title="Publishing Principles"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp2527536"></a>Publishing Principles</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="ch01s05.html#sec-process">Backend Drivers</a></span></dt><dt><span class="section"><a href="ch01s05.html#sec-stylesheets">XSL Stylesheets</a></span></dt><dt><span class="section"><a href="ch01s05.html#sec-perl-process">Python Post Processing</a></span></dt><dt><span class="section"><a href="ch01s05.html#idm883848">LaTeX Style Package</a></span></dt></dl></div><p>Dblatex transforms a DocBook XML/SGML document to LaTeX. Once
transformed into LaTeX, standard LaTeX tools are used to produce DVI,
Postcript or PDF files.</p><p><a class="xref" href="ch01s05.html#fig-processus" title="Figure 1.1. Transforming Process">Figure 1.1, “Transforming Process”</a> explains the process applied. It shows
the tools used and the steps. The emphasized tools are provided by the
package.</p><div class="figure"><a id="fig-processus"></a><p class="title"><strong>Figure 1.1. Transforming Process</strong></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="processus.png" align="middle" alt="Transforming Process" /></div></div></div><br class="figure-break" /><div class="section" title="Backend Drivers"><div class="titlepage"><div><div><h3 class="title"><a id="sec-process"></a>Backend Drivers</h3></div></div></div><p>The main script supports the following LaTeX backend drivers:</p><div class="variablelist"><dl><dt><span class="term">dvips</span></dt><dd><p>The driver calls <span class="command"><strong>latex</strong></span>, and produces DVI, Postscript
and at the end PDF files. Latex natively accepts only EPS graphics. The
drawback is that converting to PDF can take a while.</p></dd><dt><span class="term">pdftex</span></dt><dd><p>The driver calls <span class="command"><strong>pdflatex</strong></span>, to directly produce PDF
files. The conversion is fast, the file size is smaller. Pdflatex natively
accepts PDF, PNG, JPEG, and TIFF graphics.</p></dd><dt><span class="term">xetex</span></dt><dd><p>The driver calls <span class="command"><strong>xelatex</strong></span>, to directly produce PDF
files through the <a class="ulink" href="http://scripts.sil.org/xetex" target="_top">XeTeX</a>
engine. This engine natively supports UTF-8 which improves multilingual
support.</p></dd></dl></div></div><div class="section" title="XSL Stylesheets"><div class="titlepage"><div><div><h3 class="title"><a id="sec-stylesheets"></a>XSL Stylesheets</h3></div></div></div><p>The XSL stylesheets located under <code class="filename">xsl/</code> are used to
transform from XML to “raw” LaTeX. The main file is
<code class="filename">latex_book_fast.xsl</code>, that includes the other stylesheets
of the directory.</p></div><div class="section" title="Python Post Processing"><div class="titlepage"><div><div><h3 class="title"><a id="sec-perl-process"></a>Python Post Processing</h3></div></div></div><p>Actually the XSL stylesheets does not produce valid LaTeX. The reason is
that some DocBook processing is too complex or too time-consuming for XSL
transforming. Besides, some extra actions need sometimes to be done such like
figure conversion. Here are the main actions done by Python Post
processing:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Transform the entities to valid LaTeX characters (e.g. &nbsp; is
transformed to '~'). Python is suited and performant for this task.</p></li><li class="listitem"><p>Convert the figures to be compatible with the backend driver. See <a class="xref" href="sec-figinclude.html" title="Figure Inclusion">the section called “
Figure Inclusion
”</a> for more detail.</p></li><li class="listitem"><p>Force some hyphenation in tables or for typed words.</p></li><li class="listitem"><p>Do the whole LaTeX compilation sequence thanks to the <a class="ulink" href="http://www.pps.jussieu.fr/~beffara/soft/rubber" target="_top">rubber</a>
compilation engine.</p></li></ul></div></div><div class="section" title="LaTeX Style Package"><div class="titlepage"><div><div><h3 class="title"><a id="idm883848"></a>LaTeX Style Package</h3></div></div></div><p>Once valid LaTeX is available, the LaTeX style package (docbook.sty)
under <code class="filename">latex/style/</code> is used to customize the output
rendering. It includes the other files of the directory. You can also provide
your own LaTeX style (cf. <a class="xref" href="sec-custom.html" title="Chapter 4. Customization">Chapter 4, <em>Customization</em></a>).</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="sec-changelog.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="sec-install.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Change History </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 2. Installing the Package</td></tr></table></div></body></html>