<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 1 September 2005), see www.w3.org" />
<meta http-equiv="Content-Type" content=
"text/html; charset=us-ascii" />
<title>docbook2X: Converting to Texinfo</title>
<link rel="stylesheet" href="docbook2X.css" type="text/css" />
<link rev="made" href="mailto:stevecheng@users.sourceforge.net" />
<meta name="generator" content="DocBook XSL Stylesheets V1.68.1" />
<meta name="description" content="Details on Texinfo conversion" />
<link rel="start" href="docbook2X.html" title=
"docbook2X: Documentation Table of Contents" />
<link rel="up" href="docbook2X.html" title=
"docbook2X: Documentation Table of Contents" />
<link rel="prev" href="db2x_manxml.html" title=
"docbook2X: db2x_manxml" />
<link rel="next" href="docbook2texi.html" title=
"docbook2X: docbook2texi" />
</head>
<body>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr>
<th colspan="3" align="center">Converting to Texinfo</th>
</tr>
<tr>
<td width="20%" align="left"><a accesskey="p" href=
"db2x_manxml.html"><< Previous</a> </td>
<th width="60%" align="center"> </th>
<td width="20%" align="right"> <a accesskey="n" href=
"docbook2texi.html">Next >></a></td>
</tr>
</table>
<hr /></div>
<div class="sect1" lang="en" xml:lang="en">
<div class="titlepage">
<div>
<div>
<h2 class="title"><a id="texinfo" name="texinfo"></a>Converting to
Texinfo</h2>
</div>
</div>
</div>
<a id="id2528200" class="indexterm" name="id2528200"></a><a id=
"id2528207" class="indexterm" name="id2528207"></a><a id=
"id2528214" class="indexterm" name="id2528214"></a><a id=
"id2528829" class="indexterm" name="id2528829"></a>
<p>DocBook documents are converted to Texinfo in two steps:</p>
<div class="orderedlist">
<ol type="1">
<li>
<p>The DocBook source is converted by a XSLT stylesheet into an
intermediate XML format, Texi-XML.</p>
<p>Texi-XML is simpler than DocBook and closer to the Texinfo
format; it is intended to make the stylesheets’ job
easier.</p>
<p>The stylesheet for this purpose is in <code class=
"filename">xslt/texi/docbook.xsl</code>. For portability, it should
always be referred to by the following URI:</p>
<pre class="synopsis">
http://docbook2x.sourceforge.net/latest/xslt/texi/docbook.xsl
</pre>
<p>Run this stylesheet with <a href=
"db2x_xsltproc.html"><span><strong class=
"command">db2x_xsltproc</strong></span></a>.</p>
<a id="id2528888" class="indexterm" name="id2528888"></a>
<p><b>Customizing. </b> You can also customize the output by
creating your own XSLT stylesheet — changing parameters or
adding new templates — and importing <code class=
"filename">xslt/texi/docbook.xsl</code>.</p>
</li>
<li>
<p>Texi-XML is converted to the actual Texinfo files by <a href=
"db2x_texixml.html"><span><strong class=
"command">db2x_texixml</strong></span></a>.</p>
</li>
</ol>
</div>
<p>The <a href="docbook2texi.html" title=
"docbook2X: docbook2texi"><span><strong class=
"command">docbook2texi</strong></span></a> command does both steps
automatically, but if any problems occur, you can see the errors
more clearly if you do each step separately:</p>
<pre class="screen">
<code class="prompt">$ </code><strong class=
"userinput"><code>db2x_xsltproc -s texi <em class=
"replaceable"><code>mydoc</code></em>.xml -o <em class=
"replaceable"><code>mydoc</code></em>.txml</code></strong>
<code class="prompt">$ </code><strong class=
"userinput"><code>db2x_texixml <em class=
"replaceable"><code>mydoc</code></em>.txml</code></strong>
</pre>
<p>Options to the conversion stylesheet are described in <a href=
"../xslt/documentation/docbook2texi-xslt.html/docbook2texi-xslt.html">
the Texinfo stylesheets reference</a>.</p>
</div>
<div class="navfooter">
<hr />
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left"><a accesskey="p" href=
"db2x_manxml.html"><< Previous</a> </td>
<td width="20%" align="center"> </td>
<td width="40%" align="right"> <a accesskey="n" href=
"docbook2texi.html">Next >></a></td>
</tr>
<tr>
<td width="40%" align="left" valign="top"><span><strong class=
"command">db2x_manxml</strong></span> </td>
<td width="20%" align="center"><a accesskey="h" href=
"docbook2X.html">Table of Contents</a></td>
<td width="40%" align="right" valign="top"> docbook2texi</td>
</tr>
</table>
</div>
<p class="footer-homepage"><a href=
"http://docbook2x.sourceforge.net/" title=
"docbook2X: Home page">docbook2X home page</a></p>
</body>
</html>
