source: trunk/third/libxslt/doc/docbook.html @ 18543

Revision 18543, 8.2 KB checked in by ghudson, 21 years ago (diff)
This commit was generated by cvs2svn to compensate for changes in r18542, which included commits to RCS files with non-trunk default branches.
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
2<html>
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
5<style type="text/css"><!--
6TD {font-family: Verdana,Arial,Helvetica}
7BODY {font-family: Verdana,Arial,Helvetica; margin-top: 2em; margin-left: 0em; margin-right: 0em}
8H1 {font-family: Verdana,Arial,Helvetica}
9H2 {font-family: Verdana,Arial,Helvetica}
10H3 {font-family: Verdana,Arial,Helvetica}
11A:link, A:visited, A:active { text-decoration: underline }
12--></style>
13<title>DocBook</title>
14</head>
15<body bgcolor="#8b7765" text="#000000" link="#000000" vlink="#000000">
16<table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr>
17<td width="100">
18<a href="http://www.gnome.org/"><img src="gnome2.png" alt="Gnome2 Logo"></a><a href="http://www.redhat.com"><img src="redhat.gif" alt="Red Hat Logo"></a><div align="left"><a href="http://xmlsoft.org/XSLT/"><img src="Libxslt-Logo-180x168.gif" alt="Made with Libxslt Logo"></a></div>
19</td>
20<td><table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000"><tr><td><table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd"><tr><td align="center">
21<h1>The XSLT C library for Gnome</h1>
22<h2>DocBook</h2>
23</td></tr></table></td></tr></table></td>
24</tr></table>
25<table border="0" cellpadding="4" cellspacing="0" width="100%" align="center"><tr><td bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr>
26<td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td>
27<table width="100%" border="0" cellspacing="1" cellpadding="3">
28<tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr>
29<tr><td bgcolor="#fffacd">
30<form action="search.php" enctype="application/x-www-form-urlencoded" method="GET">
31<input name="query" type="TEXT" size="20" value=""><input name="submit" type="submit" value="Search ...">
32</form>
33<ul>
34<li><a href="index.html">Home</a></li>
35<li><a href="intro.html">Introduction</a></li>
36<li><a href="docs.html">Documentation</a></li>
37<li><a href="bugs.html">Reporting bugs and getting help</a></li>
38<li><a href="help.html">How to help</a></li>
39<li><a href="downloads.html">Downloads</a></li>
40<li><a href="FAQ.html">FAQ</a></li>
41<li><a href="news.html">News</a></li>
42<li><a href="xsltproc2.html">The xsltproc tool</a></li>
43<li><a href="docbook.html">DocBook</a></li>
44<li><a href="API.html">The programming API</a></li>
45<li><a href="python.html">Python and bindings</a></li>
46<li><a href="internals.html">Library internals</a></li>
47<li><a href="extensions.html">Writing extensions</a></li>
48<li><a href="contribs.html">Contributions</a></li>
49<li>
50<a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a>
51</li>
52</ul>
53</td></tr>
54</table>
55<table width="100%" border="0" cellspacing="1" cellpadding="3">
56<tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr>
57<tr><td bgcolor="#fffacd"><ul>
58<li><a href="tutorial/libxslttutorial.html">Tutorial</a></li>
59<li><a href="xsltproc.html">Man page for xsltproc</a></li>
60<li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li>
61<li><a href="http://xmlsoft.org/">XML libxml</a></li>
62<li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li>
63<li><a href="ftp://xmlsoft.org/">FTP</a></li>
64<li><a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a></li>
65<li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li>
66<li><a href="http://www.zveno.com/open_source/libxml2xslt.html">MacOsX binaries</a></li>
67<li><a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a></li>
68<li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li>
69<li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li>
70</ul></td></tr>
71</table>
72<table width="100%" border="0" cellspacing="1" cellpadding="3">
73<tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>API Indexes</b></center></td></tr>
74<tr><td bgcolor="#fffacd"><ul>
75<li><a href="APIchunk0.html">Alphabetic</a></li>
76<li><a href="APIconstructors.html">Constructors</a></li>
77<li><a href="APIfunctions.html">Functions/Types</a></li>
78<li><a href="APIfiles.html">Modules</a></li>
79<li><a href="APIsymbols.html">Symbols</a></li>
80</ul></td></tr>
81</table>
82</td></tr></table></td>
83<td valign="top" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%"><tr><td><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td><table border="0" cellpadding="3" cellspacing="1" width="100%"><tr><td bgcolor="#fffacd">
84<p>
85<a href="http://www.oasis-open.org/committees/docbook/">DocBook</a> is an
86XML/SGML vocabulary particularly well suited to books and papers about
87computer hardware and software.</p>
88<p>xsltproc and libxslt are not specifically dependant on DocBook, but since
89a lot of people use xsltproc and libxml2 for DocBook formatting, here are a
90few pointers and informations which may be helpful:</p>
91<ul>
92<li>The <a href="http://www.oasis-open.org/committees/docbook/">DocBook
93    homepage at Oasis</a> you should find pointers there on all the lastest
94    versions of the DTDs and XSLT stylesheets</li>
95  <li>
96<a href="http://www.docbook.org/">DocBook: The Definitive Guide</a> is
97    the official reference documentation for DocBook.</li>
98  <li>
99<a href="https://sourceforge.net/docman/index.php?group_id=21935">DocBook
100    Open Repository</a> contains a lot of informations about DocBook</li>
101  <li>Here is a <a href="/buildDocBookCatalog">shell script</a> to generate
102    XML Catalogs for DocBook 4.1.2 . If it can write to the /etc/xml/
103    directory, it will set-up /etc/xml/catalog and /etc/xml/docbook based on
104    the resources found on the system. Otherwise it will just create
105    ~/xmlcatalog and ~/dbkxmlcatalog and doing:
106    <p><code>export XMLCATALOG=$HOME/xmlcatalog</code></p>
107    <p>should allow to process DocBook documentations without requiring
108    network accesses for the DTd or stylesheets</p>
109  </li>
110  <li>I have uploaded <a href="ftp://xmlsoft.org/test/dbk412catalog.tar.gz">a
111    small tarball</a> containing XML Catalogs for DocBook 4.1.2 which seems
112    to work fine for me too</li>
113  <li>Informations on installing a <a href="http://ourworld.compuserve.com/homepages/hoenicka_markus/ntsgml.html">Windows
114    DocBook processing setup</a> based on Cygwin (using the binaries from the
115    official Windows port should be possible too)</li>
116  <li>Alexander Kirillov's page on <a href="http://www.math.sunysb.edu/~kirillov/dbxml/">Using DocBook XML
117    4.1.2</a> (RPM packages)</li>
118  <li>Tim Waugh's <a href="http://cyberelk.net/tim/xmlto/">xmlto front-end
119    conversion script</a>
120</li>
121  <li>Linux Documentation Project <a href="http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/">
122    DocBook-Install-mini-HOWTO</a>
123</li>
124  <li>ScrollKeeper the open documentation cataloging project has a <a href="http://scrollkeeper.sourceforge.net/docbook.shtml">DocBook
125    section</a>
126</li>
127  <li>Dan York presentation on <a href="http://www.lodestar2.com/people/dyork/talks/2001/xugo/docbook/index.html">Publishing
128    using DocBook XML</a>
129</li>
130</ul>
131<p>Do not use the --docbook option of xsltproc to process XML DocBook
132documents, this option is only intended to provide some (limited) support of
133the SGML version of DocBook.</p>
134<p>Points which are not DocBook specific but still worth mentionning
135again:</p>
136<ul>
137<li>if you think DocBook processing time is too slow, make sure you have
138    XML Catalogs pointing to a local installation of the DTD of DocBook.
139    Check the <a href="http://xmlsoft.org/catalog.html">XML Catalog page</a>
140    to understand more on this subject.</li>
141  <li>before processing a new document, use the command
142    <p><code>xmllint --valid --noout path_to_document</code></p>
143    <p>to make sure that your input is valid DocBook. And fixes the errors
144    before processing further. Note that XSLT processing may work correctly
145    with some forms of validity errors left, but in general it can give
146    troubles on output.</p>
147  </li>
148</ul>
149<p><a href="bugs.html">Daniel Veillard</a></p>
150</td></tr></table></td></tr></table></td></tr></table></td>
151</tr></table></td></tr></table>
152</body>
153</html>
Note: See TracBrowser for help on using the repository browser.