…optional subtitle… Jirka Kosek jirka@kosek.cz http://xmlguru.cz Jirka Kosek is a freelance XML consultant and teacher at the University of Economics in Prague. He has more than 10 years of experience in providing XML consultancy and training. Jirka is an active member in several standardization bodies, including OASIS (DocBook TC and RELAX NG TC), the W3C (XSL WG and ITS WG), and ISO/IEC JTC1/SC34 (DSDL, Topic Maps). You can get familiar with his recent work and thoughts through his blog. He's currently engaged in preparing the next XML Prague conference. freelance ACME XML DocBook authoring First paragraph of your abstract. Second paragraph … Leading text before the first section can be there… … and there

Introductory section goes here… … more text …

You can use not only paragraphs, but also programlistings: This is a really short article.

]]> DocBook offers plenty of elements for inline markup, for example code for arbitrary code, e.g. print 2+3;. You can give titles to your programlistings using example:

This is a very short article.

]]> Lists can be created using itemizedlist or orderedlist elements: DocBook V4.x is feature frozen.DocBook V4.5 is the last version of DocBook in the V4.x series. Any new DocBook development, like the addition of new elements, will be done in DocBook V5.0. It is only matter of time before useful, new elements will be added into DocBook V5.0, but they are not likely to be back ported into DocBook V4.x. DocBook V4.x will be in maintenance mode and errata will be published if necessary. DocBook V5.0 offers new functionality. DocBook V5.0 provides significant improvements over DocBook V4.x. For example there is general markup for annotations, a new and flexible system for linking, and unified markup for information sections using the info element. DocBook V5.0 is more extensible. Having DocBook V5.0 in a separate namespace allows you to easily mix DocBook markup with other XML-based languages like SVG, MathML, XHTML or even FooBarML. DocBook V5.0 is easier to customize. RELAX NG offers many powerful constructs that make customization much easier than it would be using a DTD (see ). Links to external resources are created using link element and appropritate XLink attributes. Detailed documentation about each DocBook V5.0 element is presented in the reference part of DocBook: The Definitive Guide. Table are also easy to create. Old name Recommended mapping action Use <phrase remap="action">. beginpage Remove: beginpage is advisory only and has tended to cause confusion. A processing instruction or comment should be a workable replacement if one is needed. highlights Use abstract. Note that because highlights has a broader content model, you may need to wrap contents in a para inside abstract. interface Use one of the gui* elements (guibutton, guiicon, guilabel, guimenu, guimenuitem, or guisubmenu). invpartnumber Use <biblioid class="other" otherclass="medialabel">. The productnumber element is another alternative. medialabel Use <citetitle pubwork="mediatype">, where mediatype is the type of media being labeled (e.g.,cdrom or dvd). modespec No longer needed. The current processing model for olink renders modespec unnecessary. structfield, structname Use varname. If you need to distinguish between the two, use <varname remap="structname or structfield">. In some contexts, it may also be appropriate to use property for structfield.

Because DocBook is an XML-based format and XML is a text-based format, you can use any text editor to create and edit DocBook V5.0 documents. However, using dumb editors like Notepad is not very productive. You will do better if you use an editor that supports XML. Although there are DTD and W3C XML Schemas available for DocBook V5.0, which means you can use any editor that works with DTDs or W3C XML Schemas, we recommend that you use the RELAX NG grammar with DocBook V5.0. The rest of this section contains an overview of XML editors (listed in alphabetical order) that are known to work with RELAX NG schemas and that offer guided editing based on the RELAX NG schema.

nXML mode is an add-on for the GNU Emacs text editor. By installing nXML you can turn Emacs into a very powerful XML editor that offers guided editing and validation of XML documents.

nXML uses a special configuration file named schemas.xml to associate schemas with XML documents. Often you will find this file in the directory site-lisp/nxml/schema inside the Emacs installation directory. Adding the following line into the configuration file, will associate DocBook V5.0 elements with the appropriate schema: <namespace ns="http://docbook.org/ns/docbook" uri="/path/to/docbook.rnc"/> If you can't edit the global schemas.xml file, you can create this file in the same directory as your document. nXML will find associations placed there also. In this case you must create a complete configuration file like: <locatingRules xmlns="http://thaiopensource.com/ns/locating-rules/1.0"> <namespace ns="http://docbook.org/ns/docbook" uri="/path/to/docbook.rnc"/> </locatingRules>

oXygen is a feature rich XML editor. It has built-in support for many schema languages including RELAX NG. It comes preconfigured with DocBook support.

XML Mind XML editor (XXE) is a visual validating XML editor that provides a wordprocessor-like interface to users. It is available in two versions, Standard and Professional. The Standard version is free and provides everything you need to edit DocBook V5.0 documents.

In order to use DocBook V5.0 in XXE you have to install an add-on. Go to OptionsInstall Add-ons…. Then choose DocBook 5 configuration and press the OK button. After restart, XXE is ready to work with DocBook V5.0 documents.

You can reference elements with xml:id using xref element, like .

You should finish your article with references. You can easily cite references from you article using citation element, like RNCTUT.

RNCTUT Clark, James – Cowan, John – MURATA, Makoto: . Working Draft, 26 March 2003. OASIS. NVDLTUT Nálevka, Petr: . XMLID Marsh, Jonathan – Veillard, Daniel – Walsh, Norman: . W3C Recommendation, 9 September 2005. DB5SPEC Norman, Walsh: . Working Draft 5.0a1, OASIS, 29 June 2005.