DocBook This tutorial explains how to write DocBook files in Eclipse and how to convert these files into various output formats, e.g., to HTML and PDF. It also explains how to configure XInclude to divide the information into different source files. This tutorial uses Docbook 4.5, the Saxon XLST processor in version 6.5.5, Eclipse 4.3 and the XLST stylesheets in version 1.77.1.
1.1. Docbook and maven
I was looking for a maven plugin that produces documentation with syntax highlighting from docbook .
1.2. For the impatient
This article has been written in docbook , and generated via maven with the docbkx maven plugin .
You can check it out
*
as multi pages html
*
as a single html page
*
in PDF
You can download a ready-to-build maven project here http://www.springfuse.com/blog/docbook/docbook-1.0.0-src.zip . It is ready to be customized for your needs.