DocBook and plain text format
DocBook is a semantics and well-structured markup language that require:
- to hand-write xml,
- or to use a specific WYSIWYG editor.
Therefore, it can be a brake to the adoption of a docbook toolchain within a team or a company... and let users writing documentation with their favorite word processor (or not!) or with additionnal tools like wikis, ...
In that case, a simple and more flexible solution may respond to the initial need by mixing :
- docbook to aggregate contents,
- plain text to write *human readable* content.
Ant4docbook allow to take advantages of the two worlds by including different plain text formats within docbook documents :