added a DocBook section docbook.html Daniel

* doc/site.xsl doc/*.html: added a DocBook section docbook.html Daniel
author: Daniel Veillard <veillard@src.gnome.org> 2002-01-08 12:52:22 +0000
committer: Daniel Veillard <veillard@src.gnome.org> 2002-01-08 12:52:22 +0000
commit: dc35c090b1bf089de566b54ae80a8529dc1ef82f (patch)
tree: 472337f3a7f2b4f5f676307a352aeededd27c048 /doc
parent: e6fcc302a8aa4221b747e554cee00a28dc4eea68 (diff)
download: libxslt-dc35c090b1bf089de566b54ae80a8529dc1ef82f.tar.gz
libxslt-dc35c090b1bf089de566b54ae80a8529dc1ef82f.tar.bz2
libxslt-dc35c090b1bf089de566b54ae80a8529dc1ef82f.zip
16 files changed, 172 insertions, 0 deletions
diff --git a/doc/API.html b/doc/API.html
index b5d19242..2dd24e37 100644
--- a/doc/API.html
+++ b/doc/API.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
diff --git a/doc/FAQ.html b/doc/FAQ.html
index 1ee762eb..c5620ae6 100644
--- a/doc/FAQ.html
+++ b/doc/FAQ.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
diff --git a/doc/bugs.html b/doc/bugs.html
index fa236d19..a16e996b 100644
--- a/doc/bugs.html
+++ b/doc/bugs.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
diff --git a/doc/contribs.html b/doc/contribs.html
index 4fdf87ea..86f4d538 100644
--- a/doc/contribs.html
+++ b/doc/contribs.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
diff --git a/doc/docbook.html b/doc/docbook.html
new file mode 100644
index 00000000..e47fee71
--- /dev/null
+++ b/doc/docbook.html
@@ -0,0 +1,110 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
+<html>
+<head>
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type">
+<style type="text/css"><!--
+TD {font-size: 10pt; font-family: Verdana,Arial,Helvetica}
+BODY {font-size: 10pt; font-family: Verdana,Arial,Helvetica; margin-top: 5pt; margin-left: 0pt; margin-right: 0pt}
+H1 {font-size: 16pt; font-family: Verdana,Arial,Helvetica}
+H2 {font-size: 14pt; font-family: Verdana,Arial,Helvetica}
+H3 {font-size: 12pt; font-family: Verdana,Arial,Helvetica}
+A:link, A:visited, A:active { text-decoration: underline }
+--></style>
+<title>DocBook</title>
+</head>
+<body bgcolor="#8b7765" text="#000000" link="#000000" vlink="#000000">
+<table border="0" width="100%" cellpadding="5" cellspacing="0" align="center"><tr>
+<td width="100">
+<a href="http://www.gnome.org/"><img src="smallfootonly.gif" alt="Gnome Logo"></a><a href="http://www.redhat.com"><img src="redhat.gif" alt="Red Hat Logo"></a>
+</td>
+<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">
+<h1>The XSLT C library for Gnome</h1>
+<h2>DocBook</h2>
+</td></tr></table></td></tr></table></td>
+</tr></table>
+<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>
+<td valign="top" width="200" bgcolor="#8b7765"><table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000"><tr><td>
+<table width="100%" border="0" cellspacing="1" cellpadding="3">
+<tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Main Menu</b></center></td></tr>
+<tr><td bgcolor="#fffacd"><ul style="margin-left: -2pt">
+<li><a href="index.html">Home</a></li>
+<li><a href="intro.html">Introduction</a></li>
+<li><a href="docs.html">Documentation</a></li>
+<li><a href="bugs.html">Reporting bugs and getting help</a></li>
+<li><a href="help.html">How to help</a></li>
+<li><a href="downloads.html">Downloads</a></li>
+<li><a href="FAQ.html">FAQ</a></li>
+<li><a href="news.html">News</a></li>
+<li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
+<li><a href="API.html">The programming API</a></li>
+<li><a href="internals.html">Library internals</a></li>
+<li><a href="extensions.html">Writing extensions</a></li>
+<li><a href="contribs.html">Contributions</a></li>
+<li>
+<a href="xslt.html">flat page</a>, <a href="site.xsl">stylesheet</a>
+</li>
+</ul></td></tr>
+</table>
+<table width="100%" border="0" cellspacing="1" cellpadding="3">
+<tr><td colspan="1" bgcolor="#eecfa1" align="center"><center><b>Related links</b></center></td></tr>
+<tr><td bgcolor="#fffacd"><ul style="margin-left: -2pt">
+<li><a href="tutorial/libxslttutorial.html">Tutorial</a></li>
+<li><a href="xsltproc.html">Man page for xsltproc</a></li>
+<li><a href="http://mail.gnome.org/archives/xslt/">Mail archive</a></li>
+<li><a href="http://xmlsoft.org/">XML libxml</a></li>
+<li><a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a></li>
+<li><a href="ftp://xmlsoft.org/">FTP</a></li>
+<li><a href="http://www.fh-frankfurt.de/~igor/projects/libxml/">Windows binaries</a></li>
+<li><a href="http://garypennington.net/libxml2/">Solaris binaries</a></li>
+<li><a href="http://bugzilla.gnome.org/buglist.cgi?product=libxslt">Bug Tracker</a></li>
+<li><a href="http://xsldbg.sourceforge.net/">Xsldbg Debugger</a></li>
+</ul></td></tr>
+</table>
+</td></tr></table></td>
+<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">
+<p>
+<a href="http://www.oasis-open.org/committees/docbook/">DocBook</a> is an
+XML/SGML vocabulary particularly well suited to books and papers about
+computer hardware and software.</p>
+<p>xsltproc and libxslt are not specifically dependant on DocBook, but since
+a lot of people use xsltproc and libxml2 for DocBook formatting, here are a
+few pointers and informations which may be helpful:</p>
+<ul>
+<li>The <a href="http://www.oasis-open.org/committees/docbook/">DocBook
+    homepage at Oasis</a> you should find pointers there on all the lastest
+    versions of the DTDs and XSLT stylesheets</li>
+<li>
+<a href="http://www.docbook.org/">DocBook: The Definitive Guide</a> is
+    the official reference documentation for DocBook.</li>
+<li>Ready to use  set of XML Catalogs and DocBook XML 4.1.2 Dtd for those
+    where their system doesn't provide them natively</li>
+<li>Informations on installing a <a href="http://ourworld.compuserve.com/homepages/hoenicka_markus/cygc2057.html">Windows
+    DocBook processing setup</a> based on Cygwin (using the binaries from the
+    official Windows port should be possible too) </li>
+<li>Alexander Kirillov's page on <a href="http://www.math.sunysb.edu/~kirillov/dbxml/">Using DocBook XML
+    4.1.2</a> (RPM packages)</li>
+</ul>
+<p>Do not use the --docbook option of xsltproc to process XML DocBook
+documents, this option is only intended to provide some (limited) support of
+the SGML version of DocBook.</p>
+<p>Points which are not DocBook specific but still worth mentionning
+again:</p>
+<ul>
+<li>if you think DocBook processing time is too slow, make sure you have
+    XML Catalogs pointing to a local installation of the DTD of DocBook.
+    Check the <a href="http://xmlsoft.org/catalog.html">XML Catalog page</a>
+    to understand more on this subject.</li>
+<li>before processing a new document, use the command
+    <p><code>xmllint --valid --noout path_to_document</code></p>
+<p>to make sure that your input is valid DocBook. And fixes the errors
+    before processing further. Note that XSLT processing may work correctly
+    with some forms of validity errors left, but in general it can give
+    troubles on output.</p>
+</li>
+</ul>
+<p><a href="mailto:daniel@veillard.com">Daniel Veillard</a></p>
+</td></tr></table></td></tr></table></td></tr></table></td>
+</tr></table></td></tr></table>
+</body>
+</html>
diff --git a/doc/docs.html b/doc/docs.html
index 5a2a5978..13ce4f85 100644
--- a/doc/docs.html
+++ b/doc/docs.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
diff --git a/doc/downloads.html b/doc/downloads.html
index b2540327..1044b310 100644
--- a/doc/downloads.html
+++ b/doc/downloads.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
diff --git a/doc/extensions.html b/doc/extensions.html
index d67e6974..0e5c4d0c 100644
--- a/doc/extensions.html
+++ b/doc/extensions.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
diff --git a/doc/help.html b/doc/help.html
index 5ab1c1ed..fdfca330 100644
--- a/doc/help.html
+++ b/doc/help.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
diff --git a/doc/index.html b/doc/index.html
index a1030c3c..4faf52b8 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
diff --git a/doc/internals.html b/doc/internals.html
index 72e5ca30..46325129 100644
--- a/doc/internals.html
+++ b/doc/internals.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
diff --git a/doc/intro.html b/doc/intro.html
index 0fd3433a..91863691 100644
--- a/doc/intro.html
+++ b/doc/intro.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
diff --git a/doc/news.html b/doc/news.html
index eb301300..c4b395d4 100644
--- a/doc/news.html
+++ b/doc/news.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
diff --git a/doc/site.xsl b/doc/site.xsl
index 453685a7..8d7dc437 100644
--- a/doc/site.xsl
+++ b/doc/site.xsl
@@ -43,6 +43,9 @@
       <xsl:when test="$name = '#Internals'">
         <xsl:text>internals.html</xsl:text>
       </xsl:when>
+      <xsl:when test="$name = '#DocBook'">
+        <xsl:text>docbook.html</xsl:text>
+      </xsl:when>
       <xsl:when test="$name = '#FAQ'">
         <xsl:text>FAQ.html</xsl:text>
       </xsl:when>
diff --git a/doc/xslt.html b/doc/xslt.html
index 38e17c57..981876cd 100644
--- a/doc/xslt.html
+++ b/doc/xslt.html
@@ -534,6 +534,52 @@ Usage: xsltproc [options] stylesheet file [file ...]
       --profile or --norman : dump profiling informations 
 orchis:~ -&gt;</pre>
 
+<h2><a name="DocBook">DocBook</a></h2>
+
+<p><a href="http://www.oasis-open.org/committees/docbook/">DocBook</a> is an
+XML/SGML vocabulary particularly well suited to books and papers about
+computer hardware and software.</p>
+
+<p>xsltproc and libxslt are not specifically dependant on DocBook, but since
+a lot of people use xsltproc and libxml2 for DocBook formatting, here are a
+few pointers and informations which may be helpful:</p>
+<ul>
+  <li>The <a href="http://www.oasis-open.org/committees/docbook/">DocBook
+    homepage at Oasis</a> you should find pointers there on all the lastest
+    versions of the DTDs and XSLT stylesheets</li>
+  <li><a href="http://www.docbook.org/">DocBook: The Definitive Guide</a> is
+    the official reference documentation for DocBook.</li>
+  <li>Ready to use  set of XML Catalogs and DocBook XML 4.1.2 Dtd for those
+    where their system doesn't provide them natively</li>
+  <li>Informations on installing a <a
+    href="http://ourworld.compuserve.com/homepages/hoenicka_markus/cygc2057.html">Windows
+    DocBook processing setup</a> based on Cygwin (using the binaries from the
+    official Windows port should be possible too) </li>
+  <li>Alexander Kirillov's page on <a
+    href="http://www.math.sunysb.edu/~kirillov/dbxml/">Using DocBook XML
+    4.1.2</a> (RPM packages)</li>
+</ul>
+
+<p>Do not use the --docbook option of xsltproc to process XML DocBook
+documents, this option is only intended to provide some (limited) support of
+the SGML version of DocBook.</p>
+
+<p>Points which are not DocBook specific but still worth mentionning
+again:</p>
+<ul>
+  <li>if you think DocBook processing time is too slow, make sure you have
+    XML Catalogs pointing to a local installation of the DTD of DocBook.
+    Check the <a href="http://xmlsoft.org/catalog.html">XML Catalog page</a>
+    to understand more on this subject.</li>
+  <li>before processing a new document, use the command
+    <p> <code>xmllint --valid --noout path_to_document</code></p>
+    <p>to make sure that your input is valid DocBook. And fixes the errors
+    before processing further. Note that XSLT processing may work correctly
+    with some forms of validity errors left, but in general it can give
+    troubles on output.</p>
+  </li>
+</ul>
+
 <h2><a name="API">The programming API</a></h2>
 
 <p>Okay this section is clearly incomplete. But integrating libxslt into your
diff --git a/doc/xsltproc2.html b/doc/xsltproc2.html
index c365cb6a..a1599b30 100644
--- a/doc/xsltproc2.html
+++ b/doc/xsltproc2.html
@@ -36,6 +36,7 @@ A:link, A:visited, A:active { text-decoration: underline }
 <li><a href="FAQ.html">FAQ</a></li>
 <li><a href="news.html">News</a></li>
 <li><a href="xsltproc2.html">The xsltproc tool</a></li>
+<li><a href="docbook.html">DocBook</a></li>
 <li><a href="API.html">The programming API</a></li>
 <li><a href="internals.html">Library internals</a></li>
 <li><a href="extensions.html">Writing extensions</a></li>
author	Daniel Veillard <veillard@src.gnome.org>	2002-01-08 12:52:22 +0000
committer	Daniel Veillard <veillard@src.gnome.org>	2002-01-08 12:52:22 +0000
commit	dc35c090b1bf089de566b54ae80a8529dc1ef82f (patch)
tree	472337f3a7f2b4f5f676307a352aeededd27c048 /doc
parent	e6fcc302a8aa4221b747e554cee00a28dc4eea68 (diff)
download	libxslt-dc35c090b1bf089de566b54ae80a8529dc1ef82f.tar.gz libxslt-dc35c090b1bf089de566b54ae80a8529dc1ef82f.tar.bz2 libxslt-dc35c090b1bf089de566b54ae80a8529dc1ef82f.zip