doc/sgml/freebsd.dtd
Nik Clayton dd921ed279 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 20:33:49 +00:00

139 lines
4.5 KiB
DTD

<!-- FreeBSD Documentation Project, Extended DocBook DTD
This DTD builds upon the DocBook 3.0 DTD. It extends it in order to
add some new elements.
The comment style and section headings are drawn from the DocBook DTD.
The FPI for this DTD is "-//FreeBSD//DTD DocBook V3.0-Based Extension//EN"
$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 ........................... -->
<!-- Object-level classes ................................................ -->
<!ENTITY % local.list.class "|FAQList">
<!-- 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">
%orig-docbook;
<!-- ...................................................................... -->
<!-- Lists ................................................................ -->
<!ELEMENT FAQList - - (FAQListItem+)>
<!ATTLIST FAQList
--
Mark: Keyword, e.g., bullet, dash, checkbox, none;
list of keywords and defaults are implementation specific
--
%mark.attrib;
%common.attrib;
>
<!-- FAQ Question/Answers ................................................. -->
<!ELEMENT FAQListItem - O (FAQQuestion, FAQAnswer)>
<!ATTLIST FAQListItem
--
Override: Indicates the mark to be used for this FAQListItem
instead of the default mark or the mark specified by
the Mark attribute on the enclosing FAQList
--
Override CDATA #IMPLIED
%common.attrib;
>
<!ELEMENT FAQQuestion - - ((%component.mix;)+)>
<!ATTLIST FAQQuestion
%common.attrib;
>
<!ELEMENT FAQAnswer - - ((%component.mix;)+)>
<!ATTLIST FAQAnswer
%common.attrib;
>
<!-- ...................................................................... -->
<!-- Inline, link, and ubiquitous elements ................................ -->
<!-- Technical and computer terms ......................................... -->
<!ELEMENT HostID - - ((%cptr.char.mix;)+)>
<!ATTLIST HostID
--
Role: More specific information about this hostname.
If not specified then the default is 'hostname'.
--
Role (Hostname
|Domainname
|FQDN
|IPAddr
|Netmask
|MAC) #IMPLIED
%common.attrib;
>
<!ELEMENT Username - - ((%cptr.char.mix;)+)>
<!ATTLIST Username
%common.attrib;
>
<!ELEMENT Devicename - - ((%cptr.char.mix;)+)>
<!ATTLIST Devicename
%common.attrib;
>
<!ELEMENT MakeTarget - - ((%cptr.char.mix;)+)>
<!ATTLIST MakeTarget
%common.attrib;
>
<!ELEMENT MakeVar - - ((%cptr.char.mix;)+)>
<!ATTLIST MakeVar
%common.attrib;
>
<!-- ...................................................................... -->
<!-- General entities for reuse ........................................... -->
<!ENTITY prompt.root "<prompt>#</prompt>">
<!ENTITY prompt.user "<prompt>%</prompt>">