Skip to content

VinceMacBuche/rudder-doc

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

Releases

No releases published

Packages

No packages published

Languages

  • D 64.6%
  • Python 19.2%
  • JavaScript 10.6%
  • CSS 3.1%
  • XSLT 1.0%
  • Vim Script 0.7%
  • Other 0.8%