|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 29-Dec-2021 | - |
| cs/ | H | 29-Dec-2021 | - | 15,045 | 13,179 |
| de/ | H | 29-Dec-2021 | - | 16,348 | 14,689 |
| en/ | H | 29-Dec-2021 | - | 14,834 | 13,043 |
| es/ | H | 29-Dec-2021 | - | 8,477 | 7,517 |
| fr/ | H | 29-Dec-2021 | - | 15,616 | 13,902 |
| hu/ | H | 29-Dec-2021 | - | 14,757 | 12,966 |
| it/ | H | 29-Dec-2021 | - | 15,335 | 13,439 |
| pl/ | H | 29-Dec-2021 | - | 15,350 | 13,517 |
| ru/ | H | 29-Dec-2021 | - | 15,340 | 13,474 |
| xsl/ | H | 29-Dec-2021 | - | 304 | 119 |
| zh_CN/ | H | 29-Dec-2021 | - | 14,770 | 12,936 |
| README | H A D | 07-Nov-2011 | 2.2 KiB | 64 | 43 |
| default.css | H A D | 12-Apr-2010 | 1.2 KiB | 84 | 69 |
| html-common.xsl | H A D | 13-May-2009 | 2.8 KiB | 96 | 60 |
| ldp.dsl | H A D | 12-Apr-2010 | 10.4 KiB | 365 | 298 |
README
1Tools required for building the documentation
2~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3
4* GNU make 3.80 or later
5* DocBook 4.1.2 or later
6* The DocBook XML DTD (also known as DocBk XML)
7* DocBook XSL stylesheets -- version 1.50.0 or later is recommended.
8
9I am not quite sure which tools work, but I used the following
10ones successfully, so they are required:
11
12* xmllint (part of libxml2) is used for validation.
13* xsltproc (part of libxslt1) is used for transforming XML files into HTML
14 files. Version 1.0.18 or later is recommended.
15
16On Red Hat systems you need the following packages:
17libxml2, libxslt, docbook-dtds, docbook-style-xsl
18
19On Debian you will need these packages:
20docbook-xml, docbook-xsl, xsltproc, libxml2-utils
21
22
23Building the documentation
24~~~~~~~~~~~~~~~~~~~~~~~~~~
25
26The documentation and its translations reside in subdirectories.
27When building the documentation, the generated HTML files are
28placed in subdirectories of the 'HTML' directory.
29
30IMPORTANT: Do NOT place sensitive files under 'HTML'!
31 It is for generated documentation only.
32 The whole directory tree is wiped out by the Makefile
33 when running 'make distclean' or 'make clean'.
34
35
36A few words about SGML catalog files
37~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
38
39As far as I know, the document type declaration in XML files requires
40both a public and a system identifier. For example:
41
42<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
43 "/usr/share/sgml/docbook/dtd/xml/4.1.2/docbookx.dtd">
44
45where
46
47 "-//OASIS//DTD DocBook XML V4.1.2//EN"
48
49is the public, and
50
51 "/usr/share/sgml/docbook/dtd/xml/4.1.2/docbookx.dtd"
52
53is the system identifier.
54
55The problem is that the system identifier is most probably system-dependent.
56To avoid the need to manually fix the system identifiers before building the
57documentation, I've decided to use SGML catalogs. If you have your catalogs
58set up correctly, xmllint and xsltproc will use them to find the DTDs
59based on the public identifiers.
60
61Note that this works only if public identifiers override system identifiers
62(i.e. the catalog file must contain 'OVERRIDE YES'). (I had no problem with
63these on my system, since the Debian people took care of everything. ;-))
64