Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Python JavaScript CSS XSLT VimL Shell Other

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
00_introduction
10_install_server
11_install_agent
12_upgrade
20_usage
21_node_management
22_configuration_management
23_administration
3_usecases
4_advanced_usage
5_references
6_handbook
bin/asciidoc
getting-started
glossary Fixes #6241: Update the documeation for the 3.0 version
graphviz
images
style/html
tools
.gitignore
LICENSE
Makefile
README.asciidoc
bibliography.txt
docinfo.xml
preface.txt
rudder-doc.conf
rudder-doc.txt
xhtml11.conf

README.asciidoc

How to build Rudder User Documentation

Dependencies

Rudder User Documentation is written using the asciidoc formatting language, and includes graphviz schemas. To build the documentation, you need following software:

Python

http://python.org to use asciidoc

Asciidoc

http://www.methods.co.nz/asciidoc/ to build HTML and PDF outputs. To keep control on the asciidoc behaviour after changes in the way asciidoc handles the themes and stylesheets, a copy of asciidoc is distributed with the documentation (issue #2173).

Docbook

http://docbook.org/ to build PDF output. Version 0.3.2-1 or superior.

Dblatex

http://dblatex.sourceforge.net/ to build PDF output.

Graphviz

http://www.graphviz.org/ to build SVG schemas.

Inkscape

http://inkcape.org to convert SVG for PDF output.

ImageMagick

http://www.imagemagick.org/ to normalize the resolution of illustrations.

Install the dependencies on Debian and Ubuntu:

apt-get install python docbook dblatex graphviz inkscape imagemagick

Install the dependencies On Fedora, Centos and RHEL

yum install docbook-utils inkscape ImageMagick

To install graphviz see: http://www.graphviz.org/Download.php

Organisation of files

XX_title

content of the documentation. The list of files to include in the final document is generated at build time from the alphabetically ordered list of text files contained in these directories.

glossary

contains glossary entries. At first occurence of a word, the glossary entry should be included in the text.

images

contains illustrations in PNG format.

graphviz

contains source files for schemas in graphviz format.

themes

contains material for visual formatting of the output.

Build

Create HTML and PDF output suitable for distribution.

make
make view

Cleanup

Delete all generated files.

make clean
Something went wrong with that request. Please try again.