Changeset 287ea55


Ignore:
Timestamp:
05/03/2004 10:33:11 AM (20 years ago)
Author:
Matthew Burgess <matthew@…>
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_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:
673b0d8
Parents:
caa08b6
Message:
  • Merged newxml into HEAD

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@3434 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

Files:
14 added
2 deleted
3 edited
1 moved

Legend:

Unmodified
Added
Removed

  • INSTALL

    rcaa08b6 r287ea55  
    1212If all you want to do is convert XML to HTML perform the following:
    1313
    14 First, let's handle some dependencies:
    15 
    16 * Unzip
    17   - http://www.linuxfromscratch.org/blfs/view/cvs/general/unzip.html
    18 
    19 * SGML Common
    20   - http://www.linuxfromscratch.org/blfs/view/cvs/pst/sgml-common.html
    21 
    2214* libxml2
    2315  - http://www.linuxfromscratch.org/blfs/view/cvs/general/libxml2.html
    2416
    25 Now install the following:
     17* libxslt
     18  - http://www.linuxfromscratch.org/blfs/view/cvs/general/libxslt.html
    2619
    2720* DocBook DTD
    2821  - 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
    3222
    33 * OpenSP
    34   - http://www.linuxfromscratch.org/blfs/view/cvs/pst/opensp.html
    35 
    36 * OpenJade
    37   - http://www.linuxfromscratch.org/blfs/view/cvs/pst/openjade.html
    38 
    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.
     23* DocBook XSL Stylesheets
     24  - http://www.linuxfromscratch.org/blfs/view/cvs/pst/docbook-xsl.html
    4225
    4326-------------------------------------------------------------------------------
    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:
     27If you want to be able to convert the book into PDF as well, then you will need
     28the FOP package.  This takes an XSL-FO file (created with libxslt which you
     29already installed) and converts it to PDF:
    4730
    48   - http://www.easysw.com/htmldoc/
    49  
    50   Install HTMLDOC by running:
    51         ./configure --prefix=/usr
    52         make
    53         make install
     31  - http://www.apache.org/dist/xml/fop/fop-0.20.5-bin.tar.gz
    5432
    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.
     33  Install FOP by running:
    5734
    58   - http://sourceforge.net/projects/fltk
     35  cd /opt &&
     36  tar -xzvf /usr/src/fop-0.20.5-bin.tar.gz &&
     37  mv fop-0.20.5 fop
    5938
    60   Install FLTK bt running:
    61         ./configure --prefix=/usr
    62         make
    63         make install
    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.
    67 
    68   - http://www.linuxfromscratch.org/blfs/view/cvs/basicnet/lynx.html
    69 
    70 You are finished installing everything.  Read the README file for some examples
    71 how to convert this XML to the various other formats.
    72 
     39  Now set JAVA_HOME, FOP_HOME and PATH to values appropriate to your system.

  • README

    rcaa08b6 r287ea55  
    33This document is meant to instruct the user on how to convert the book's XML
    44source to other formats (e.g. HTML, PDF, PS and TXT).  First, if you have not
    5 already done so, please read the INSTALL file how to install the required
    6 software.  If you have already completed the steps outlined in the INSTALL
    7 file, then continue reading for examples how to convert these files into
     5already done so, please read the INSTALL file for instructions on how to install
     6the required software.  If you have already completed the steps outlined in the
     7INSTALL file, then continue reading for examples how to convert these files into
    88various other formats.
    99
    10 XML to HTML:
    11 ------------
    12 Create a directory in which you want to store the HTML files and cd into
    13 that directory. Now run:
     10XML to XHTML:
     11-------------
    1412
    15         mkdir -p chapter0{1,2,3,4,5,6,7,8,9} preface appendix{a,b} &&
    16         /usr/bin/openjade -t xml \
    17                 -d /usr/share/dsssl/docbook/html/lfs.dsl \
    18                 /usr/share/dsssl/docbook/dtds/decls/xml.dcl \
    19                 /path/to/index.xml
     13BASEDIR=/path/to/output/location make
    2014
    2115
     16XML to PDF:
     17-----------
    2218
    23 XML to NOCHUNKS-HTML:
    24 --------------------
    25 The NOCHUNKS HTML version is one big HTML file:
    26         /usr/bin/openjade -t sgml \
    27                 -V nochunks \
    28                 -d /usr/share/dsssl/docbook/html/lfs.dsl \
    29                 /usr/share/dsssl/docbook/dtds/decls/xml.dcl \
    30                 /path/to/index.xml > nochunks.html
    31 
    32 XML to TXT:
    33 -----------
    34 First create the NOCHUNKS HTML file, then convert by running:
    35         /usr/bin/lynx -dump nochunks.html > output.txt
    36 
    37 XML to PS and PDF:
    38 ------------------
    39 First create the NOCHUNKS HTML file, then convert by starting
    40 htmldoc. You can use the GUI and select the options. If you're
    41 satisfied with the default options you can run this command:
    42 
    43         /usr/bin/htmldoc --book --firstpage p1 -v -t <type> \
    44                 -f <output> nochunks.html
    45 
    46 replace <type> by pdf13 to create a pdf file or replace <type> by ps3 to
    47 create a ps file. There are other pdf and ps levels, see the man page for
    48 possible other options. Replace <output> with the filename of the ps or
    49 pdf file that is to be generated.
    50 
     19make pdf &&
     20cp lfs.pdf /path/to/output/location

  • index.xml

    rcaa08b6 r287ea55  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    3                         "/usr/share/docbook/docbookx.dtd" [
     2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     3  <!ENTITY % general-entities SYSTEM "general.ent">
     4  %general-entities;
     5]>
     6<book>
    47
    5 <!ENTITY version "CVS-2004-03-21">
    6 <!ENTITY releasedate "March 14th, 2004">
    7 <!ENTITY milestone "5.2">
    8 <!ENTITY nbsp " ">
    9 
    10 <!ENTITY lfs-root "http://www.linuxfromscratch.org/">
    11 <!ENTITY blfs-root "&lfs-root;blfs/">
    12 <!ENTITY faq-root "&lfs-root;faq/">
    13 <!ENTITY hints-root "&lfs-root;hints/downloads/files/">
    14 <!ENTITY hints-index "&lfs-root;hints/list.html">
    15 <!ENTITY patches-root "&lfs-root;patches/lfs/cvs/">
    16 <!ENTITY wiki-root "http://wiki.linuxfromscratch.org/">
    17 <!ENTITY http-down "http://downloads.linuxfromscratch.org/">
    18 <!ENTITY tldp-root "http://www.tldp.org/">
    19 
    20 <!ENTITY all-size-version "cvs-2003-10-06">
    21 <!ENTITY all-size-mb "134 MB">
    22 
    23 <!ENTITY buildtime "Approximate build time: ">
    24 <!ENTITY diskspace "Required disk space:    ">
     8<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="prologue/bookinfo.xml"/>
    259
    2610
    27 <!ENTITY book SYSTEM "book.xml">
    28 <!ENTITY bookinfo SYSTEM "bookinfo.xml">
     11<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="prologue/dedication.xml"/>
    2912
    30 <!ENTITY % bookstructure SYSTEM "entities/book-structure.xml">
     13<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="prologue/preface.xml"/>
    3114
    32 <!ENTITY % autoconf-entities SYSTEM "entities/autoconf.ent">
    33 <!ENTITY % automake-entities SYSTEM "entities/automake.ent">
    34 <!ENTITY % bash-entities SYSTEM "entities/bash.ent">
    35 <!ENTITY % binutils-entities SYSTEM "entities/binutils.ent">
    36 <!ENTITY % bison-entities SYSTEM "entities/bison.ent">
    37 <!ENTITY % bootscripts-entities SYSTEM "entities/bootscripts.ent">
    38 <!ENTITY % bzip2-entities SYSTEM "entities/bzip2.ent">
    39 <!ENTITY % coreutils-entities SYSTEM "entities/coreutils.ent">
    40 <!ENTITY % dejagnu-entities SYSTEM "entities/dejagnu.ent">
    41 <!ENTITY % diffutils-entities SYSTEM "entities/diffutils.ent">
    42 <!ENTITY % e2fsprogs-entities SYSTEM "entities/e2fsprogs.ent">
    43 <!ENTITY % ed-entities SYSTEM "entities/ed.ent">
    44 <!ENTITY % expect-entities SYSTEM "entities/expect.ent">
    45 <!ENTITY % file-entities SYSTEM "entities/file.ent">
    46 <!ENTITY % findutils-entities SYSTEM "entities/findutils.ent">
    47 <!ENTITY % flex-entities SYSTEM "entities/flex.ent">
    48 <!ENTITY % gawk-entities SYSTEM "entities/gawk.ent">
    49 <!ENTITY % gcc-entities SYSTEM "entities/gcc.ent">
    50 <!ENTITY % gcc-2953-entities SYSTEM "entities/gcc-2953.ent">
    51 <!ENTITY % gettext-entities SYSTEM "entities/gettext.ent">
    52 <!ENTITY % glibc-entities SYSTEM "entities/glibc.ent">
    53 <!ENTITY % grep-entities SYSTEM "entities/grep.ent">
    54 <!ENTITY % groff-entities SYSTEM "entities/groff.ent">
    55 <!ENTITY % grub-entities SYSTEM "entities/grub.ent">
    56 <!ENTITY % gzip-entities SYSTEM "entities/gzip.ent">
    57 <!ENTITY % inetutils-entities SYSTEM "entities/inetutils.ent">
    58 <!ENTITY % kbd-entities SYSTEM "entities/kbd.ent">
    59 <!ENTITY % kernel-entities SYSTEM "entities/kernel.ent">
    60 <!ENTITY % less-entities SYSTEM "entities/less.ent">
    61 <!ENTITY % lfs-utils-entities SYSTEM "entities/lfs-utils.ent">
    62 <!ENTITY % libtool-entities SYSTEM "entities/libtool.ent">
    63 <!ENTITY % m4-entities SYSTEM "entities/m4.ent">
    64 <!ENTITY % make-entities SYSTEM "entities/make.ent">
    65 <!ENTITY % makedev-entities SYSTEM "entities/makedev.ent">
    66 <!ENTITY % man-entities SYSTEM "entities/man.ent">
    67 <!ENTITY % manpages-entities SYSTEM "entities/manpages.ent">
    68 <!ENTITY % modutils-entities SYSTEM "entities/modutils.ent">
    69 <!ENTITY % ncurses-entities SYSTEM "entities/ncurses.ent">
    70 <!ENTITY % nettools-entities SYSTEM "entities/nettools.ent">
    71 <!ENTITY % patch-entities SYSTEM "entities/patch.ent">
    72 <!ENTITY % perl-entities SYSTEM "entities/perl.ent">
    73 <!ENTITY % procinfo-entities SYSTEM "entities/procinfo.ent">
    74 <!ENTITY % procps-entities SYSTEM "entities/procps.ent">
    75 <!ENTITY % psmisc-entities SYSTEM "entities/psmisc.ent">
    76 <!ENTITY % sed-entities SYSTEM "entities/sed.ent">
    77 <!ENTITY % shadow-entities SYSTEM "entities/shadow.ent">
    78 <!ENTITY % sysklogd-entities SYSTEM "entities/sysklogd.ent">
    79 <!ENTITY % sysvinit-entities SYSTEM "entities/sysvinit.ent">
    80 <!ENTITY % tar-entities SYSTEM "entities/tar.ent">
    81 <!ENTITY % tcl-entities SYSTEM "entities/tcl.ent">
    82 <!ENTITY % texinfo-entities SYSTEM "entities/texinfo.ent">
    83 <!ENTITY % utillinux-entities SYSTEM "entities/utillinux.ent">
    84 <!ENTITY % vim-entities SYSTEM "entities/vim.ent">
    85 <!ENTITY % zlib-entities SYSTEM "entities/zlib.ent">
    8615
    87 %bookstructure;
     16<part id="part1">
     17<title>Introduction</title>
     18<?dbhtml filename="part1.html"?>
     19<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="chapter01/chapter01.xml"/>
    8820
    89 %autoconf-entities;
    90 %automake-entities;
    91 %bash-entities;
    92 %binutils-entities;
    93 %bison-entities;
    94 %bootscripts-entities;
    95 %bzip2-entities;
    96 %coreutils-entities;
    97 %dejagnu-entities;
    98 %diffutils-entities;
    99 %e2fsprogs-entities;
    100 %ed-entities;
    101 %expect-entities;
    102 %file-entities;
    103 %findutils-entities;
    104 %flex-entities;
    105 %gawk-entities;
    106 %gcc-entities;
    107 %gcc-2953-entities;
    108 %gettext-entities;
    109 %glibc-entities;
    110 %grep-entities;
    111 %groff-entities;
    112 %grub-entities;
    113 %gzip-entities;
    114 %inetutils-entities;
    115 %kbd-entities;
    116 %kernel-entities;
    117 %less-entities;
    118 %lfs-utils-entities;
    119 %libtool-entities;
    120 %m4-entities;
    121 %make-entities;
    122 %makedev-entities;
    123 %man-entities;
    124 %manpages-entities;
    125 %modutils-entities;
    126 %ncurses-entities;
    127 %nettools-entities;
    128 %patch-entities;
    129 %perl-entities;
    130 %procinfo-entities;
    131 %procps-entities;
    132 %psmisc-entities;
    133 %sed-entities;
    134 %shadow-entities;
    135 %sysklogd-entities;
    136 %sysvinit-entities;
    137 %tcl-entities;
    138 %tar-entities;
    139 %texinfo-entities;
    140 %utillinux-entities;
    141 %vim-entities;
    142 %zlib-entities;
     21<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="chapter02/chapter02.xml"/>
    14322
    144 ]>
     23</part>
    14524
    146 <book>
     25<part id="part2">
     26<title>Preparing for the build</title>
     27<?dbhtml filename="part2.html"?>
     28<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="chapter03/chapter03.xml"/>
    14729
    148 &book;
     30<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="chapter04/chapter04.xml"/>
     31
     32
     33<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="chapter05/chapter05.xml"/>
     34
     35
     36</part>
     37
     38<part id="part3">
     39<title>Building the LFS system</title>
     40<?dbhtml filename="part3.html"?>
     41<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="chapter06/chapter06.xml"/>
     42
     43
     44<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="chapter07/chapter07.xml"/>
     45
     46
     47<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="chapter08/chapter08.xml"/>
     48
     49<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="chapter09/chapter09.xml"/>
     50
     51
     52</part>
     53
     54<index/>
    14955
    15056</book>
    151 

  • prologue/bookinfo.xml

    rcaa08b6 r287ea55  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
     2<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     3  <!ENTITY % general-entities SYSTEM "../general.ent">
     4  %general-entities;
     5]>
    16<bookinfo>
    27<title>Linux From Scratch</title>
    … …  
    3540notice, this list of conditions and the following disclaimer.</para></listitem>
    3641
    37 <listitem><para>Neither the name of "Linux From Scratch" nor the names of
    38 its contributors may be used to endorse or promote products derived from
    39 this material without specific prior written permission.</para></listitem>
     42<listitem><para>Neither the name of <quote>Linux From Scratch</quote> nor the
     43names of its contributors may be used to endorse or promote products derived
     44from  this material without specific prior written permission.</para></listitem>
    4045
    4146<listitem><para>Any material derived from Linux From Scratch must contain
    42 a reference to the "Linux From Scratch" project.</para></listitem>
     47a reference to the <quote>Linux From Scratch</quote> project.</para></listitem>
    4348
    4449</itemizedlist>
Note: See TracChangeset for help on using the changeset viewer.