Introduction to DocBook Liam Quin Barefoot Computing, Toronto liam@holoweb.net SGML Background Declarative Markup: Say What and not How When you can't say What, say Why DocBook Background SGML and XML Converting documents to XML Getting Started: Tools Resources History: US Government and Typesetters Split: the easy part and the hard part Syntax (SGML) Semantics(DSSSL, part of the hard part) Not WYSIWYG (What You See Is What You Get) WYSIWYG is WYSIAYG (What You See Is All You Get) Use SGML to identify parts of a document Use external style sheets to say what it looks like Different style sheets can produce different results even on the same SGML input Elements show Meaning Behaviour is external figs/oxfordjohn-xmetal-icons.png Elements show Meaning Behaviour is external figs/semantic-linking.gif Press the <tt>return</tt> key Press the <tt class="keycap">return</tt> Press the <place>return</place> It's an SGML vocabulary, with usage guidelines Started by HaL and O'Reilly for technical documentation and technical books Developed by Davenport Group, now by OASIS Open (www.oasis-open.org) Primarily used for technical documentation and books Hundreds of thousands of pages: widespread use docbooktree.gif DocBook 4.1 includes XML support XML is the 30% of SGML that 99% of people used omittag: SGML DTD can permit tage to be omitted shorttag: SGML attributes without quotes, </> XML processing instructions use <?target data ...?> <!DOCTYPE Article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> -//GNOME//DTD DocBook PNG Variant V1.1//EN For XML, you must follow this with a URL for the DTD "-//OASIS//DTD DocBook V3.1//EN" "docbookx.dtd"> If you used lowercase element names, no OMITTAG and no SHORTTAG, and no conditional sections, your document is probably already XML. http://www.holoweb.net/~liam/xml/docbook/ ftp://sourceware.cygnus.com/pub/docbook-tools/docware/ ftp://unix.hensa.ac.uk/mirrors/sourceware.cygnus.com/... Use an SGML or XML-aware editor Use nsgmls -s yourfile.sgml xemacs with psgml can validate, if set up right Future: XML Schema XML Spy emacs with psgml vim with syntax highlighting SoftQuad XMetaL Exosoft, ArborText (much more expensive) Document Style and Semantics Specification Language, DSSSL jade, openjade (both SGML and XML) XML Style Language (Transformation), XSLT, for XML only libxml, libxslt xt (needs Java; www.jclark.com) saxon, xalan, others db2ps (may need run it at least twice) db2pdf (uses DSSL and TeX) db2html FOP (uses XSL/FO, www.apache.org) Commercial (e.g. Panorama) Internet Explorer with XSL or CSS Mozilla with CSS Translation Automake screenshots special characters &#38;, &eacute; UTF-8 (XML) or Latin 1 (XML or SGML) liam@holoweb.net http://www.holoweb.net/~liam/xml/docbook