haclong 7/30/2012, 6:54:00 PM Développement

DocBook is a XML schema used to create any kind of documentation. Its first purpose was to focus on technical documentation but since its format is large, with a full set of markups matching any kind of book formats, it can be used to write many different books now, including essays and novels.

DocBook claims that it can be used "out of the box", making its usage sound really easy. And it is really easy indeed. You'll have to grab several meaningful markup to write the rough skeleton of your book (one book divided in chapters. Each chapter having paragraphs etc...). If you are planning to use (and you will) the matching DocBook XSL stylesheets package, you won't have to worry about chapter numbering and table of content generation. All those nice features will be generated at the publication step. However, when it comes to a more detailed purpose, you'll need to read the documentation further, meaning altogether the DocBook Definitive Guide, the DocBook XSL Stylesheets Complete Guide and the DocBook XSL Stylesheets Reference Documentation.

The purpose of this tutorial will be to create an online API manual. We will include few nice features to customize further the rendering of our book.