gronod/lfs
1
0
Fork 0
mirror of https://git.linuxfromscratch.org/lfs.git synced 2025-01-19 13:37:39 +00:00
Code Issues Packages Projects Releases Wiki Activity
690 Commits 88 Branches 16 Tags 24 MiB
XSLT 51.7%
Shell 31.2%
PHP 4.7%
Makefile 4.1%
Python 3.7%
Other 4.6%
d1fe567e51
Go to file
Gerard Beekmans d1fe567e51 Removed the 'over-zealous' warning how you have to read the shadow HOWTO 
before enabling it. Problems are almost unheard of these days. I left
the doc/HOWTO reference and inserted the command to enable shadow
passwords


git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@739 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
2001-06-29 17:58:29 +00:00
appendixa Renamed Shellutils to sh-utils 2001-06-21 18:02:21 +00:00
Attic cosmetic xml file change 2001-06-28 18:48:47 +00:00
book Updates 2001-04-15 00:12:18 +00:00
bookinfo </listitem></para> --> </para></listitem> 2001-06-22 20:46:29 +00:00
chapter01 Added chapter1/conventions.xml 2001-06-29 14:00:53 +00:00
chapter02 Removed the warning not to put the files inside the source directory. 2001-06-28 20:17:36 +00:00
chapter03 Shortened the mkdir man1...man8 command to: mkdir man{1,2,3,4,5,6,7,8} 2001-05-06 16:41:30 +00:00
chapter04 Upgraded to: 2001-06-29 15:35:24 +00:00
chapter05 cosmetic xml file change 2001-06-28 18:48:47 +00:00
chapter06 Removed the 'over-zealous' warning how you have to read the shadow HOWTO 2001-06-29 17:58:29 +00:00
chapter07 changed cat > blah << EOF to cat > blah << "EOF" 2001-06-29 14:36:56 +00:00
chapter08 Removed the logout command - we already exited chroot 2001-05-07 00:59:52 +00:00
chapter09 Added some warnings regarding the stripping part 2001-05-21 20:07:20 +00:00
dedication Initial XML commit 2001-02-15 15:26:52 +00:00
preface Grammar fix 2001-05-28 20:13:41 +00:00
HOWTO_EDIT Removed 'intel' from the lfs-packages file name convention 2001-06-29 16:42:25 +00:00
index.xml Upgraded to: 2001-06-29 15:35:24 +00:00
INSTALL Don't have to edit htmldoc's Makefile.in anymore 2001-06-09 18:45:52 +00:00
lfs.dsl
README Updated to use index.xml rather than intel.xml 2001-06-29 14:00:42 +00:00
WISH Removed Jesse's test line 2001-06-07 21:23:00 +00:00

README 

How do I convert these XML files to other formats like HTML, PF, PS
and TXT? You need to have some software installed that deal with these
conversions. Please read the INSTALL file how to install that software.
Then come back to this file for examples how to convert these files
into various other formats.

XML to HTML:
------------
Create a directory in which you want to store the HTML files and cd into 
that directory. Now run:
	/usr/bin/openjade -t sgml \
		-d /usr/share/dsssl/docbook/html/lfs.dsl \
		/usr/share/dsssl/docbook/dtds/decls/xml.dcl \
		/path/to/index.xml

While openjade is running you will see a lot of the following kind of
errors:

/usr/bin/openjade:/usr/share/docbook/ent/iso-lat1.ent:6:19:E: "X00E1"
is not a function name
/usr/bin/openjade:/usr/share/docbook/ent/iso-lat1.ent:7:19:E: "X00C1"
is not a function name
/usr/bin/openjade:/usr/share/docbook/ent/iso-lat1.ent:8:18:E: "X00E2"
is not a function name
/usr/bin/openjade:/usr/share/docbook/ent/iso-lat1.ent:9:18:E: "X00C2"
is not a function name
/usr/bin/openjade:/usr/share/docbook/ent/iso-lat1.ent:10:19:E: "X00E0"
is not a function name

They are normal in the sense of that it doesn't affect the output
files. A fix hasn't been found yet so we'll just have to live with it.


XML to NOCHUNKS-HTML:
--------------------
The NOCHUNKS HTML version is one big HTML file:
	/usr/bin/openjade -t sgml \
		-V nochunks \
		-d /usr/share/dsssl/docbook/html/lfs.dsl \
		/usr/share/dsssl/docbook/dtds/decls/xml.dcl \
		/path/to/index.xml > nochunks.html

XML to TXT:
-----------
First create the NOCHUNKS HTML file, then convert by running:
	/usr/bin/lynx -dump nochunks.html > output.txt

XML to PS and PDF:
------------------
First create the NOCHUNKS HTML file, then convert by starting
htmldoc. You can use the GUI and select the options. If you're
satisfied with the default options you can run this command:

	/usr/bin/htmldoc --book --firstpage p1 -v -t <type> \
		-f <output> nochunks.html

replace <type> by pdf13 to create a pdf file or replace <type> by ps3 to
create a ps file. There are other pdf and ps levels, see the man page for
possible other options. Replace <output> with the filename of the ps or
pdf file that is to be generated.