<!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.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="AEN31" ></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 ><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="x38.html" >Why care about DocBook at all?</A ></DT ><DT >3. <A HREF="x50.html" >Structural markup: a primer</A ></DT ><DT >4. <A HREF="x78.html" >Document Type Definitions</A ></DT ><DT >5. <A HREF="x101.html" >Other DTDs</A ></DT ><DT >6. <A HREF="x109.html" >The DocBook toolchain</A ></DT ><DT >7. <A HREF="x168.html" >Who are the projects and the players?</A ></DT ><DT >8. <A HREF="x181.html" >Migration tools</A ></DT ><DT >9. <A HREF="x228.html" >Editing tools</A ></DT ><DT >10. <A HREF="x245.html" >Hints and tricks</A ></DT ><DT >11. <A HREF="x249.html" >Related standards and practices</A ></DT ><DT >12. <A HREF="sgml.html" >SGML and SGML-Tools</A ></DT ><DD ><DL ><DT >12.1. <A HREF="sgml.html#AEN262" >DocBook SGML</A ></DT ><DT >12.2. <A HREF="sgml.html#AEN271" >SGML tools</A ></DT ><DT >12.3. <A HREF="sgml.html#AEN283" >Why SGML DocBook is dead</A ></DT ><DT >12.4. <A HREF="sgml.html#AEN295" >SGML-Tools</A ></DT ></DL ></DD ><DT >13. <A HREF="x301.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 >