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 :