Prev | Current Page 1077 | Next

Christopher Negus

"Linux Bible, 2008 Edition: Boot up to Ubuntu, Fedora, KNOPPIX, Debian, openSUSE, and 11 Other Distributions"

In all cases, they publish writers??™ guides or style guides that describe the DocBook
tags that they support.
Creating DocBook Documents
You can create the documents in any text editor, using tags that are similar in appearance to HTML
tags (with beginning and end tags appearing between less-than and greater-than signs). Certain
word-processing programs also allow you to create DocBook markup.
The following steps show an example of a simple DocBook XML document produced with a plaintext
editor and output into HTML using tools that are available in many Linux systems.
The DocBook DTD is available in both SGML and XML forms. Of the two, the XML form
is actively maintained.
1. Create a directory in your home directory to work in and go to that directory. For example,
you can type the following from a Terminal window:
$ mkdir $HOME/doctest
$ cd $HOME/doctest
2. Open a text editor to hold your DocBook document. For example, you can type:
$ gedit cardoc.xml
(A text editor such as jedit, which you can get at www.jedit.org, can also be useful for
dealing with the long tag names used in DocBook.)
3. Enter the tags and text that you want to appear in your document. Most DocBook
documents are either type (large, multichapter documents) or