- Timestamp:
- 09/10/2003 01:13:03 AM (21 years ago)
- Branches:
- 10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.0, 6.1, 6.1.1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, v5_0, v5_1, v5_1_1, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
- Children:
- eb70a73
- Parents:
- fbb00ac
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
INSTALL
rfbb00ac re8a0469 1 Ok, so you have downloaded the XML source. Now what? You are probably 2 wanting to convert these XML files to easier to read HTML, PS, PDF, TXT 3 or other formatted files. All that can be read below. 1 LFS Book Conversion Tools Installation Instructions 4 2 5 Let's start by downloading some software. 3 After downloading the CVS source, there are some things that need to be setup 4 on your computer if you want to convert the XML source into something easier to 5 read (e.g. HTML, TXT, PS or PDF). If you are interested in this, then keep 6 reading. If you are only interested in editing the XML source for re- 7 submission to the lfs-book or lfs-dev mailing lists, then you do not need this 8 document. Instead, you need to read the LFS Editor's Manual. See the LFS 9 website at http://linuxfromscratch.org for more information. 6 10 7 If all you want to do is being able to convert XML to HTML download the 8 following:11 ------------------------------------------------------------------------------- 12 If all you want to do is convert XML to HTML perform the following: 9 13 10 OpenJade - http://openjade.sourceforge.net/ 11 DocBook-XML DTD - http://www.docbook.org/xml/4.1.2/ 12 Modified DocBook Entities - 13 http://linuxfromscratch.org/~gerard/docbook-4.1.2-newent.tar.bz2 14 DSSSL DocBook Stylesheets - http://www.nwalsh.com/docbook/dsssl/ 14 First, let's handle some dependancies: 15 15 16 As the DocBook DTD and Stylesheets are made available as zip archives you 17 may need to download the unzip package as well if your Linux system doesn't 18 have one: 16 * Unzip 17 - http://www.linuxfromscratch.org/blfs/view/cvs/general/unzip.html 19 18 20 Unzip - ftp://ftp.uu.net/pub/archiving/zip/src/ 19 * SGML Common 20 - http://www.linuxfromscratch.org/blfs/view/cvs/pst/sgml-common.html 21 21 22 If you want to be able to convert the book into PS and PDF as well I 23 recommend using the Htmldoc program. This takes a html file (created 24 with openjade which you already downloaded) and converts it to PS or 25 PDF: 22 * libxml2 23 - http://www.linuxfromscratch.org/blfs/view/cvs/general/libxml2.html 26 24 27 HTMLDOC - http://www.easysw.com/htmldoc/ 28 FLTK (X front-end) - http://sourceforge.net/projects/fltk 25 Now install the following: 29 26 30 If you want to be able to convert the book into TXT as well I recommend 31 using lynx to convert HTML to TXT using the -dump option to lynx. 27 * DocBook DTD 28 - http://www.linuxfromscratch.org/blfs/view/cvs/pst/DocBook.html 29 30 * DSSSL DocBook Stylesheets 31 - http://www.linuxfromscratch.org/blfs/view/cvs/pst/docbook-dsssl.html 32 32 33 Lynx - http://lynx.browser.org 33 * OpenSP 34 - http://www.linuxfromscratch.org/blfs/view/cvs/pst/opensp.html 34 35 36 * OpenJade 37 - http://www.linuxfromscratch.org/blfs/view/cvs/pst/openjade.html 35 38 36 You have everything you need now. Let's install this stuff. 39 Once you have followed the installation instructions for all these packages 40 from the BLFS Book, then you have a basic DocBook setup. Below are some 41 alternate packages that you can use to convert to other formats. 37 42 38 Create the /usr/share/docbook directory, cd into it and unpack the 39 docbook-xml dtd archive there. Move all the files and directories from 40 the newly created subdirectory to the current directory 41 (/usr/share/docbook). We don't really need a 42 /usr/share/docbook/docbook-<version> subdir for our purposes. 43 ------------------------------------------------------------------------------- 44 If you want to be able to convert the book into PS and PDF as well, then you 45 will need the Htmldoc package. This takes a HTML file (created with openjade 46 which you already installed) and converts it to PS or PDF: 43 47 44 Remove the ent directory and unpack the docbook-4.1.2-newent.tar.bz2 file. 45 This will create a new ent directory with entity files that work better 46 with XML. 47 48 Create the /usr/share/dsssl directory, cd into it and unpack the dsssl 49 stylesheet archive in there. Rename the directory that's created by tar 50 into 'docbook'. Now copy the lfs.dsl file you will find in 51 the LFS-BOOK XML archive into /usr/share/dsssl/docbook/html 52 53 The last step is installing OpenJade. 54 55 In order for openjade to be able to convert the DocBook based documents 56 into other formats, it needs to know where the DocBook DTD related 57 files are located. This is sort of the DocBook equivalent for the $PATH 58 variable. You have two ways of doing this: 59 60 1) You can set the $SGML_CATALOG_FILES variable and include the full 61 paths to the catalog files in it 62 or 63 2) You can hard-code the paths into the openjade binary. 64 65 If you choose option 1, add the following to your bash configuration 66 file, system wide profile or wherever you wish to include it: 67 68 export SGML_CATALOG_FILES=/usr/share/docbook/docbook.cat:/usr/share/dsssl/docbook/catalog:/usr/share/dsssl/openjade/catalog 69 70 Followed by installing openjade by running: 71 ./configure --prefix=/usr 72 make 73 make install 74 cp -av dsssl /usr/share/dsssl/openjade 75 76 If you choose option 2, install OpenJade as follows: 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 83 And you don't have to worry about the $SGML_CATALOG_FILES variable in 84 this case. 85 86 87 You're all set to convert XML to HTML (among a few other formats 88 supported by openjade) now. If you want to convert to PS and PDF as 89 well, install the following two packages. 90 91 FLTK (you can skip this one if you don't want the X front-end): 48 - http://www.easysw.com/htmldoc/ 49 50 Install HTMLDOC by running: 92 51 ./configure --prefix=/usr 93 52 make 94 53 make install 95 54 96 Install HTMLDOC by running: 55 An excellent X front-end for HTMLDOC is FLTK. If you will be doing rendering 56 in X, then you will probably want this package. 57 58 - http://sourceforge.net/projects/fltk 59 60 Install FLTK bt running: 97 61 ./configure --prefix=/usr 98 62 make 99 63 make install 100 64 65 If you want to be able to convert the book into TXT as well, then you need the 66 lynx browser. Conversion is handled via the -dump option. 101 67 102 The last package is Lynx which will be used for the HTML to TXT 103 conversion. Install it by running: 104 ./configure --prefix=/usr 105 make 106 make install 68 - http://www.linuxfromscratch.org/blfs/view/cvs/basicnet/lynx.html 107 69 108 There, all set now. Go back to the README file for some examples how to 109 convert this XML to the various other formats.70 You are finished installing everything. Read the README file for some examples 71 how to convert this XML to the various other formats. 110 72
Note:
See TracChangeset
for help on using the changeset viewer.
