source: INSTALL@ 6da4d5a6

10.0 10.1 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 krejzi/svn nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 6da4d5a6 was 6da4d5a6, checked in by Bruce Dubbs <bdubbs@…>, 17 years ago

Set auto date in general.ent

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

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