| 7 |
- html |
- html |
| 8 |
- pdf |
- pdf |
| 9 |
- ps |
- ps |
| 10 |
|
- txt |
| 11 |
|
|
| 12 |
Note: Building pdf and ps versions of the manual for Japanese and Greek is |
Note: Building pdf and ps versions of the manual is not supported for some |
| 13 |
not supported at the moment. |
languages. Reason is that we have not yet figured out how to use the |
| 14 |
Reason is that we have not yet figured out how to use the required |
required fonts in the build process. |
|
fonts in the build process. |
|
| 15 |
|
|
| 16 |
|
|
| 17 |
1. Requirements: |
1. Requirements: |
| 18 |
================ |
================ |
| 19 |
|
|
| 20 |
The build dependencies depend on which document types you wish to generate: |
The build dependencies depend on which document types you wish to generate: |
| 21 |
all : docbook, docbook-xml, docbook-xsl, xsltproc |
all : dpkg-dev, docbook, docbook-xml, docbook-xsl, xsltproc, poxml |
| 22 |
html : (no additional packages required) |
html : (no additional packages required) |
| 23 |
pdf, ps : openjade, jadetex, docbook-dsssl |
pdf, ps : openjade, jadetex, docbook-dsssl |
| 24 |
pdf : gs-common |
pdf : gs-common |
| 25 |
|
txt : w3m |
| 26 |
|
|
| 27 |
|
For some languages additional packages are needed to build pdf: |
| 28 |
|
ko : latex-hangul-ucs-hlatex |
| 29 |
|
ru : cm-super (type1 fonts) |
| 30 |
|
|
| 31 |
Note: It's not possible to build the documentation on Woody as packages are |
Note: It's not possible to build the documentation on Woody as packages are |
| 32 |
required that are not available for Woody. |
required that are not available for Woody. |
| 49 |
clear.sh: Does the actual cleaning. |
clear.sh: Does the actual cleaning. |
| 50 |
|
|
| 51 |
In ./templates |
In ./templates |
| 52 |
------------- |
-------------- |
| 53 |
install.xml.template: Main xml file used to aggregate various parts into |
install.xml.template: Main xml file used to aggregate various parts into |
| 54 |
one big whole. This is a bit customized compared to the original |
one big whole. This is a bit customized compared to the original |
| 55 |
(changed SYSTEM entities, hardcode local path to docbook dtd -- broken |
(changed SYSTEM entities, hardcode local path to docbook dtd -- broken |
| 62 |
In ./entities |
In ./entities |
| 63 |
------------- |
------------- |
| 64 |
common.ent: Contains various entities like &num-of-distrib-packages; |
common.ent: Contains various entities like &num-of-distrib-packages; |
| 65 |
&debian; &arch-title; ... |
&debian-gnu; &arch-title; ... |
| 66 |
|
|
| 67 |
urls.ent: Contains various urls used through the manual. |
urls.ent: Contains various urls used through the manual. |
| 68 |
|
|
| 74 |
base tarballs) for various architectures. |
base tarballs) for various architectures. |
| 75 |
|
|
| 76 |
In ./stylesheets |
In ./stylesheets |
| 77 |
|
---------------- |
| 78 |
style-common.xsl: Common parameters for xsl transformation. |
style-common.xsl: Common parameters for xsl transformation. |
| 79 |
|
|
| 80 |
style-html.xsl: HTML-specific parameters for xsl transformation. |
style-html.xsl: HTML-specific parameters for xsl transformation. |
| 84 |
style-fo.xsl: FO-specific parameters for xsl transformation. |
style-fo.xsl: FO-specific parameters for xsl transformation. |
| 85 |
(currently unused) |
(currently unused) |
| 86 |
|
|
| 87 |
|
In ./arch-options |
| 88 |
|
----------------- |
| 89 |
|
A file for each architecture where architecture specific parameters |
| 90 |
|
are set. |
| 91 |
|
|
| 92 |
3. Building: |
3. Building: |
| 93 |
============ |
============ |
| 94 |
|
|
| 108 |
|
|
| 109 |
|
|
| 110 |
-- |
-- |
| 111 |
01. December 2004 Frans Pop |
05. December 2004 Frans Pop |
| 112 |
27. January 2004 Miroslav Kure |
27. January 2004 Miroslav Kure |