299 lines
4.6 KiB
HTML
299 lines
4.6 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>DocBook DTD</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
|
|
REL="HOME"
|
|
TITLE="LDP Author Guide"
|
|
HREF="index.html"><LINK
|
|
REL="UP"
|
|
TITLE="System Setup: Editors, Validation and
|
|
Transformations"
|
|
HREF="tools.html"><LINK
|
|
REL="PREVIOUS"
|
|
TITLE="Transformations"
|
|
HREF="transformations.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="Formatting Documents"
|
|
HREF="doc-components.html"></HEAD
|
|
><BODY
|
|
CLASS="section"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="NAVHEADER"
|
|
><TABLE
|
|
SUMMARY="Header navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TH
|
|
COLSPAN="3"
|
|
ALIGN="center"
|
|
>LDP Author Guide</TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="left"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="transformations.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="center"
|
|
VALIGN="bottom"
|
|
>Appendix B. System Setup: Editors, Validation and
|
|
Transformations</TD
|
|
><TD
|
|
WIDTH="10%"
|
|
ALIGN="right"
|
|
VALIGN="bottom"
|
|
><A
|
|
HREF="doc-components.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"></DIV
|
|
><DIV
|
|
CLASS="section"
|
|
><H1
|
|
CLASS="section"
|
|
><A
|
|
NAME="dtd"
|
|
></A
|
|
>B.5. DocBook DTD</H1
|
|
><P
|
|
>
|
|
The DocBook DTD defines the structure of a DocBook
|
|
document. It contains rules about how the elements
|
|
may be used; and what the elements ought to be
|
|
describing. For example: it is the DocBook DTD
|
|
which states all <TT
|
|
CLASS="sgmltag"
|
|
>warning</TT
|
|
>s are to
|
|
<EM
|
|
>warn</EM
|
|
> the reader (this is the
|
|
definition of the element); and may not contain
|
|
plain text (this is the content model--and the
|
|
bit which forces you to wrap your warning text
|
|
in a <TT
|
|
CLASS="sgmltag"
|
|
>para</TT
|
|
> or perhaps a list).
|
|
</P
|
|
><DIV
|
|
CLASS="caution"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="caution"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/caution.gif"
|
|
HSPACE="5"
|
|
ALT="Caution"></TD
|
|
><TH
|
|
ALIGN="LEFT"
|
|
VALIGN="CENTER"
|
|
><B
|
|
>Versions</B
|
|
></TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
> </TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> It is important that you download the
|
|
version(s) that match your document. You
|
|
may want to configure your system now to
|
|
deal with <SPAN
|
|
CLASS="QUOTE"
|
|
>"all"</SPAN
|
|
> DocBook DTDs
|
|
if you are going to be editing older LDP
|
|
documents. If you are a new author, you
|
|
only need the first one listed: XML DTD
|
|
for DocBook version 4.2.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
><P
|
|
>The XML DTD is available from <A
|
|
HREF="http://www.oasis-open.org/docbook/xml/4.2"
|
|
TARGET="_top"
|
|
>http://www.oasis-open.org/xml/4.2/</A
|
|
>.
|
|
The LDP prefers this version of the DocBook DTD.
|
|
</P
|
|
><P
|
|
> If you are going to be working with SGML
|
|
versions of DocBook you will need one
|
|
(or both) of:
|
|
<A
|
|
HREF="http://www.oasis-open.org/docbook/sgml/4.1/docbk41.zip"
|
|
TARGET="_top"
|
|
>http://www.oasis-open.org/docbook/sgml/4.1/docbk41.zip</A
|
|
>
|
|
or <A
|
|
HREF="http://www.oasis-open.org/docbook/sgml/3.1/docbk31.zip"
|
|
TARGET="_top"
|
|
>http://www.oasis-open.org/docbook/sgml/3.1/docbk31.zip</A
|
|
>
|
|
</P
|
|
><DIV
|
|
CLASS="example"
|
|
><A
|
|
NAME="ex-dtd"
|
|
></A
|
|
><P
|
|
><B
|
|
>Example B-7. <SPAN
|
|
CLASS="QUOTE"
|
|
>"Installing"</SPAN
|
|
> DocBook Document Type Definitions</B
|
|
></P
|
|
><P
|
|
>Create a base directory to store everything such as <TT
|
|
CLASS="filename"
|
|
>/opt/local/sgml/</TT
|
|
>. Copy the DTDs
|
|
into a sub-directory named <TT
|
|
CLASS="filename"
|
|
>dtd</TT
|
|
>.
|
|
</P
|
|
></DIV
|
|
><DIV
|
|
CLASS="warning"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
CLASS="warning"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25"
|
|
ALIGN="CENTER"
|
|
VALIGN="TOP"
|
|
><IMG
|
|
SRC="../images/warning.gif"
|
|
HSPACE="5"
|
|
ALT="Warning"></TD
|
|
><TH
|
|
ALIGN="LEFT"
|
|
VALIGN="CENTER"
|
|
><B
|
|
>Do not edit DTD files</B
|
|
></TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
> </TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
><P
|
|
> The DocBook standard is described in these
|
|
files. If you change these files, you are no longer working
|
|
with DocBook.
|
|
</P
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><HR
|
|
ALIGN="LEFT"
|
|
WIDTH="100%"><TABLE
|
|
SUMMARY="Footer navigation table"
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
CELLPADDING="0"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="transformations.html"
|
|
ACCESSKEY="P"
|
|
>Prev</A
|
|
></TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="index.html"
|
|
ACCESSKEY="H"
|
|
>Home</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="doc-components.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
>Transformations</TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="tools.html"
|
|
ACCESSKEY="U"
|
|
>Up</A
|
|
></TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Formatting Documents</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |