mirror of https://github.com/tLDP/LDP
111 lines
3.9 KiB
Plaintext
111 lines
3.9 KiB
Plaintext
Ok, so you have downloaded the XML source. Now what? You are probably
|
|
wanting to convert these XML files to easier to read HTML, PS, PDF, TXT
|
|
or other formatted files. All that can be read below.
|
|
|
|
Let's start by downloading some software.
|
|
|
|
If all you want to do is being able to convert XML to HTML download the
|
|
following:
|
|
|
|
OpenJade - http://openjade.sourceforge.net/
|
|
DocBook-XML DTD - http://www.docbook.org/xml/4.1.2/
|
|
Modified DocBook Entities -
|
|
http://ftp.linuxfromscratch.org/misc/docbook-4.1.2-newent.tar.bz2
|
|
DSSSL DocBook Stylesheets - http://www.nwalsh.com/docbook/dsssl/
|
|
|
|
As the DocBook DTD and Stylesheets are made available as zip archives you
|
|
may need to download the unzip package as well if your Linux system doesn't
|
|
have one:
|
|
|
|
Unzip - ftp://ftp.uu.net/pub/archiving/zip/src/
|
|
|
|
If you want to be able to convert the book into PS and PDF as well I
|
|
recommend using the Htmldoc program. This takes a html file (created
|
|
with openjade which you already downloaded) and converts it to PS or
|
|
PDF:
|
|
|
|
HTMLDOC - http://www.easysw.com/htmldoc/
|
|
FLTK (X front-end) - http://sourceforge.net/projects/fltk
|
|
|
|
If you want to be able to convert the book into TXT as well I recommend
|
|
using lynx to convert HTML to TXT using the -dump option to lynx.
|
|
|
|
Lynx - http://lynx.browser.org
|
|
|
|
|
|
You have everything you need now. Let's install this stuff.
|
|
|
|
Create the /usr/share/docbook directory, cd into it and unpack the
|
|
docbook-xml dtd archive there. Move all the files and directories from
|
|
the newly created subdirectory to the current directory
|
|
(/usr/share/docbook). We don't really need a
|
|
/usr/share/docbook/docbook-<version> subdir for our purposes.
|
|
|
|
Remove the ent directory and unpack the docbook-4.1.2-newent.tar.bz2 file.
|
|
This will create a new ent directory with entity files that work better
|
|
with XML.
|
|
|
|
Create the /usr/share/dsssl directory, cd into it and unpack the dsssl
|
|
stylesheet archive in there. Rename the directory that's created by tar
|
|
into 'docbook'. Now copy the lfs.dsl file you will find in
|
|
the LFS-BOOK XML archive into /usr/share/dsssl/docbook/html
|
|
|
|
The last step is installing OpenJade.
|
|
|
|
In order for openjade to be able to convert the DocBook based documents
|
|
into other formats, it needs to know where the DocBook DTD related
|
|
files are located. This is sort of the DocBook equivalent for the $PATH
|
|
variable. You have two ways of doing this:
|
|
|
|
1) You can set the $SGML_CATALOG_FILES variable and include the full
|
|
paths to the catalog files in it
|
|
or
|
|
2) You can hard-code the paths into the openjade binary.
|
|
|
|
If you choose option 1, add the following to your bash configuration
|
|
file, system wide profile or wherever you wish to include it:
|
|
|
|
export SGML_CATALOG_FILES=/usr/share/docbook/docbook.cat:/usr/share/dsssl/docbook/catalog:/usr/share/dsssl/openjade/catalog
|
|
|
|
Followed by installing openjade by running:
|
|
./configure --prefix=/usr
|
|
make
|
|
make install
|
|
cp -av dsssl /usr/share/dsssl/openjade
|
|
|
|
If you choose option 2, install OpenJade as follows:
|
|
./configure --prefix=/usr \
|
|
> --enable-default-catalog=/usr/share/docbook/docbook.cat:/usr/share/dsssl/docbook/catalog:/usr/share/dsssl/openjade/catalog
|
|
make
|
|
make install
|
|
cp -av dsssl /usr/share/dsssl/openjade
|
|
|
|
And you don't have to worry about the $SGML_CATALOG_FILES variable in
|
|
this case.
|
|
|
|
|
|
You're all set to convert XML to HTML (among a few other formats
|
|
supported by openjade) now. If you want to convert to PS and PDF as
|
|
well, install the following two packages.
|
|
|
|
FLTK (you can skip this one if you don't want the X front-end):
|
|
./configure --prefix=/usr
|
|
make
|
|
make install
|
|
|
|
Install HTMLDOC by running:
|
|
./configure --prefix=/usr
|
|
make
|
|
make install
|
|
|
|
|
|
The last package is Lynx which will be used for the HTML to TXT
|
|
conversion. Install it by running:
|
|
./configure --prefix=/usr
|
|
make
|
|
make install
|
|
|
|
There, all set now. Go back to the README file for some examples how to
|
|
convert this XML to the various other formats.
|
|
|