source: clfs-embedded/BOOK/INSTALL.md@ e24b7ec

Last change on this file since e24b7ec was 1a15276, checked in by Andrew Bradford <andrew@…>, 7 years ago

BOOK: s/BASEDIR/RENDERDIR/

As pointed out by akhiezer <lfs65@…>, the BASEDIR variable
doesn't actually exist and the way it is used in the
documentation/comments means it is actually referring to the RENDERDIR
variable.

  • Property mode set to 100644
File size: 1.0 KB
Line 
1CLFS Book Conversion Tools
2==========================
3
4After downloading the book source, there are some things that need to be set up
5on your computer if you want to convert the XML source into something easier to
6read (e.g. HTML, TXT, or PDF).
7
8If you want to convert the Docbook XML to HTML, install the following:
9
10* libxml2
11* libxslt
12* DocBook DTD
13* DocBook XSL Stylesheets
14* HTMLTidy
15
16If you want to convert the Docbook XML to TXT, install the above items, and then
17install the following:
18
19* lynx
20
21If you want to convert the Docbook XML to PDF, install the items listed above
22(except lynx) and then install the following:
23
24* JDK
25* FOP and JAI
26
27On a reasonably recent Debian or Ubuntu, this should suffice:
28
29```
30sudo apt install docbook-xml docbook-xsl fop libxml2-utils lynx make xsltproc tidy
31```
32
33To actually convert the Docbook XML source into rendered form, which will be
34located at ../render by default (override with RENDERDIR=), execute:
35
36* To XHTML: `make`
37* To single file XHTML (nochunks): `make nochunks`
38* To PDF: `make pdf`
Note: See TracBrowser for help on using the repository browser.