forked from themr0c/themr0c.github.io
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
85 lines (53 loc) · 1.5 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
How to build Rudder User Documentation
======================================
== Dependencies
This Document is written using the asciidoc formatting language, and includes
graphviz schemas. To have an output suitable for common use, you need following
software:
=== asciidoc
http://www.methods.co.nz/asciidoc/
Needed to build html and pdf versions.
* On Debian and Ubuntu :
----
apt-get install asciidoc docbook
----
* For other distributions see : http://www.methods.co.nz/asciidoc/INSTALL.html
=== docbook
http://docbook.org/
Needed to build pdf version.
* On Debian and Ubuntu :
----
apt-get install docbook
----
* On Fedora, Centos and RHEL
----
yum install docbook-utils
----
=== graphviz
http://www.graphviz.org/
Needed to generate graphs.
* On Debian and Ubuntu :
----
apt-get install graphviz
----
== Organisation of files
X_title:: content of the documentation. The list of files to include in the
final document is generated at build 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.
graphs:: contains graphs generated with graphviz. Graphviz source files are stored
alongside the illustrated text.
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
----