[Docbook] - Documentação

[M6]

Para quem não conhece, o Docbook define uma gramática em SGML/XML que permite a construção de documentos. Um pouco à semelhança do LaTex, para quem conhece, o Docbook permite que a concentração exclusiva na escrita do texto e na passagem da informação não havendo preocupação com o aspecto do documento. Neste contexto uso o termo Docbook de forma lata para referir a gramática e as aplicações que usam e suportam esta garmática.

Estando um documento pronto, existe um conjunto de validadores e transformadores que compilam o documento Docbook em documentos nos mais variados formatos finais: HTML, PDF, MAN, TXT, DVI, TEX, RTF, e alguns mais.

Estes formatos, finais para o Docbook, não são necessariamente finais para um projecto.

Por exemplo, pode ser útil distribuir a documentação de instalação e configuração em PDF, TXT e HTML num CD juntamente com o instalalável do produto. Mas um CHM ou um MAN são muito mais úteis na faze de utilização de um dado produto. O Docbook não gera CHM directamente, mas é possível fazer um CHM usando o HTML gerado pelo Docbook.

Para saberem mais:

• Introduction to DocBook, uma introdução ao Docbook pelo Norman Walsh, um dos grandes nomes por de trás do Docbook.
  
• DocBook XML/SGML Processing Using OpenJade, um tutorial útil para quem se quer iniciar em Docbook
  
• DocBook: The Definitive Guide, um excelente livro sobre Docbook.