3.3 Writing your documentation

Your DocBook source files normally reside in subdirectories below thesrc/docbookfolder. Each document has its own folder that is referenced through the docbook.dir property as shown above.

In the example above, running ant all (or just ant) will build all the documentation formats for the ToolManual DocBook file.

Table 3.2. Default formats built by the DocBook Framework

pdfAdobe PDF format
htmlMultiple HTML files, one file for each section
htmlsingleOne big HTML file

Both of the HTML format directories will also contain a Zip file suitable for distribution, which contains all HTML files, images and optional CSS files.