HOW TO build yourself The User Guide written for AsciiDoc

NOTE: You should have installed on your system
.For standard HTML or Docbook targets

AsciiDoc 8.6.7
    http://www.methods.co.nz/asciidoc/
Source-Highlight 3.1+
    http://www.gnu.org/software/src-highlite/
or
Pygments 1.3.1+
    http://pygments.org/

.For PDF target
DocBook to LaTeX Publishing
    http://dblatex.sourceforge.net/
or
Apache FOP
    http://xmlgraphics.apache.org/fop/index.html

With AsciiDoc 8.6.7 or greater you need to install additionnal theme first :
$ wget http://growl.laurent-laville.org/asciidoc-themes/growl-1.0.zip
$ asciidoc-8.6.7/asciidoc.py --theme install growl-1.0.zip
    
With external http://growl.laurent-laville.org/ layout, and linked javascript and styles
$ asciidoc-8.6.7/asciidoc.py
  -a icons
  -a toc2
  -a linkcss
  -a theme=growl
  -n
  -v
  docs/userguide.txt

With basic layout, and embbeded javascript and styles
$ asciidoc-8.6.7/asciidoc.py
  -a icons
  -a toc
  -n
  -v
  docs/userguide.txt

Or used Phing 2.4.11

But be careful to change first properties 'asciidoc.home' and 'homedir' values 
that reflect your platform and installation.

phing  /path/to/build-phing.xml -Dasciidoc.home=? -Dhomedir=?

Since version 2.5.0 you can use alternative solution: use a properties file that define
all values you wan't to overload (example)

phing  /path/to/build-phing.xml -Ddefault.properties=/path/to/your-local.properties


Single Html file
phing  /path/to/build-phing.xml  make-userguide

Many Html files
phing  /path/to/build-phing.xml  make-userguide-chunked

Microsoft Html Help file (chm format)
phing  /path/to/build-phing.xml  make-userguide-htmlhelp

PDF file (with FOP)
Since version 2.6.0 you can generate either PDF in A4 or US format

phing  /path/to/build-phing.xml  make-userguide-pdf-a4
or
phing  /path/to/build-phing.xml  make-userguide-pdf-us