[libxslt.wiki] Create DocBook

[Nick Wellnhofer <nwellnhof src gnome org>]

commit eae87b15e1fd333de7df8b4cd89f4e086cc42336
Author: Nick Wellnhofer <wellnhofer aevum de>
Date:   Sat Feb 12 17:27:04 2022 +0000

    Create DocBook

 DocBook.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
---
diff --git a/DocBook.md b/DocBook.md
new file mode 100644
index 0000000..f4428a4
--- /dev/null
+++ b/DocBook.md
@@ -0,0 +1,31 @@
+[DocBook](http://www.oasis-open.org/committees/docbook/) is an XML/SGML vocabulary particularly well suited 
to books and papers about computer hardware and software.
+
+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 information which may be helpful:
+
+* The [DocBook homepage at Oasis](http://www.oasis-open.org/committees/docbook/) you should find pointers 
there on all the lastest versions of the DTDs and XSLT stylesheets
+* [DocBook: The Definitive Guide](http://www.docbook.org/) is the official reference documentation for 
DocBook.
+* [DocBook Open Repository](https://sourceforge.net/docman/index.php?group_id=21935) contains a lot of 
information about DocBook
+* Bob Stayton provides a [lot of resources](http://www.sagehill.net/) and consulting services around DocBook.
+* Here is a [shell script](http://xmlsoft.org/buildDocBookCatalog) to generate XML Catalogs for DocBook 
4.1.2 . If it can write to the /etc/xml/ directory, it will set-up /etc/xml/catalog and /etc/xml/docbook 
based on the resources found on the system. Otherwise it will just create \~/xmlcatalog and \~/dbkxmlcatalog 
and doing:
+
+  `export XMLCATALOG=$HOME/xmlcatalog`
+
+  should allow to process DocBook documentations without requiring network accesses for the DTD or 
stylesheets
+* I have uploaded [a small tarball](ftp://xmlsoft.org/libxml2/test/dbk412catalog.tar.gz) containing XML 
Catalogs for DocBook 4.1.2 which seems to work fine for me too
+* Informations on installing a [Windows DocBook processing 
setup](http://wiki.docbook.org/topic/CygwinPackages) based on Cygwin (using the binaries from the official 
Windows port should be possible too)
+* Alexander Kirillov's page on [Using DocBook XML 4.1.2](http://www.math.sunysb.edu/\~kirillov/dbxml/) (RPM 
packages)
+* Tim Waugh's [xmlto front-end conversion script](http://cyberelk.net/tim/xmlto/)
+* Linux Documentation Project 
[DocBook-Install-mini-HOWTO](http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/)
+* ScrollKeeper the open documentation cataloging project has a [DocBook 
section](http://scrollkeeper.sourceforge.net/docbook.shtml)
+* Dan York presentation on [Publishing using DocBook 
XML](http://www.lodestar2.com/people/dyork/talks/2001/xugo/docbook/index.html)
+
+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.
+
+Points which are not DocBook specific but still worth mentionning again:
+
+* 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 [XML Catalog page](http://xmlsoft.org/catalog.html) to 
understand more on this subject.
+* before processing a new document, use the command
+
+  `xmllint --valid --noout path_to_document`
+
+  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.
\ No newline at end of file