More info available on:

2.7.0 2019-03-05 14:25 UTC

This package is auto-updated.

Last update: 2024-06-06 08:02:46 UTC


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
Source-Highlight 3.1+
Pygments 1.3.1+

.For PDF target
DocBook to LaTeX Publishing
Apache FOP

With AsciiDoc 8.6.7 or greater you need to install additionnal theme first :
$ wget
$ asciidoc-8.6.7/ --theme install
With external layout, and linked javascript and styles
$ asciidoc-8.6.7/
  -a icons
  -a toc2
  -a linkcss
  -a theme=growl

With basic layout, and embbeded javascript and styles
$ asciidoc-8.6.7/
  -a icons
  -a toc

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

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
phing  /path/to/build-phing.xml  make-userguide-pdf-us