source: INSTALL@ 7dfd988

10.0 10.1 11.0 6.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk v1_0 v5_0 v5_0-pre1 v5_1 v5_1-pre1 xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 7dfd988 was f45b1953, checked in by Mark Hymers <markh@…>, 19 years ago

Initial revision

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 3.9 KB
Line 
1Ok, so you have downloaded the XML source. Now what? You are probably
2wanting to convert these XML files to easier to read HTML, PS, PDF, TXT
3or other formatted files. All that can be read below.
4
5Let's start by downloading some software.
6
7If all you want to do is being able to convert XML to HTML download the
8following:
9
10OpenJade - http://openjade.sourceforge.net/
11DocBook-XML DTD - http://www.docbook.org/xml/4.1.2/
12Modified DocBook Entities -
13 http://ftp.linuxfromscratch.org/misc/docbook-4.1.2-newent.tar.bz2
14DSSSL DocBook Stylesheets - http://www.nwalsh.com/docbook/dsssl/
15
16As the DocBook DTD and Stylesheets are made available as a zip achives you
17may need to download the unzip package as well if your Linux system doesn't
18have one:
19
20Unzip - ftp://ftp.uu.net/pub/archiving/zip/src/
21
22If you want to be able to convert the book into PS and PDF as well I
23recommend using the Htmldoc program. This takes a html file (created
24with openjade which you already downloaded) and converts it to PS or
25PDF:
26
27HTMLDOC - http://www.easysw.com/htmldoc/
28FLTK (X front-end) - http://sourceforge.net/projects/fltk
29
30If you want to be able to convert the book into TXT as well I recommend
31using lynx to convert HTML to TXT using the -dump option to lynx.
32
33Lynx - http://lynx.browser.org
34
35You have everything you need now. Let's install this stuff.
36
37Create the /usr/share/docbook directory, cd into it and unpack the
38docbook-xml dtd archive there. Move all the files and directories from
39the newly created subdirectory to the current directory
40(/usr/share/docbook). We don't really need a
41/usr/share/docbook/docbook-<version> subdir for our purposes.
42
43Remove the ent directory and unpack the docbook-4.1.2-newent.tar.bz2 file.
44This will create a new ent directory with entity files that work better
45with XML.
46
47Create the /usr/share/dsssl directory, cd into it and unpack the dsssl
48stylesheet archive in there. Rename the directory that's created by tar
49into 'docbook'. Now create a symlink to the blfs.dsl file you will find
50in the BLFS-BOOK XML archive in /usr/share/dsssl/docbook/html
51
52The last step is installing OpenJade.
53
54In order for openjade to be able to convert the DocBook based documents
55into other formats, it needs to know where the DocBook DTD related
56files are located. This is sort of the DocBook equivalent for the $PATH
57variable. You have two ways of doing this:
58
591) You can set the $SGML_CATALOG_FILES variable and include the full
60paths to the catalog files in it
61 or
622) You can hard-code the paths into the openjade binary.
63
64If you choose option 1, add the following to your bash configuration
65file, system wide profile or wherever you wish to include it:
66
67export SGML_CATALOG_FILES=/usr/share/docbook/docbook.cat:/usr/share/dsssl/docbook/catalog:/usr/share/dsssl/openjade/catalog
68
69Followed by installing openjade by running:
70 ./configure --prefix=/usr
71 make
72 make install
73 cp -av dsssl /usr/share/dsssl/openjade
74
75If you choose option 2, install OpenJade as follows:
76
77 ./configure --prefix=/usr \
78 --enable-default-catalog=/usr/share/docbook/docbook.cat:/usr/share/dsssl/docbook/catalog:/usr/share/dsssl/openjade/catalog
79 make
80 make install
81 cp -av dsssl /usr/share/dsssl/openjade
82
83And you don't have to worry about the $SGML_CATALOG_FILES variable in
84this case.
85
86
87You're all set to convert XML to HTML (among a few other formats
88supported by openjade) now. If you want to convert to PS and PDF as
89well, install the following two packages.
90
91FLTK (you can skip this one if you don't want the X front-end):
92 ./configure --prefix=/usr
93 make
94 make install
95
96HTMLDOC:
97Install by running:
98
99 ./configure --prefix=/usr
100 make
101 make install
102
103
104
105The last package is Lynx which will be used for the HTML to TXT
106conversion. Install it by running:
107
108 ./configure --prefix=/usr
109 make
110 make install
111
112There, all set now. Go back to the README file for some examples how to
113convert this XML to the various other formats.
114
Note: See TracBrowser for help on using the repository browser.