mirror of https://github.com/tLDP/LDP
updated
This commit is contained in:
gferg
parent
6b4810f5bf
commit
358b2f5dc4
|
|
@ -13,7 +13,7 @@
|
|||
<para>Describes the basics of a Boca 16-port Serial Card (Boca 2016)
|
||||
used with Linux. </para>
|
||||
</abstract>
|
||||
<pubdate>2001-??-01</pubdate>
|
||||
<pubdate>2001-17-01</pubdate>
|
||||
<revhistory>
|
||||
<revision>
|
||||
<revnumber>1.0</revnumber>
|
||||
|
|
@ -265,4 +265,3 @@
|
|||
back.</para>
|
||||
</sect1>
|
||||
</article>
|
||||
|
||||
|
|
|
|||
|
|
@ -18,8 +18,8 @@
|
|||
|
||||
<revhistory>
|
||||
<revision>
|
||||
<revnumber>v1.2</revnumber>
|
||||
<date>2001-01-03</date>
|
||||
<revnumber>v1.4</revnumber>
|
||||
<date>2001-01-18</date>
|
||||
<authorinitials>rbe</authorinitials>
|
||||
</revision>
|
||||
</revhistory>
|
||||
|
|
@ -470,7 +470,7 @@ In this section, we will locate and download the software on the Internet.
|
|||
cp -r config config-temp
|
||||
cd config-temp
|
||||
tex -ini -progname=hugelatex tex.ini
|
||||
mv latex.fmt hugelatex.fmt
|
||||
mv tex.fmt hugelatex.fmt
|
||||
mv hugelatex.fmt /usr/share/texmf/web2c
|
||||
cd ..
|
||||
rm -r config-temp
|
||||
|
|
@ -558,7 +558,7 @@ In this section, we will locate and download the software on the Internet.
|
|||
</screen>
|
||||
This Makefile uses hugelatex, so hugelatex must have been
|
||||
setup already. When tex is run as hugelatex, jadetex, or
|
||||
pdfjadetex, is gets it's program name (context) from argv[0]
|
||||
pdfjadetex, it gets its program name (context) from argv[0]
|
||||
in the environment. Then, it scans texmf.cnf, and uses
|
||||
any context-specific settings it finds. The format (.fmt)
|
||||
files in /usr/share/texmf/web2c are also loaded based on
|
||||
|
|
@ -657,7 +657,7 @@ In this section, we will locate and download the software on the Internet.
|
|||
<title>sgmltools-lite</title>
|
||||
<para>
|
||||
If you like it, you can install the sgmltools-lite, but it is optional.
|
||||
It's installation is the standard:
|
||||
Its installation is the standard:
|
||||
<screen>
|
||||
cd /usr/src
|
||||
tar -xvzf ~/sgmltools-lite-3.0.2.tar.gz
|
||||
|
|
@ -672,150 +672,67 @@ In this section, we will locate and download the software on the Internet.
|
|||
<para>
|
||||
One tweak that has to be done to make the sgmltools script work, is
|
||||
you have have to edit it and set the path to openjade:
|
||||
vi `which sgmltools`. Consult it's docs to learn more about it.
|
||||
vi `which sgmltools`. Consult its docs to learn more about it.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>htmldoc</title>
|
||||
|
||||
<sect3>
|
||||
<title>binary</title>
|
||||
<para>
|
||||
Preferrably you downloaded a binary distribution of htmldoc for
|
||||
your platform. The installation is straightforward: just unpack it
|
||||
and run the setup. Read the docs in the package for more info.
|
||||
</para>
|
||||
</sect3>
|
||||
|
||||
<sect3>
|
||||
<title>source</title>
|
||||
<para>
|
||||
If you downloaded the source, installation is autoconf style.
|
||||
If you downloaded the source, you will also need the Fast Light Tool Kit
|
||||
or else it will not link:
|
||||
</para>
|
||||
<para>
|
||||
<ulink url="http://www.fltk.org/">http://www.fltk.org/</ulink>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Installation is autoconf style.
|
||||
Just run the configure script, make, make install. If all goes
|
||||
well, it will install in /usr/bin.
|
||||
</para>
|
||||
</sect3>
|
||||
|
||||
<sect3>
|
||||
<title>lpd_print</title>
|
||||
<para>
|
||||
When generating pdf and ps files from html using htmldoc, it is
|
||||
desireable to suppress generation of the header-navigation and
|
||||
footer-navigation links that are at the top and bottom of every
|
||||
html page. These navigation features look ugly in this
|
||||
case. To suppress them, a custom dsl stylesheet file is used.
|
||||
The htmldoc program has a few glitches when generating output from
|
||||
html files from openjade. For instance, bullet items are not
|
||||
rendered properly and shaded areas are not always shaded.
|
||||
</para>
|
||||
<para>
|
||||
The stylesheet below also directs openjade to output everything as
|
||||
one chunck of data to standard out. This output is piped to htmldoc.
|
||||
To fix this problem, a perl script
|
||||
(<ulink url="http://www.linuxdoc.org/authors/tools/ldp_print.tar.gz">lpd_print</ulink>)
|
||||
is available from <ulink url="http://www.linuxdoc.org/">LinuxDoc.org</ulink>.
|
||||
The script processes a nochunks html file from openjade and then runs htmldoc on it
|
||||
to produce correctly rendered pdf and ps.
|
||||
<tip><para>Get it!</para></tip>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
<Figure>
|
||||
<title>htmldoc.dsl - custom DSSSL DocBook stylesheet</title>
|
||||
<ProgramListing>
|
||||
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
|
||||
<!ENTITY % html "IGNORE">
|
||||
<![%html;[
|
||||
<!ENTITY % print "IGNORE">
|
||||
<!ENTITY docbook.dsl SYSTEM "docbook.dsl" CDATA dsssl>
|
||||
]]>
|
||||
<!ENTITY % print "INCLUDE">
|
||||
<![%print;[
|
||||
<!ENTITY docbook.dsl SYSTEM "docbook.dsl" CDATA dsssl>
|
||||
]]>
|
||||
]>
|
||||
|
||||
<style-sheet>
|
||||
|
||||
<style-specification id="htmldoc" use="docbook">
|
||||
<style-specification-body>
|
||||
|
||||
(declare-characteristic preserve-sdata?
|
||||
;; this is necessary because right now jadetex does not understand
|
||||
;; symbolic entities, whereas things work well with numeric entities.
|
||||
"UNREGISTERED::James Clark//Characteristic::preserve-sdata?"
|
||||
#f)
|
||||
|
||||
(define %header-navigation%
|
||||
;; Should navigation links be added to the top of each page?
|
||||
#f)
|
||||
|
||||
(define %footer-navigation%
|
||||
;; Should navigation links be added to the bottom of each page?
|
||||
#f)
|
||||
|
||||
(define %generate-legalnotice-link%
|
||||
;; put the legal notice in a separate file
|
||||
#t)
|
||||
|
||||
(define %admon-graphics-path%
|
||||
;; use graphics in admonitions, set their
|
||||
"../images/")
|
||||
|
||||
(define %admon-graphics%
|
||||
#f)
|
||||
|
||||
(define %funcsynopsis-decoration%
|
||||
;; make funcsynopsis look pretty
|
||||
#t)
|
||||
|
||||
(define nochunks
|
||||
;; dont make multiple files, output all to stdout
|
||||
#t)
|
||||
|
||||
(define %root-filename%
|
||||
;; The filename of the root HTML document (e.g, "index").
|
||||
"index")
|
||||
|
||||
(define %html-ext%
|
||||
;; Default extension for HTML output files
|
||||
".htm")
|
||||
|
||||
(define %generate-article-toc%
|
||||
;; Should a Table of Contents be produced for Articles?
|
||||
;; If true, a Table of Contents will be generated for each 'Article'.
|
||||
#t)
|
||||
|
||||
(define %generate-part-toc%
|
||||
#f)
|
||||
|
||||
(define %generate-article-titlepage%
|
||||
#t)
|
||||
|
||||
(define (chunk-skip-first-element-list)
|
||||
;; forces the Table of Contents on separate page
|
||||
'())
|
||||
|
||||
(define %shade-verbatim%
|
||||
#t)
|
||||
|
||||
(define %use-id-as-filename%
|
||||
;; Use ID attributes as name for component HTML files?
|
||||
#f)
|
||||
|
||||
(define %graphic-default-extension%
|
||||
"gif")
|
||||
|
||||
(define %section-autolabel%
|
||||
;; For enumerated sections (1.1, 1.1.1, 1.2, etc.)
|
||||
#t)
|
||||
|
||||
(define (toc-depth nd)
|
||||
;; more depth, 2 levels, to toc, instead of flat hierarchy
|
||||
2)
|
||||
|
||||
</style-specification-body>
|
||||
</style-specification>
|
||||
|
||||
<external-specification id="docbook" document="docbook.dsl">
|
||||
|
||||
</style-sheet>
|
||||
</ProgramListing>
|
||||
</Figure>
|
||||
This file can be downloaded at the link below:
|
||||
</para>
|
||||
|
||||
<para>
|
||||
<ulink url="http://www.comptechnews.com/~reaster/htmldoc.dsl">http://www.comptechnews.com/~reaster/htmldoc.dsl</ulink>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Install the file to the same place where ldp.dsl is installed: in the
|
||||
html/ directory of the Modular DocBook Stylesheets, which was installed
|
||||
at /usr/local/share/sgml/dsssl/docbook in Section 3.3 above.
|
||||
<screen>
|
||||
tar -xvzf ldp_print.tar.gz
|
||||
cd ldp_print
|
||||
cp fix_print_html.lib /usr/lib/perl5/site_perl
|
||||
-- copy the lib somewhere where perl looks
|
||||
cp ldp_print /usr/local/bin
|
||||
</screen>
|
||||
Take a look at the script in case there are lines in it you need
|
||||
to change for your system. Perhaps someday htmldoc's bugs will
|
||||
be fixed and this script will not be needed anymore.
|
||||
</para>
|
||||
</sect3>
|
||||
|
||||
</sect2>
|
||||
|
||||
|
|
@ -929,7 +846,7 @@ export JADE_HOME SGML_SHARE PATH SGML_CATALOG_FILES
|
|||
<title>Using DocBook</title>
|
||||
<para>
|
||||
Now that everything is installed, it's time to test it out
|
||||
and see how to use openjade and sgmltools.
|
||||
and see how to use openjade and the other tools.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
|
|
@ -1311,14 +1228,16 @@ bash$
|
|||
<Screen>
|
||||
bash$ ls -l
|
||||
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
|
||||
bash$ openjade -t sgml -d $SGML_SHARE/dsssl/docbook/html/htmldoc.dsl test.sgml | htmldoc -f test-htmldoc.ps -
|
||||
bash$ export DSL_HTML=$SGML_SHARE/dsssl/docbook/html/ldp.dsl\#html
|
||||
bash$ openjade -t sgml -V nochunks -d $DSL_HTML test.sgml | htmldoc -f test-htmldoc.ps -
|
||||
bash$ ls -l
|
||||
-rw-r--r-- 1 reaster users 9050 Jan 1 00:44 test-htmldoc.ps
|
||||
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
|
||||
bash$
|
||||
</Screen>
|
||||
</figure>
|
||||
Notice the use of htmldoc.dsl, the customized dsssl stylesheet for this task.
|
||||
If the ps doesn't appear as expected, it is due to bugs in htmldoc.
|
||||
Look inside the ldp_print script if you want to use it to make ps.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
|
|
@ -1369,8 +1288,14 @@ total 128
|
|||
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
|
||||
-rw-r--r-- 1 reaster users 18719 Dec 31 20:51 test.tex
|
||||
bash$
|
||||
bash$ pdfjadetex test.tex
|
||||
[snip]
|
||||
bash$ pdfjadetex test.tex
|
||||
[snip]
|
||||
</screen>
|
||||
</figure>
|
||||
Pdfjadetex must be run up to three times to resolve all
|
||||
internal references for things such as TOC page numbers.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
|
|
@ -1379,16 +1304,17 @@ bash$
|
|||
<Screen>
|
||||
bash$ ls -l
|
||||
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
|
||||
bash$ openjade -t sgml -d $SGML_SHARE/dsssl/docbook/html/htmldoc.dsl test.sgml | htmldoc -f test-htmldoc.pdf -
|
||||
bash$ export DSL_HTML=$SGML_SHARE/dsssl/docbook/html/ldp.dsl\#html
|
||||
bash$ openjade -t sgml -V nochunks -d $DSL_HTML test.sgml > test-htmldoc.htm
|
||||
bash$ ldp_print test-htmldoc.htm
|
||||
bash$ ls -l
|
||||
-rw-r--r-- 1 reaster users 9050 Jan 1 01:17 test-htmldoc.pdf
|
||||
-rw-r--r-- 1 reaster users 1143 Dec 31 18:18 test.sgml
|
||||
bash$
|
||||
</Screen>
|
||||
</figure>
|
||||
This is nearly the same command as used to generated a ps file with htmldoc but
|
||||
with just a different filename. Htmldoc understands what you want based on
|
||||
the filename extension.
|
||||
If enabled in the ldp_print script, this would generate a ps file
|
||||
also.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
|
|
@ -1407,7 +1333,7 @@ bash$
|
|||
<ProgramListing>
|
||||
# Generates online and print versions of SGML source file.
|
||||
|
||||
BASENAME=DocBook-Install-mini-HOWTO
|
||||
BASENAME=DocBook-Install
|
||||
|
||||
# SGML source file.
|
||||
SGML_FILE=$(BASENAME).sgml
|
||||
|
|
@ -1415,10 +1341,10 @@ SGML_FILE=$(BASENAME).sgml
|
|||
# Stylesheets
|
||||
DSL_PRINT=$(SGML_SHARE)/dsssl/docbook/print/ldp.dsl\#print
|
||||
DSL_HTML=$(SGML_SHARE)/dsssl/docbook/html/ldp.dsl\#html
|
||||
DSL_HTMLDOC=$(SGML_SHARE)/dsssl/docbook/html/htmldoc.dsl
|
||||
|
||||
# Generated files.
|
||||
HTML_FILE=index.html
|
||||
HTM_FILE=$(BASENAME).htm
|
||||
TEX_FILE=$(BASENAME).tex
|
||||
RTF_FILE=$(BASENAME).rtf
|
||||
PDF_FILE=$(BASENAME).pdf
|
||||
|
|
@ -1430,6 +1356,8 @@ PS_FILE=$(BASENAME).ps
|
|||
|
||||
html: $(HTML_FILE)
|
||||
|
||||
htm: $(HTM_FILE)
|
||||
|
||||
tex: $(TEX_FILE)
|
||||
|
||||
rtf: $(RTF_FILE)
|
||||
|
|
@ -1440,10 +1368,10 @@ dvi: $(DVI_FILE)
|
|||
|
||||
ps: $(PS_FILE)
|
||||
|
||||
all: html tex rtf pdf dvi ps
|
||||
all: html htm tex rtf pdf dvi ps
|
||||
|
||||
clean:
|
||||
rm -f $(BASENAME).{log,aux,ps,pdf,tex,dvi,rtf,fot}
|
||||
rm -f $(BASENAME).{htm,log,aux,ps,pdf,tex,dvi,rtf,fot}
|
||||
rm -f *.html
|
||||
|
||||
distclean: clean
|
||||
|
|
@ -1458,31 +1386,49 @@ dist: clean package
|
|||
|
||||
distall: all package
|
||||
|
||||
|
||||
# Compile rules.
|
||||
|
||||
$(HTML_FILE): $(SGML_FILE)
|
||||
openjade -t sgml -d $(DSL_HTML) $(SGML_FILE)
|
||||
|
||||
$(HTM_FILE): $(SGML_FILE)
|
||||
openjade -t sgml -V nochunks -d $(DSL_HTML) \
|
||||
$(SGML_FILE) > $(HTM_FILE)
|
||||
|
||||
$(TEX_FILE): $(SGML_FILE)
|
||||
openjade -t tex -d $(DSL_PRINT) $(SGML_FILE)
|
||||
|
||||
$(RTF_FILE): $(SGML_FILE)
|
||||
openjade -t rtf -d $(DSL_PRINT) $(SGML_FILE)
|
||||
|
||||
# [pdf]jadetex is run 3 times to resolve references.
|
||||
#$(PDF_FILE): $(TEX_FILE)
|
||||
# pdfjadetex $(TEX_FILE)
|
||||
# pdfjadetex $(TEX_FILE)
|
||||
# pdfjadetex $(TEX_FILE)
|
||||
|
||||
$(PDF_FILE): $(SGML_FILE)
|
||||
openjade -t sgml -d $(DSL_HTMLDOC) $(SGML_FILE) | htmldoc -f $(PDF_FILE) -
|
||||
# This *should* work, but htmldoc has bugs ...
|
||||
#$(PDF_FILE): $(SGML_FILE)
|
||||
# openjade -t sgml -V nochunks -d $(DSL_HTML) \
|
||||
# $(SGML_FILE) | htmldoc -f $(PDF_FILE) -
|
||||
|
||||
# Have to use ldp_print to work around htmldoc bugs
|
||||
# ldp_print can also do the ps file - see script
|
||||
$(PDF_FILE): $(HTM_FILE)
|
||||
ldp_print $(HTM_FILE)
|
||||
|
||||
$(DVI_FILE): $(TEX_FILE)
|
||||
jadetex $(TEX_FILE)
|
||||
jadetex $(TEX_FILE)
|
||||
jadetex $(TEX_FILE)
|
||||
|
||||
$(PS_FILE): $(DVI_FILE)
|
||||
dvips $(DVI_FILE)
|
||||
|
||||
#$(PS_FILE): $(SGML_FILE)
|
||||
# openjade -t sgml -d $(DSL_HTMLDOC) $(SGML_FILE) | htmldoc -f $(PS_FILE) -
|
||||
# openjade -t sgml -V nochunks -d $(DSL_HTML) \
|
||||
# $(SGML_FILE) | htmldoc -f $(PS_FILE) -
|
||||
</ProgramListing>
|
||||
|
||||
</Figure>
|
||||
|
|
@ -1671,7 +1617,7 @@ DESCRIPTION
|
|||
foo does nothing useful.
|
||||
|
||||
OPTIONS
|
||||
-f bar Takes bar as it's run control file. If this were a
|
||||
-f bar Takes bar as its run control file. If this were a
|
||||
real program, there might be more to say here about
|
||||
what bar is and how it will be used.
|
||||
|
||||
|
|
@ -1797,7 +1743,7 @@ bash$ less foo.1
|
|||
</para>
|
||||
|
||||
<para>
|
||||
<ulink url="http://www.comptechnews.com/~reaster/mini-HOWTO/DocBook-Install-mini-HOWTO/">http://www.comptechnews.com/~reaster/mini-HOWTO/DocBook-Install-mini-HOWTO/</ulink>
|
||||
<ulink url="http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/">http://www.linuxdoc.org/HOWTO/mini/DocBook-Install/</ulink>
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
|
|
|
|||
|
|
@ -19,8 +19,8 @@
|
|||
|
||||
<revhistory>
|
||||
<revision>
|
||||
<revnumber>v1.5</revnumber>
|
||||
<date>2001-01-14</date>
|
||||
<revnumber>v1.6</revnumber>
|
||||
<date>2001-01-17</date>
|
||||
<authorinitials>rbe</authorinitials>
|
||||
</revision>
|
||||
</revhistory>
|
||||
|
|
@ -61,7 +61,7 @@
|
|||
</para>
|
||||
|
||||
<para>
|
||||
<ulink url="http://www.linuxdoc.org/HOWTO/mini/Nvidia-OpenGL-Configuration/">http://www.linuxdoc.org/HOWTO/mini/Nvidia-OpenGL-Configuration/</ulink>
|
||||
<ulink url="http://www.linuxdoc.org/HOWTO/mini/Nvidia-OpenGL-Configuration-mini-HOWTO/">http://www.linuxdoc.org/HOWTO/mini/Nvidia-OpenGL-Configuration-mini-HOWTO/</ulink>
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
|
|
@ -578,6 +578,19 @@
|
|||
tar -xvzf NVIDIA_kernel-0.9-5.tar.gz
|
||||
tar -xvzf NVIDIA_GLX-0.9-5.tar.gz
|
||||
cd NVIDIA_kernel-0.9-5
|
||||
</screen>
|
||||
<tip>
|
||||
<para>
|
||||
If you experience problems starting X, see the files
|
||||
TNT_USERS_README and M64_USERS_README. These files
|
||||
explain how to tweak the kernel driver. They were
|
||||
written to fix problems with TNT and TNT2 M64 cards
|
||||
but these tweaks are reported to help the GeForce2 MX
|
||||
also. Try bypassing the BIOS as explained in
|
||||
M64_USERS_README.
|
||||
</para>
|
||||
</tip>
|
||||
<screen>
|
||||
make
|
||||
cd ..
|
||||
cd NVIDIA_GLX-0.9-5
|
||||
|
|
|
|||
Loading…
Reference in New Issue