DocBook

Mind the fact that this really is a multistep transformation: from DocBook to the text-markup language to plain text.

Save the CSS shown in Listing 8 into a file named style. css in the lib directory of your DocBook XML project.

Many of the tags available in DocBook make it a natural choice for building technical documentation.

Because this table has different element names and a slightly different organization, I cannot simply reuse the DocBook table template.

So, the docbook-doc package might have an "Enhances" field with docbook-xml as one of the packages enhanced.

Indeed it's easy to prepare documents in DocBook or another XML vocabulary and convert them automatically to HTML.

It is designed to work with the sort of tables used in DocBook (which are based on a model of tables popular in SGML).

DocBook is a popular vocabulary for book publishing - read through it and you ll see that books can be very complex systems indeed.

In this case, turning out XI output in Docbook would be the responsibility of a style sheet similar to that in Listing 4.

DocBook XML is a library of standard XML tags with which you can write stylesheets for generating almost any output.

Docbook was originally a popular SGML format for authoring books and documentation, especially of a more technical nature.

Is the smallest root element used for a DocBook document.

However, using an established format like DocBook XML allows you to use stylesheets other people have already written.

The elements and structure outlined here are enough to get you started with creating your own DocBook documents.

I was able to reuse the DocBook code just as I intended.

Because of its maturity, many tools are available for you to edit and build documentation in DocBook XML.

Last but not least, the combination of text-markup language and XSLT works with DocBook and any other XML vocabulary.

To begin, fire up your favorite text editor and create a new document. The first line of a DocBook document is the document declaration.

Wiki markup, for instance, can be a huge time saver in comparison to writing straight into DocBook XML.

Hundreds of existing XML tools work with DocBook -- obviously, more tools on the market means less work for you.

The readers of the technical stuff I wrote using DocBook never realized that I used XML for the task.

The DTD is indicated in the system identifier by a URL, which is where all the DocBook definitions are located.

For PDF, PostScript, or RTF output, convert the FO version of the DocBook document into an output file in the specified format.

DocBook is a famous and widely used example; IBM's developerWorks internal article format is another example (I used both for testing).

Fortunately, most editors ship with native support for DocBook -- another reason to adopt this popular vocabulary.

This makes the documentation hard to build on a Windows system without some experience with DocBook in that environment.

In Select DTD File, navigate to the docbookx. dtd file in the docbook-xml folder of your project, then click Next.

By applying various style sheets, you can then make the transition to, say, XHTML or DocBook.

For example, in a real project I would write the template for converting XHTML tables to DocBook as a variation of the identity transform.

In this case, I added a reference to an XSL document that contains some rules for transforming the DocBook document.

Otherwise, the scripts leave you with a merged DocBook file.

Another difference stems from something I dislike about the DocBook pattern -- the element name "firstname. "

Now that you've created a new project in Eclipse, import the files that you'll be using to build the DocBook XML.

The Ant task, fop, transforms FO files, which are built with the FO stylesheets that come with DocBook XSL.

DocBook is a DTD that OASIS promotes as a standard for document writing.

DocBook is a standard vocabulary for technical documentation.

The Simplified DocBook version tries to reduce the tag load without straying too far in the basic framework.

OASIS promotes DocBook, a DTD, as a standard for document writing.

In the first pass, the XHTML table is converted to DocBook form within the variable db-table.

DocBook: Download DocBook to generate content in different formats.

DocBook is a good example of this, and you can see how DocBook models names in the author element, illustrated in Listing 1.

DocBook is a popular XML vocabulary for technical documentation.

If you have the DocBook toolset, the ANT file here allows you to do this as one step, and the temporary merged file will be removed.

Achim, our development lead, suggested that we use docbook instead of rolling our own XML syntax.

Listing 7 is an HC application handler that formats a small subset of Docbook in HTML.

The class defines methods for selected Docbook elements.

Making the user documentation, using DocBook.

Technology bookstore: Browse for books on XML, DocBook, and other technical topics.

For one thing, DocBook allows the role attribute on just about every element, while Listing 2 restricts it to othername.

If you adopt a popular vocabulary, such as DocBook, you can find pre-existing stylesheets that should speed up the process.

You will replace these files with the HTML files generated in the DocBook project.

Note: This code in this article was developed using DocBook XML V4. 5; V5. 0 was in release candidate status at the time of writing.

DocBook is a rather complex DTD with hundreds of elements.

The style sheet to convert from DocBook to the text-markup language is text. xsl in the Listing 2.

It also looks at some DocBook tags in greater detail and discusses how to compose a basic DocBook document.

Listing 3 provides an example of building a DocBook XML document that includes other DocBook XML files dynamically.

Listing 4 (xhtml-onecol. xslt) is a transform that uses the DocBook table module to operate on XHTML tables.

You might add structure to conform to a particular XML vocabulary, such as DocBook.

You can even include books in a set element, which is the highest-level DocBook element.

The popular DocBook has impressive support in tools, many of which are quite mature.

You can physically partition DocBook XML files in any way that makes sense, such as putting sections in files by themselves.

The e-zine will be written in XML and, more specifically, in DocBook.

Docbook is very popular and has impressive support in tools, many of which are quite mature.

Many programs present context-sensitive prompts for available tags or lists of tags that exist in the current DTD (for example, DocBook's).

Alternatively, you can use an industry-standard structure (for example, MIL-SPEC, DITA, DocBook).

You don't have any DocBook XML files, so the target won't do anything useful.

For example, DTDs and schemata such as DocBook offer section elements with explicit and derived hierarchy within the context of a document.

To generate the PDF version of a DocBook document, simply execute the script with the name of that document, as in the following example

As a quick example of section context, let me present a highly stripped down, but DCMI-annotated version of my DocBook chapter

With your reference in hand, you can create DocBook content in one of two ways

Using XSLT to convert DocBook in an intermediate text markup language