~ubuntu-branches/ubuntu/precise/dblatex/precise

« back to all changes in this revision

Viewing changes to docs/xhtml/manual/sec-style.html

  • Committer: Package Import Robot
  • Author(s): Andreas Hoenen
  • Date: 2011-07-09 15:20:37 UTC
  • mfrom: (0.8.1) (0.6.2) (8.1.7 sid)
  • mto: This revision was merged to the branch mainline in revision 9.
  • Revision ID: package-import@ubuntu.com-20110709152037-8ao9l07dmgyjn6vn
* New upstram release
* New upstream release fixes the following open Debian BTS issues:
  + Don't crash on XeTeX backend compilation of spanish documents with an
    <appendix> element.  Thanks to W. Martin Borgert for reporting.
    Closes: #629110
* Remove patches that have been integrated upstream:
  + 20_filename_replaceable.patch (#623590)
* Take over actualized copyright period of upstream COPYRIGHT to
  debian/copyright.
* Replace python build helper dh_pysupport with dh_python2.
* In draft mode set draft watermark for XeTeX backend, too.  Thanks to W.
  Martin Borgert for reporting and for the patch.  Closes: #629514

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
2
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
 
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Output Formatting Style</title><link rel="stylesheet" href="manual.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="index.html" title="DocBook to LaTeX Publishing" /><link rel="up" href="ch03.html" title="Chapter 3. Using dblatex" /><link rel="prev" href="re01.html" title="dblatex" /><link rel="next" href="sec-pub-output.html" title="Publishing Outputs" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Output Formatting Style</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re01.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Using dblatex</th><td width="20%" align="right"> <a accesskey="n" href="sec-pub-output.html">Next</a></td></tr></table><hr /></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sec-style"></a>Output Formatting Style</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="sec-style.html#id3405023">How it works</a></span></dt><dt><span class="section"><a href="sec-style.html#id3407348">Adding a New Formatting Style</a></span></dt></dl></div><p>The output rendering done by <span class="command"><strong>dblatex</strong></span> can be widely
 
3
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Output Formatting Style</title><link rel="stylesheet" href="manual.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /><link rel="start" href="index.html" title="DocBook to LaTeX Publishing" /><link rel="up" href="ch03.html" title="Chapter 3. Using dblatex" /><link rel="prev" href="ref-dblatex.html" title="dblatex" /><link rel="next" href="sec-pub-output.html" title="Publishing Outputs" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Output Formatting Style</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ref-dblatex.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Using dblatex</th><td width="20%" align="right"> <a accesskey="n" href="sec-pub-output.html">Next</a></td></tr></table><hr /></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sec-style"></a>Output Formatting Style</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="sec-style.html#id3406689">How it works</a></span></dt><dt><span class="section"><a href="sec-style.html#id3408192">Adding a New Formatting Style</a></span></dt></dl></div><p>The output rendering done by <span class="command"><strong>dblatex</strong></span> can be widely
4
4
customized like explained in <a class="xref" href="sec-custom.html" title="Chapter 4. Customization">Chapter 4, <i>Customization</i></a>. By default several
5
5
rendering styles are provided, that one can choose by using the option
6
6
<code class="option">-T</code> (see <a class="xref" href="sec-style.html#eg-style" title="Example 3.1. Choosing the DB2LaTeX style">Example 3.1, “Choosing the DB2LaTeX style”</a>). The available styles are:</p><div class="variablelist"><dl><dt><span class="term">native</span></dt><dd><p>The rendering uses the default LaTeX stylesheets. It is the style used by
9
9
around the default latex packages is very thin.</p></dd><dt><span class="term">db2latex</span></dt><dd><p>The rendering tries to be as close as possible to the
10
10
<a class="ulink" href="http://db2latex.sourceforge.net" target="_top">DB2LaTeX</a> formatting.</p></dd></dl></div><div class="example"><a id="eg-style"></a><p class="title"><b>Example 3.1. Choosing the DB2LaTeX style</b></p><div class="example-contents"><pre class="programlisting">
11
11
dblatex -T db2latex file.xml
12
 
</pre></div></div><br class="example-break" /><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id3405023"></a>How it works</h3></div></div></div><p>The rendering style stuff is under the <code class="filename">latex/</code>
 
12
</pre></div></div><br class="example-break" /><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id3406689"></a>How it works</h3></div></div></div><p>The rendering style stuff is under the <code class="filename">latex/</code>
13
13
directory. You can see the XSL stylesheets under <code class="filename">xsl/</code> as the
14
14
way to produce latex with as little as possible docbook specific things (even if a
15
15
large amount of latex packages are used to do the work). Then, it's up to LaTeX
36
36
</pre><p>
37
37
The list is built by scanning the specs files found under
38
38
<code class="filename">specs/</code>. The spec file syntax is described in <a class="xref" href="sec-specs.html" title="Dblatex Configuration File">the section called “Dblatex Configuration File”</a>.
39
 
</p></dd><dt><span class="term"><code class="filename">style</code></span></dt><dd><p>Default LaTeX stylesheets.</p></dd></dl></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id3407348"></a>Adding a New Formatting Style</h3></div></div></div><p>To add a new formatting style, do the following steps:</p><div class="procedure"><ol type="1"><li><p>Let's create the style directores that will contain all the specific
 
39
</p></dd><dt><span class="term"><code class="filename">style</code></span></dt><dd><p>Default LaTeX stylesheets.</p></dd></dl></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id3408192"></a>Adding a New Formatting Style</h3></div></div></div><p>To add a new formatting style, do the following steps:</p><div class="procedure"><ol type="1"><li><p>Let's create the style directores that will contain all the specific
40
40
data. We choose to put them under the default <span class="command"><strong>dblatex</strong></span>
41
41
user configuration directory.</p><pre class="programlisting">
42
42
$ mkdir -p $HOME/.dblatex/mystyle/latex
62
62
</pre></li><li><p>That's it. Try to compile your document with your style, and check the
63
63
output.</p><pre class="programlisting">
64
64
$ dblatex -T mystyle file.xml
65
 
</pre></li></ol></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re01.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="sec-pub-output.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">dblatex </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Publishing Outputs</td></tr></table></div></body></html>
 
65
</pre></li></ol></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ref-dblatex.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="sec-pub-output.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">dblatex </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Publishing Outputs</td></tr></table></div></body></html>