[TriLUG] DocBook for Dummies

[Kevin - The Alchemist - Sonney]

On Thu, 2002-03-14 at 11:18, M. Mueller (bhu5nji) wrote:
> 1. A DocBook source is created using a text editor and typing in both tags 
> and content. Is this the best way?

Yes, although any XML aware editor can do the job for you. Personally, I
like emacs sglm-mode, and it works. You might like vim if you're using
standard vi, since vim will do syntax highlighting of xml/sgml

> 2. How is spell checking accomplished?

In emacs, the sgml mode ignores tags, so you're on your own there.
Otherwise, it checks the data just fine. 

In vim or some other text editor, you may need to add all the tags to
the dictionary. That way, if you misspell one, it'll trigger, and if you
get it right, you don't get spurious spelling errors.

> 3. The installation of DocBook is not automated, is it?  

Define "automated." I used RPM to install all my docbook tools, and then
use "make" to build the files (admittedly, I could use ant as well, but
I've not spent the time on how that needs to be set up).  If by
"installation" you mean "copied to the proper locations" this could be
done with a Makefile task, or a shell script. 

HTH, See you tonight!

-- 
--------------------------------------------
--      Kevin "The Alchemist" Sonney      --
--  ICQ: 4855069            AIM: ksonney  --
--------------------------------------------
320C 0336 3BC4 13EC 4AEC  6AF2 525F CED7 7BB6 12C9

"I will rule you all with an Iron Fist! You! Obey the fist!" - Zim
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 232 bytes
Desc: This is a digitally signed message part
URL: <http://www.trilug.org/pipermail/trilug/attachments/20020314/8f05300f/attachment.pgp>