why docbook is needed?
The DocBook format was designed by OASIS consortium specifically for technical documentation. It provides a rich set of tags to describe the content of your document.
Here is a number of key points that help understand what DocBook is:
- DocBook is a markup language
It is very similar to HTML in this respect. The tags give some structure to your document, and appear intermixed with the informational text.
This peculiar point makes it a revolution with respect to documentation translation, because the DTP phase (making the text look nice) is done once for all indirectly by tagging the original text. The translators only have to translate "in between the tags" and by pressing a single keystroke the translated output is generated.
- It is made for technical documentation
DocBook is perfectly suited for car engine parts documentation. However, it is strongly biased towards computer programs documentation.
- Technically, DocBook is a SGML or XML DTD
This means that one can take profit of the many SGML and XML aware tools. While DocBook as an XML implementation is quite recent, it has a long history as a SGML implementation.
- DocBook is not a presentation language
DocBook carefully cares about not specifying how the final documentation looks like. This allows the writer to concentrate on the organization and meaning of the document he or she writes. All the presentation issues are devolved to style sheets.
This ensures all your documents have a consistent appearance, whoever should be the technical writer.
- DocBook is customizable
It is quite easy to customize the DTD to meet one's need thanks to its modular organization. But one must be aware that this must be done with respect to SGML/XML conventions and that it might introduce incompatibilities.
If DocBook is used in conjunction with Norman Walsh's modular style sheets, it is also possible to customize the way a DocBook file can be printed or put online too.
- DocBook is comprehensive
The large number of tags defined in DocBook guarantees that it can accommodate a wide range of situations and of processing expectations.
This in turn makes it a bit difficult to learn, but one can manage writing documentation knowing only a limited set of tags and referring to the reference documentation when needed.