os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
doc/share/sgml/freebsd.dsl

38 lines
1.4 KiB
Text
Raw Normal View History

Correctly use the \url{} macro for ulinks without any content. So <ulink url="bla"></ulink> will be displayed properly.
2001-10-13 03:07:24 +02:00
<!-- $FreeBSD$ -->
Add $FreeBSD$ comment. Submitted by: billf
1999-11-15 20:44:15 +01:00
This is a DSSSL stylesheet. It builds upon Norm Walsh's modular DocBook stylesheet (ports/textproc/dsssl-docbook-modular) and extends it in three ways. First, Norm's stylesheets have a number of documented 'knobs' that can be twiddled to produce specific effects. For example, one of the options I've turned on names the generated HTML files after the id attribute of a section. Say goodbye to c01234.html, and wave hello to 'kerneloptions.html'. Second, some of Norm's design choices don't follow our existing practice. For example, we indicate application names in bold, command names in a monospace font. Norm's sheets just render command names in bold. So we override his definition with our own for some elements. Thirdly, we tell the stylesheet about elements that don't exist in DocBook but do exist in our extended DTD. Tim Vanderhoek is probably sliding off his seat about now :-) There's more that needs doing to this, but it's enough to get start with.
1998-06-30 10:52:15 +02:00
<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
Reorganise things a little bit. Redefine two functions in <[ %output.print; [ ... ]]> to support image handling.
2000-10-08 21:15:06 +02:00
<!ENTITY % output.html "IGNORE">
<!ENTITY % output.print "IGNORE">
Give each language and encoding it's own freebsd.dsl, to contain style sheet definitions for that language only. Each file reads in the defaults from the master share/sgml/freebsd.dsl file, and adds overrides, or new definitions, as necessary. Move the per-language hacks from share/sgml/freebsd.dsl in to <lang>/share/sgml/freebsd.dsl as necessary. Add links to the -questions and -doc mailing lists to the bottom of the generated HTML output for some languages. The -questions link will become a link to Greg's "Getting the most from questions" document when I bring that in, but I haven't done that yet, and I didn't want these patches hanging around my local tree. This was the real reason for making freebsd.dsl language local, as it makes it much easier to translate generated text, such as the text of the links, without polluting share/sgml/freebsd.dsl. Update doc.docbook.mk to use the new, per-language freebsd.dsl file when building the docs. While I'm here, update .pdb generation so that it creates a symlink to ${CURDIR:T}.pdb as well (e.g., the Handbook generates "book.pdb" and "handbook.pdb"). This makes it easier to install more than one document on a Palm, because two docs called "book.pdb" or "article.pdb" can not co-exist.
2000-03-23 10:00:17 +01:00
- Add WITH_DOCFORMAT_NAVI_LINK to mk/doc.docbook.mk and enable it in en_US.ISO8859-1/ and ja_JP.eucJP/. - Add PUBLIC "-//FreeBSD//ENTITIES DocBook Language Specific Entities//EN" and l10n.ent for entity localization. - Use share/misc/docbook.css for indentiation of <programlisting> and <screen>. - Add some missing $FreeBSD$.
2003-04-19 13:39:30 +02:00
<!ENTITY % freebsd.l10n PUBLIC "-//FreeBSD//ENTITIES DocBook Language Specific Entities//EN">
%freebsd.l10n;
<!ENTITY % freebsd.l10n-common PUBLIC "-//FreeBSD//ENTITIES DocBook Language Neutral Entities//EN">
%freebsd.l10n-common;
Added output.html and output.print as parameter entities to freebsd.dtd. Default to "IGNORE", you should set them to "INCLUDE" by whatever mechanism your SGML parser supports as necessary (i.e., Jade's -i flag). Added redefinitions for some ISO entities that aren't understood by most web browsers. Since this is for HTML output only, wrap it in a %output.html; marked section. Use these marked sections to put both print and HTML stylesheets in one .dsl file (freebsd.dsl). The print stylesheet now understands about the elements that have been added to DocBook (and won't try and render them in red). Updated Makefile to use output.html and output.print on the command line to Jade, instead of the earlier "html" and "print. Note: producing .tex (and thence .ps and .pdf) versions of the Handbook is broken. The Handbook tickles several bugs in the JadeTeX macros. Sebastian Rahz, the JadeTeX author, knows about this, and is working on fixing them.
1998-12-20 21:33:49 +01:00
<![ %output.html; [
<!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN" CDATA DSSSL>
Split freebsd.dsl into -html, -print, and -common parts for ease in modification. No functionality change here.
2008-12-24 18:06:07 +01:00
<!ENTITY freebsd.dsl PUBLIC "-//FreeBSD//DOCUMENT DocBook HTML Stylesheet//EN" CDATA DSSSL>
Added output.html and output.print as parameter entities to freebsd.dtd. Default to "IGNORE", you should set them to "INCLUDE" by whatever mechanism your SGML parser supports as necessary (i.e., Jade's -i flag). Added redefinitions for some ISO entities that aren't understood by most web browsers. Since this is for HTML output only, wrap it in a %output.html; marked section. Use these marked sections to put both print and HTML stylesheets in one .dsl file (freebsd.dsl). The print stylesheet now understands about the elements that have been added to DocBook (and won't try and render them in red). Updated Makefile to use output.html and output.print on the command line to Jade, instead of the earlier "html" and "print. Note: producing .tex (and thence .ps and .pdf) versions of the Handbook is broken. The Handbook tickles several bugs in the JadeTeX macros. Sebastian Rahz, the JadeTeX author, knows about this, and is working on fixing them.
1998-12-20 21:33:49 +01:00
]]>
<![ %output.print; [
<!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN" CDATA DSSSL>
Split freebsd.dsl into -html, -print, and -common parts for ease in modification. No functionality change here.
2008-12-24 18:06:07 +01:00
<!ENTITY freebsd.dsl PUBLIC "-//FreeBSD//DOCUMENT DocBook Print Stylesheet//EN" CDATA DSSSL>
Added output.html and output.print as parameter entities to freebsd.dtd. Default to "IGNORE", you should set them to "INCLUDE" by whatever mechanism your SGML parser supports as necessary (i.e., Jade's -i flag). Added redefinitions for some ISO entities that aren't understood by most web browsers. Since this is for HTML output only, wrap it in a %output.html; marked section. Use these marked sections to put both print and HTML stylesheets in one .dsl file (freebsd.dsl). The print stylesheet now understands about the elements that have been added to DocBook (and won't try and render them in red). Updated Makefile to use output.html and output.print on the command line to Jade, instead of the earlier "html" and "print. Note: producing .tex (and thence .ps and .pdf) versions of the Handbook is broken. The Handbook tickles several bugs in the JadeTeX macros. Sebastian Rahz, the JadeTeX author, knows about this, and is working on fixing them.
1998-12-20 21:33:49 +01:00
]]>
Split freebsd.dsl into -html, -print, and -common parts for ease in modification. No functionality change here.
2008-12-24 18:06:07 +01:00
<!ENTITY freebsd-common.dsl PUBLIC "-//FreeBSD//DOCUMENT DocBook Common Stylesheet//EN" CDATA DSSSL>
This is a DSSSL stylesheet. It builds upon Norm Walsh's modular DocBook stylesheet (ports/textproc/dsssl-docbook-modular) and extends it in three ways. First, Norm's stylesheets have a number of documented 'knobs' that can be twiddled to produce specific effects. For example, one of the options I've turned on names the generated HTML files after the id attribute of a section. Say goodbye to c01234.html, and wave hello to 'kerneloptions.html'. Second, some of Norm's design choices don't follow our existing practice. For example, we indicate application names in bold, command names in a monospace font. Norm's sheets just render command names in bold. So we override his definition with our own for some elements. Thirdly, we tell the stylesheet about elements that don't exist in DocBook but do exist in our extended DTD. Tim Vanderhoek is probably sliding off his seat about now :-) There's more that needs doing to this, but it's enough to get start with.
1998-06-30 10:52:15 +02:00
]>
<style-sheet>
Split freebsd.dsl into -html, -print, and -common parts for ease in modification. No functionality change here.
2008-12-24 18:06:07 +01:00
<style-specification use="freebsd freebsd-common docbook">
This is a DSSSL stylesheet. It builds upon Norm Walsh's modular DocBook stylesheet (ports/textproc/dsssl-docbook-modular) and extends it in three ways. First, Norm's stylesheets have a number of documented 'knobs' that can be twiddled to produce specific effects. For example, one of the options I've turned on names the generated HTML files after the id attribute of a section. Say goodbye to c01234.html, and wave hello to 'kerneloptions.html'. Second, some of Norm's design choices don't follow our existing practice. For example, we indicate application names in bold, command names in a monospace font. Norm's sheets just render command names in bold. So we override his definition with our own for some elements. Thirdly, we tell the stylesheet about elements that don't exist in DocBook but do exist in our extended DTD. Tim Vanderhoek is probably sliding off his seat about now :-) There's more that needs doing to this, but it's enough to get start with.
1998-06-30 10:52:15 +02:00
<style-specification-body>
Add a formatting instruction to wrap URLs in \url{} for the print backend. This allows JUSTIFY=1 to look much nicer. Filenames still aren't handled, but there is another TeX package for that that I will use shortly.
2001-09-08 04:21:19 +02:00
(declare-flow-object-class formatting-instruction
"UNREGISTERED::James Clark//Flow Object Class::formatting-instruction")
This is a DSSSL stylesheet. It builds upon Norm Walsh's modular DocBook stylesheet (ports/textproc/dsssl-docbook-modular) and extends it in three ways. First, Norm's stylesheets have a number of documented 'knobs' that can be twiddled to produce specific effects. For example, one of the options I've turned on names the generated HTML files after the id attribute of a section. Say goodbye to c01234.html, and wave hello to 'kerneloptions.html'. Second, some of Norm's design choices don't follow our existing practice. For example, we indicate application names in bold, command names in a monospace font. Norm's sheets just render command names in bold. So we override his definition with our own for some elements. Thirdly, we tell the stylesheet about elements that don't exist in DocBook but do exist in our extended DTD. Tim Vanderhoek is probably sliding off his seat about now :-) There's more that needs doing to this, but it's enough to get start with.
1998-06-30 10:52:15 +02:00
</style-specification-body>
</style-specification>
Split freebsd.dsl into -html, -print, and -common parts for ease in modification. No functionality change here.
2008-12-24 18:06:07 +01:00
<external-specification id="freebsd" document="freebsd.dsl">
<external-specification id="freebsd-common" document="freebsd-common.dsl">
Added output.html and output.print as parameter entities to freebsd.dtd. Default to "IGNORE", you should set them to "INCLUDE" by whatever mechanism your SGML parser supports as necessary (i.e., Jade's -i flag). Added redefinitions for some ISO entities that aren't understood by most web browsers. Since this is for HTML output only, wrap it in a %output.html; marked section. Use these marked sections to put both print and HTML stylesheets in one .dsl file (freebsd.dsl). The print stylesheet now understands about the elements that have been added to DocBook (and won't try and render them in red). Updated Makefile to use output.html and output.print on the command line to Jade, instead of the earlier "html" and "print. Note: producing .tex (and thence .ps and .pdf) versions of the Handbook is broken. The Handbook tickles several bugs in the JadeTeX macros. Sebastian Rahz, the JadeTeX author, knows about this, and is working on fixing them.
1998-12-20 21:33:49 +01:00
<external-specification id="docbook" document="docbook.dsl">
This is a DSSSL stylesheet. It builds upon Norm Walsh's modular DocBook stylesheet (ports/textproc/dsssl-docbook-modular) and extends it in three ways. First, Norm's stylesheets have a number of documented 'knobs' that can be twiddled to produce specific effects. For example, one of the options I've turned on names the generated HTML files after the id attribute of a section. Say goodbye to c01234.html, and wave hello to 'kerneloptions.html'. Second, some of Norm's design choices don't follow our existing practice. For example, we indicate application names in bold, command names in a monospace font. Norm's sheets just render command names in bold. So we override his definition with our own for some elements. Thirdly, we tell the stylesheet about elements that don't exist in DocBook but do exist in our extended DTD. Tim Vanderhoek is probably sliding off his seat about now :-) There's more that needs doing to this, but it's enough to get start with.
1998-06-30 10:52:15 +02:00
</style-sheet>
Reference in a new issue Copy permalink