diff --git a/en/handbook/Makefile b/en/handbook/Makefile index 5543778f82..f856ba2cd7 100644 --- a/en/handbook/Makefile +++ b/en/handbook/Makefile @@ -1,5 +1,5 @@ # -# $Id: Makefile,v 1.6 1998-12-10 20:42:26 nik Exp $ +# $Id: Makefile,v 1.7 1998-12-20 20:33:49 nik Exp $ # # Build the FreeBSD Handbook. Will eventually split in two, a generic .mk # file which can be used by many Makefiles, and a much smaller Makefile @@ -140,23 +140,21 @@ CLEANFILES+= ${DOC}.${_curformat} all: ${_docs} index.html: ${SRCS} - ${JADE} -ihtml ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml - ./conv.pl *.html + ${JADE} -ioutput.html ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml tidy -i -m -f /dev/null *.html ${DOC}.html: ${SRCS} - ${JADE} -ihtml -V nochunks ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml > ${DOC}.html - ./conv.pl ${DOC}.html + ${JADE} -ioutput.html -V nochunks ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml > ${DOC}.html tidy -i -m -f /dev/null ${DOC}.html ${DOC}.txt: ${DOC}.html lynx -nolist -dump ${DOC}.html > ${DOC}.txt ${DOC}.rtf: ${SRCS} - ${JADE} -iprint ${JADEFLAGS} -d ${DSLPRINT} -t rtf ${DOC}.sgml + ${JADE} -ioutput.print ${JADEFLAGS} -d ${DSLPRINT} -t rtf ${DOC}.sgml ${DOC}.tex: ${SRCS} - ${JADE} -iprint ${JADEFLAGS} -d ${DSLPRINT} -t tex ${DOC}.sgml + ${JADE} -ioutput.print ${JADEFLAGS} -d ${DSLPRINT} -t tex ${DOC}.sgml ${DOC}.dvi: ${DOC}.tex @echo "==> TeX pass 1/3" diff --git a/en_US.ISO8859-1/books/handbook/Makefile b/en_US.ISO8859-1/books/handbook/Makefile index 5543778f82..f856ba2cd7 100644 --- a/en_US.ISO8859-1/books/handbook/Makefile +++ b/en_US.ISO8859-1/books/handbook/Makefile @@ -1,5 +1,5 @@ # -# $Id: Makefile,v 1.6 1998-12-10 20:42:26 nik Exp $ +# $Id: Makefile,v 1.7 1998-12-20 20:33:49 nik Exp $ # # Build the FreeBSD Handbook. Will eventually split in two, a generic .mk # file which can be used by many Makefiles, and a much smaller Makefile @@ -140,23 +140,21 @@ CLEANFILES+= ${DOC}.${_curformat} all: ${_docs} index.html: ${SRCS} - ${JADE} -ihtml ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml - ./conv.pl *.html + ${JADE} -ioutput.html ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml tidy -i -m -f /dev/null *.html ${DOC}.html: ${SRCS} - ${JADE} -ihtml -V nochunks ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml > ${DOC}.html - ./conv.pl ${DOC}.html + ${JADE} -ioutput.html -V nochunks ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml > ${DOC}.html tidy -i -m -f /dev/null ${DOC}.html ${DOC}.txt: ${DOC}.html lynx -nolist -dump ${DOC}.html > ${DOC}.txt ${DOC}.rtf: ${SRCS} - ${JADE} -iprint ${JADEFLAGS} -d ${DSLPRINT} -t rtf ${DOC}.sgml + ${JADE} -ioutput.print ${JADEFLAGS} -d ${DSLPRINT} -t rtf ${DOC}.sgml ${DOC}.tex: ${SRCS} - ${JADE} -iprint ${JADEFLAGS} -d ${DSLPRINT} -t tex ${DOC}.sgml + ${JADE} -ioutput.print ${JADEFLAGS} -d ${DSLPRINT} -t tex ${DOC}.sgml ${DOC}.dvi: ${DOC}.tex @echo "==> TeX pass 1/3" diff --git a/en_US.ISO_8859-1/books/handbook/Makefile b/en_US.ISO_8859-1/books/handbook/Makefile index 5543778f82..f856ba2cd7 100644 --- a/en_US.ISO_8859-1/books/handbook/Makefile +++ b/en_US.ISO_8859-1/books/handbook/Makefile @@ -1,5 +1,5 @@ # -# $Id: Makefile,v 1.6 1998-12-10 20:42:26 nik Exp $ +# $Id: Makefile,v 1.7 1998-12-20 20:33:49 nik Exp $ # # Build the FreeBSD Handbook. Will eventually split in two, a generic .mk # file which can be used by many Makefiles, and a much smaller Makefile @@ -140,23 +140,21 @@ CLEANFILES+= ${DOC}.${_curformat} all: ${_docs} index.html: ${SRCS} - ${JADE} -ihtml ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml - ./conv.pl *.html + ${JADE} -ioutput.html ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml tidy -i -m -f /dev/null *.html ${DOC}.html: ${SRCS} - ${JADE} -ihtml -V nochunks ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml > ${DOC}.html - ./conv.pl ${DOC}.html + ${JADE} -ioutput.html -V nochunks ${JADEFLAGS} -d ${DSLHTML} -t sgml ${DOC}.sgml > ${DOC}.html tidy -i -m -f /dev/null ${DOC}.html ${DOC}.txt: ${DOC}.html lynx -nolist -dump ${DOC}.html > ${DOC}.txt ${DOC}.rtf: ${SRCS} - ${JADE} -iprint ${JADEFLAGS} -d ${DSLPRINT} -t rtf ${DOC}.sgml + ${JADE} -ioutput.print ${JADEFLAGS} -d ${DSLPRINT} -t rtf ${DOC}.sgml ${DOC}.tex: ${SRCS} - ${JADE} -iprint ${JADEFLAGS} -d ${DSLPRINT} -t tex ${DOC}.sgml + ${JADE} -ioutput.print ${JADEFLAGS} -d ${DSLPRINT} -t tex ${DOC}.sgml ${DOC}.dvi: ${DOC}.tex @echo "==> TeX pass 1/3" diff --git a/sgml/freebsd.dsl b/sgml/freebsd.dsl index c90a4fd4f2..54d30159e6 100644 --- a/sgml/freebsd.dsl +++ b/sgml/freebsd.dsl @@ -1,36 +1,80 @@ <!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [ -<!ENTITY dbstyle PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA DSSSL> +<!ENTITY % output.html "IGNORE"> +<!ENTITY % output.print "IGNORE"> +<![ %output.html; [ +<!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA DSSSL> +]]> +<![ %output.print; [ +<!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN" CDATA DSSSL> +]]> ]> <style-sheet> <style-specification use="docbook"> <style-specification-body> - <!-- Configure the stylesheet using documented variables --> + <!-- HTML only .................................................... --> + + <![ %output.html; [ + <!-- Configure the stylesheet using documented variables --> - (define %stylesheet% - "handbook.css") + (define %stylesheet% + "handbook.css") - (define %gentext-nav-use-tables% - ;; Use tables to build the navigation headers and footers? - #t) + (define %gentext-nav-use-tables% + ;; Use tables to build the navigation headers and footers? + #t) - (define %html-ext% - ;; Default extension for HTML output files - ".html") + (define %html-ext% + ;; Default extension for HTML output files + ".html") - (define %shade-verbatim% - ;; Should verbatim environments be shaded? - #f) + (define %shade-verbatim% + ;; Should verbatim environments be shaded? + #f) - (define %use-id-as-filename% - ;; Use ID attributes as name for component HTML files? - #t) + (define %use-id-as-filename% + ;; Use ID attributes as name for component HTML files? + #t) - (define %root-filename% - ;; Name for the root HTML document - "index") + (define %root-filename% + ;; Name for the root HTML document + "index") + <!-- This replaces the existing mechanism for showing verbatim + blocks of text (programlistings, screens, and so forth. + + Norm's stylesheet renders these in a table, with optional + shading if %shade-verbatim% is set. Previous practice for + the LinuxDoc DTD (and John Fieber's stylesheet) was to + indent them using <blockquote>. Stick with previous practice. + + Norm says he will introduce a tweakable knob to affect this + in the future. --> +(define ($verbatim-display$ line-numbers?) + (let ((content (make element gi: "BLOCKQUOTE" + attributes: (list + (list "CLASS" (gi))) + (make element gi: "PRE" + (if line-numbers? + ($verbatim-content-with-linenumbers$) + ($verbatim-content$)))))) + (if %shade-verbatim% + (make element gi: "TABLE" + attributes: ($shade-verbatim-attr$) + (make element gi: "TR" + (make element gi: "TD" + content))) + content))) + ]]> + + <!-- Print only ................................................... --> + <![ %output.print; [ + + ]]> + + <!-- Both sets of stylesheets .................................... --> + <!-- Slightly deeper customisations --> <!-- I want things marked up with 'sgmltag' eg., @@ -88,34 +132,8 @@ /usr/local/share/sgml/docbook/dsssl/modular/html/dblist.dsl is enough to bring me out in cold, Lisp induced sweats. . . --> - <!-- This replaces the existing mechanism for showing verbatim - blocks of text (programlistings, screens, and so forth. - - Norm's stylesheet renders these in a table, with optional - shading if %shade-verbatim% is set. Previous practice for - the LinuxDoc DTD (and John Fieber's stylesheet) was to - indent them using <blockquote>. Stick with previous practice. - - Norm says he will introduce a tweakable knob to affect this - in the future. --> -(define ($verbatim-display$ line-numbers?) - (let ((content (make element gi: "BLOCKQUOTE" - attributes: (list - (list "CLASS" (gi))) - (make element gi: "PRE" - (if line-numbers? - ($verbatim-content-with-linenumbers$) - ($verbatim-content$)))))) - (if %shade-verbatim% - (make element gi: "TABLE" - attributes: ($shade-verbatim-attr$) - (make element gi: "TR" - (make element gi: "TD" - content))) - content))) - </style-specification-body> </style-specification> - <external-specification id="docbook" document="dbstyle"> + <external-specification id="docbook" document="docbook.dsl"> </style-sheet> diff --git a/sgml/freebsd.dtd b/sgml/freebsd.dtd index f8263988c7..b4979d8afc 100644 --- a/sgml/freebsd.dtd +++ b/sgml/freebsd.dtd @@ -7,9 +7,19 @@ The FPI for this DTD is "-//FreeBSD//DTD DocBook V3.0-Based Extension//EN" - $Id: freebsd.dtd,v 1.2 1998-11-03 23:38:43 nik Exp $ + $Id: freebsd.dtd,v 1.3 1998-12-20 20:33:49 nik Exp $ --> +<!-- ..................................................................... --> +<!-- Parameter entities .................................................. --> + +<!-- These parameter entities have specific meanings, and default to + "IGNORE". The SGML parser is free to redefine them to "INCLUDE" to + cause special processing. --> + +<!ENTITY % output.html "IGNORE"> <!-- HTML output is being generated --> +<!ENTITY % output.print "IGNORE"> <!-- Print output is being generated --> + <!-- ..................................................................... --> <!-- Entities for element classes and mixtures ........................... --> @@ -20,6 +30,25 @@ <!-- Character level classes --> <!ENTITY % local.tech.char.class "|HostID|Username|Devicename|MakeTarget|MakeVar"> +<!-- Altered general entities ............................................ + + The HTML 4.0 DTD includes some new ISO entities. Most browsers don't + support them yet. Change the definition of some of these entities to + character strings that the browsers will support. + + This does not apply when generating printed output, so these are + contained within a %output.html; marked section. + + As browser technology improves, these definitions can be removed. --> + +<![ %output.html; [ +<!ENTITY ldquo "``"> +<!ENTITY rdquo "''"> +<!ENTITY mdash "---"> +<!ENTITY ndash "--"> +<!ENTITY hellip "..."> +<!ENTITY dollar "$"> +]]> <!-- Pull in the original DTD --> <!ENTITY % orig-docbook PUBLIC "-//Davenport//DTD DocBook V3.0//EN"> @@ -107,3 +136,4 @@ <!ENTITY prompt.root "<prompt>#</prompt>"> <!ENTITY prompt.user "<prompt>%</prompt>"> +