369 lines
4.7 KiB
HTML
369 lines
4.7 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>DocBook Demystification HOWTO</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
|
|
REL="NEXT"
|
|
TITLE="Introduction"
|
|
HREF="intro.html"></HEAD
|
|
><BODY
|
|
CLASS="article"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#0000FF"
|
|
VLINK="#840084"
|
|
ALINK="#0000FF"
|
|
><DIV
|
|
CLASS="ARTICLE"
|
|
><DIV
|
|
CLASS="TITLEPAGE"
|
|
><H1
|
|
CLASS="title"
|
|
><A
|
|
NAME="AEN2"
|
|
></A
|
|
>DocBook Demystification HOWTO</H1
|
|
><H3
|
|
CLASS="author"
|
|
><A
|
|
NAME="AEN4"
|
|
>Eric Raymond</A
|
|
></H3
|
|
><DIV
|
|
CLASS="affiliation"
|
|
><DIV
|
|
CLASS="address"
|
|
><P
|
|
CLASS="address"
|
|
><br>
|
|
<TT
|
|
CLASS="email"
|
|
><<A
|
|
HREF="mailto:esr@thyrsus.com"
|
|
>esr@thyrsus.com</A
|
|
>></TT
|
|
><br>
|
|
</P
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="revhistory"
|
|
><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
><TR
|
|
><TH
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
COLSPAN="3"
|
|
><B
|
|
>Revision History</B
|
|
></TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revision v1.6</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>2010-09-14</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revised by: esr</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
COLSPAN="3"
|
|
>Major update. dblatex actually works for PDF production.
|
|
Describe asciidoc.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revision v1.5</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>2006-10-13</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revised by: esr</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
COLSPAN="3"
|
|
>Major update. Getox seems to be dead, FOP a bit further along.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revision v1.4</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>2004-10-28</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revised by: esr</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
COLSPAN="3"
|
|
>Minor update and license change.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revision v1.3</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>2004-02-27</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revised by: esr</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
COLSPAN="3"
|
|
>Add pointers to two editors.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revision v1.2</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>2003-02-17</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revised by: esr</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
COLSPAN="3"
|
|
>Reorder to defer references to SGML until after it has been
|
|
introduced.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revision v1.1</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>2002-10-01</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revised by: esr</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
COLSPAN="3"
|
|
>Correct inadvertent misrepresentation of FSF's position.
|
|
Added pointer to the DocBook FAQ.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revision v1.0</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>2002-09-20</TD
|
|
><TD
|
|
ALIGN="LEFT"
|
|
>Revised by: esr</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
ALIGN="LEFT"
|
|
COLSPAN="3"
|
|
>Initial version.</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
><DIV
|
|
><DIV
|
|
CLASS="abstract"
|
|
><A
|
|
NAME="AEN50"
|
|
></A
|
|
><P
|
|
></P
|
|
><P
|
|
> This HOWTO attempts to clear the fog and mystery surrounding the
|
|
DocBook markup system and the tools that go with it. It is aimed at
|
|
authors of technical documentation for open-source projects hosted
|
|
on Linux, but should be useful for people composing other kinds on
|
|
other Unixes as well.
|
|
</P
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><A
|
|
HREF="ln46.html"
|
|
>Legal Notice</A
|
|
><HR></DIV
|
|
><DIV
|
|
CLASS="TOC"
|
|
><DL
|
|
><DT
|
|
><B
|
|
>Table of Contents</B
|
|
></DT
|
|
><DT
|
|
>1. <A
|
|
HREF="intro.html"
|
|
>Introduction</A
|
|
></DT
|
|
><DT
|
|
>2. <A
|
|
HREF="x57.html"
|
|
>Why care about DocBook at all?</A
|
|
></DT
|
|
><DT
|
|
>3. <A
|
|
HREF="x69.html"
|
|
>Structural markup: a primer</A
|
|
></DT
|
|
><DT
|
|
>4. <A
|
|
HREF="x97.html"
|
|
>Document Type Definitions</A
|
|
></DT
|
|
><DT
|
|
>5. <A
|
|
HREF="x120.html"
|
|
>Other DTDs</A
|
|
></DT
|
|
><DT
|
|
>6. <A
|
|
HREF="x128.html"
|
|
>The DocBook toolchain</A
|
|
></DT
|
|
><DT
|
|
>7. <A
|
|
HREF="x183.html"
|
|
>asciidoc</A
|
|
></DT
|
|
><DT
|
|
>8. <A
|
|
HREF="x191.html"
|
|
>Who are the projects and the players?</A
|
|
></DT
|
|
><DT
|
|
>9. <A
|
|
HREF="x206.html"
|
|
>Migration tools</A
|
|
></DT
|
|
><DT
|
|
>10. <A
|
|
HREF="x253.html"
|
|
>Editing tools</A
|
|
></DT
|
|
><DT
|
|
>11. <A
|
|
HREF="x260.html"
|
|
>Hints and tricks</A
|
|
></DT
|
|
><DT
|
|
>12. <A
|
|
HREF="x264.html"
|
|
>Related standards and practices</A
|
|
></DT
|
|
><DT
|
|
>13. <A
|
|
HREF="sgml.html"
|
|
>SGML and SGML-Tools</A
|
|
></DT
|
|
><DD
|
|
><DL
|
|
><DT
|
|
>13.1. <A
|
|
HREF="sgml.html#AEN277"
|
|
>DocBook SGML</A
|
|
></DT
|
|
><DT
|
|
>13.2. <A
|
|
HREF="sgml.html#AEN286"
|
|
>SGML tools</A
|
|
></DT
|
|
><DT
|
|
>13.3. <A
|
|
HREF="sgml.html#AEN298"
|
|
>Why SGML DocBook is dead</A
|
|
></DT
|
|
><DT
|
|
>13.4. <A
|
|
HREF="sgml.html#AEN310"
|
|
>SGML-Tools</A
|
|
></DT
|
|
></DL
|
|
></DD
|
|
><DT
|
|
>14. <A
|
|
HREF="x316.html"
|
|
>References</A
|
|
></DT
|
|
></DL
|
|
></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"
|
|
> </TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
><A
|
|
HREF="intro.html"
|
|
ACCESSKEY="N"
|
|
>Next</A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="left"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="34%"
|
|
ALIGN="center"
|
|
VALIGN="top"
|
|
> </TD
|
|
><TD
|
|
WIDTH="33%"
|
|
ALIGN="right"
|
|
VALIGN="top"
|
|
>Introduction</TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |