Writing DocBook documents: Introduction (From HTML to DocBook)
Hi all,
I've been doing some research around DocBook at work these days, so I've decided to write some useful tips around its usage (from the point of view of an average HTML coder), since I had some hard time trying to understand it at first. After some headaches and a little of patience, I achieved some knowledges on writing very cool DocBook documents that fits nice on both HTML and PDF outputs (among others).
From HTML to DocBook
My job was to translate a documentation written in HTML to DocBook. First thing I've learned: If you know XML, you'll get DocBook easily! DocBook can be written in both SGML or XML. I used XML, because it's very easy and provides me almost the same easiness that HTML does. Basically, dealing with XML Docbook is like dealing with a very rigid and strict HTML code. There are some HTML tags that could be directly converted to DocBook ones, but there are others that you need to choose individually according to what you want it to be.
Next post I'll demonstrate the DocBook types of document (article, book or a set) and show examples of these. C'ya!
Next post I'll demonstrate the DocBook types of document (article, book or a set) and show examples of these. C'ya!