mirror of https://github.com/tLDP/LDP
updated
This commit is contained in:
gferg
parent
93d047ff2c
commit
3a99c7ff82
|
|
@ -18,6 +18,16 @@
|
|||
|
||||
<revhistory>
|
||||
|
||||
<revision>
|
||||
<revnumber>v1.3</revnumber>
|
||||
<date>2002-08-02</date>
|
||||
<authorinitials>sa</authorinitials>
|
||||
<revremark>
|
||||
Added the "Additional Reseources" section.
|
||||
</revremark>
|
||||
</revision>
|
||||
|
||||
|
||||
<revision>
|
||||
<revnumber>v1.2</revnumber>
|
||||
<date>2002-07-23</date>
|
||||
|
|
@ -73,7 +83,7 @@ A copy of the license is available at
|
|||
<sect2><title>What is DocBook?</title>
|
||||
|
||||
<para>
|
||||
DocBook is document type definition (DTD). DocBook is a commonly used DTD for writing technical documents. A DTD defines the syntax of a document, so DocBook is a definition of a syntax for writing documents.
|
||||
DocBook is document type definition (DTD). DocBook is a commonly used DTD for writing technical documents. A DTD defines the syntax of a document - essentially it is a 'rule book' that describes the sets of tags and attributes that will be used to describe specific kinds of content. So DocBook is a "Rule Book" that is used for writing documents. Every TAG that is used in writing the document, must be defined verfy specifically and formally in the DTD.
|
||||
</para>
|
||||
|
||||
</sect2>
|
||||
|
|
@ -147,8 +157,7 @@ Create a directory <filename class="directory">/tmp/downloads</filename>. We wil
|
|||
<sect2><title>DocBook DTD</title>
|
||||
<para>All the DocBook DTDs are available from The Linux Documentation Project website at <ulink url="http://www.tldp.org/authors/index.html#resources">http://www.tldp.org/authors/index.html#resources</ulink></para>
|
||||
|
||||
<para>I use DocBook 3.1, so we will work with 3.1 in this
|
||||
document. But you can download any or all of the DTDs.
|
||||
<para>Please download DocBook SGML v4.1, DocBook SGML v3.1, and DocBook XML v4.1.2
|
||||
</para>
|
||||
|
||||
<note><title>Note</title>
|
||||
|
|
@ -302,8 +311,7 @@ place. The DSSSL does not have to be compiled.
|
|||
|
||||
<sect2><title>Installing DocBook DTDs</title>
|
||||
|
||||
<para>In this section we will install DocBook 3.1 (cause that is the
|
||||
one that I use), but you can use whichever DTD you prefer.
|
||||
<para>In this section we will install DocBook DTDs.
|
||||
</para>
|
||||
|
||||
<orderedlist>
|
||||
|
|
@ -314,24 +322,53 @@ one that I use), but you can use whichever DTD you prefer.
|
|||
</screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Create a new directory called <filename
|
||||
class="directory">dtd3.1</filename>.</para>
|
||||
<para>Create a new directory called <filename class="directory">dtd3.1</filename> <filename class="directory">dtd4.1</filename> <filename class="directory">dtd4.1.2</filename>.</para>
|
||||
<screen>
|
||||
<command># mkdir dtd3.1</command>
|
||||
<command># mkdir dtd4.1</command>
|
||||
<command># mkdir dtd4.1.2</command>
|
||||
</screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Change directories to the new directory.</para>
|
||||
<para>Change directories to the <filename class="directory">dtd3.1</filename>.</para>
|
||||
<screen>
|
||||
<command># cd dtd3.1</command>
|
||||
</screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Unzip the file.</para>
|
||||
<para>Unzip the file DocBook SGML v3.1 in this directory.</para>
|
||||
<screen>
|
||||
<command># unzip /tmp/downloads/docbk31.zip</command>
|
||||
</screen>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Change directories to the <filename class="directory">dtd4.1</filename>.</para>
|
||||
<screen>
|
||||
<command># cd ../dtd4.1</command>
|
||||
</screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Unzip the file DocBook SGML v4.1 in this directory.</para>
|
||||
<screen>
|
||||
<command># unzip /tmp/downloads/docbk41.zip</command>
|
||||
</screen>
|
||||
</listitem>
|
||||
|
||||
<listitem>
|
||||
<para>Change directories to the <filename class="directory">dtd4.1.2</filename>.</para>
|
||||
<screen>
|
||||
<command># cd ../dtd4.1.2</command>
|
||||
</screen>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Unzip the file DocBook SGML v4.1.2 in this directory.</para>
|
||||
<screen>
|
||||
<command># unzip /tmp/downloads/docbk412.zip</command>
|
||||
</screen>
|
||||
</listitem>
|
||||
|
||||
|
||||
</orderedlist>
|
||||
|
||||
</sect2>
|
||||
|
|
@ -466,7 +503,9 @@ Installing in htmldoc...
|
|||
|
||||
<sect1><title>Using OpenJade</title>
|
||||
|
||||
<para>In this section we will use OpenJade to convert SGML documents to HTML and RTF.</para>
|
||||
<para>In this section we will use OpenJade to convert SGML documents to HTML, RTF, and PDF.</para><para> You can download a sample DocBook 3.1 SGML file from <ulink url="http://docbook.sc-icc.org/DocBook-OpenJade-SGML-XML-HOWTO.sgml">http://docbook.sc-icc.org/DocBook-OpenJade-SGML-XML-HOWTO.sgml</ulink></para>
|
||||
|
||||
|
||||
|
||||
<sect2><title>Setting the SGML_CATALOG_FILES Environmental Variable</title>
|
||||
<para>The SGML_CATALOG_FILES variable must be set to point to appropriate
|
||||
|
|
@ -515,7 +554,7 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
|
|||
<command># /usr/local/dbtools/openjade/bin/openjade -V nochunks -t sgml -d /usr/local/dbtools/docbook-dsssl/html/ldp.dsl#html DocBook-OpenJade-SGML-XML-HOWTO.sgml </command>
|
||||
</screen>
|
||||
|
||||
<para>The run HTMLDOC to produce PDF</para>
|
||||
<para>Then run HTMLDOC to produce PDF</para>
|
||||
<screen>
|
||||
<command># /usr/local/dbtools/htmldoc/bin/htmldoc -f outfile.pdf input.html</command>
|
||||
</screen>
|
||||
|
|
@ -524,5 +563,56 @@ To convert HTML to PDF we must use HTMLDOC. First create non-chunked HTML output
|
|||
|
||||
</sect1>
|
||||
|
||||
<sect1><Title>Further Information</Title>
|
||||
<para>This section has some pointers to the related resource on the internet.</para>
|
||||
<para> If you would like to suggest additional resource for this section, please email me @ <email> saqib@seagate.com</email>. Thanks. <para>
|
||||
|
||||
<sect2><title>News groups</title>
|
||||
<para>Some of the News groups of interest are:</para>
|
||||
<orderedlist>
|
||||
<listitem><para>comp.text.sgml (easily accessible from <ulink url="http://www.deja.com">http://www.deja.com</ulink>)</para></listitem>
|
||||
<listitem><para>comp.text.xml (easily accessible from <ulink url="http://www.deja.com">http://www.deja.com</ulink>)</para></listitem>
|
||||
<listitem><para>htmldoc.general (server - nttp://news.easysw.com)</para></listitem>
|
||||
</orderedlist>
|
||||
</sect2>
|
||||
|
||||
|
||||
<sect2><title>Mailing Lists</title>
|
||||
<para>Here are some relevant Mailing Lists</para>
|
||||
<orderedlist>
|
||||
<listitem><para>DocBook mailing list @ OASIS. Visit <ulink url="http://www.oasis-open.org/committees/docbook/mailinglist/index.shtml">http://www.oasis-open.org/committees/docbook/mailinglist/index.shtml</ulink> for more info.</para></listitem>
|
||||
<listitem><para>DocBook mailing list @ TLDP. Visit <ulink url="http://www.tldp.org/mailinfo.html">http://www.tldp.org/mailinfo.html</ulink> for more info.</para></listitem>
|
||||
<listitem><para>xml-doc @ Yahoo Groups. Visit <ulink url="http://groups.yahoo.com/group/xml-doc/">http://groups.yahoo.com/group/xml-doc/</ulink> for more info.</para></listitem>
|
||||
|
||||
</orderedlist>
|
||||
</sect2>
|
||||
|
||||
|
||||
<sect2><title>IRC</title>
|
||||
<orderedlist>
|
||||
<listitem><para>DocBook IRC Channel. #docbook on irc://irc.openprojects.net</para></listitem>
|
||||
</orderedlist>
|
||||
</sect2>
|
||||
|
||||
<sect2><title>Web Sites</title>
|
||||
<orderedlist>
|
||||
<listitem><para><ulink url="http://www.oasis-open.org/">http://www.oasis-open.org/</ulink> OASIS maintains various DocBook DTDs</para></listitem>
|
||||
<listitem><para><ulink url="http://docbook.org/wiki/moin.cgi/">http://docbook.org/wiki/moin.cgi/</ulink>The DocBook Wiki</para></listitem>
|
||||
<listitem><para><ulink url="http://www.docbook.org/tdg/en/">http://www.docbook.org/tdg/en/</ulink>Online version of DocBook: The Definitive Guide</para></listitem>
|
||||
<listitem><para><ulink url="http://www-106.ibm.com/developerworks/library/l-docbk.html">http://www-106.ibm.com/developerworks/library/l-docbk.html</ulink>A gentle guide to DocBook (very good introduction).</para></listitem>
|
||||
</orderedlist>
|
||||
</sect2>
|
||||
|
||||
<sect2><title>Commercial Tools</title>
|
||||
<orderedlist>
|
||||
<listitem><para>DocPro by Command Prompt, INC. <ulink url="http://www.commandprompt.com/entry.lxp?lxpe=2">http://www.commandprompt.com/entry.lxp?lxpe=2</ulink></para></listitem>
|
||||
<listitem><para>YAWC Pro by XML Workshop LTD. <ulink url="http://www.yawcpro.com/">http://www.yawcpro.com/</ulink>. Can be used for converting MS Word to Simple DocBook XML. </para></listitem>
|
||||
<listitem><para>Logictran RTF Converter. <ulink url="http://www.logictran.com/">http://www.logictran.com/</ulink>. Word/RTF to HTML/XML</para></listitem>
|
||||
<listitem><para>MajiX - Word to XML converter. <ulink url="http://tetrasys.dhs.org/">http://tetrasys.dhs.org/</ulink>
|
||||
<listitem><para>XMETAL by SoftQuad <ulink url="http://www.softquad.com/">http://www.softquad.com/</ulink> </para></listitem>
|
||||
</orderedlist>
|
||||
</sect2>
|
||||
|
||||
</sect1>
|
||||
|
||||
</article>
|
||||
|
|
|
|||
|
|
@ -729,7 +729,7 @@ How to become a totally "small time" DNS admin. </Para>
|
|||
DocBook-OpenJade-SGML-XML-HOWTO</ULink>,
|
||||
<CiteTitle>DocBook XML/SGML Processing Using OpenJade</CiteTitle>
|
||||
</Para><Para>
|
||||
<CiteTitle>Updated: July 2002</CiteTitle>.
|
||||
<CiteTitle>Updated: August 2002</CiteTitle>.
|
||||
Explains setting up OpenJade to process SGML/XML DocBook documents. </Para>
|
||||
</ListItem>
|
||||
|
||||
|
|
|
|||
|
|
@ -35,7 +35,7 @@ system. </Para>
|
|||
DocBook-OpenJade-SGML-XML-HOWTO</ULink>,
|
||||
<CiteTitle>DocBook XML/SGML Processing Using OpenJade</CiteTitle>
|
||||
</Para><Para>
|
||||
<CiteTitle>Updated: July 2002</CiteTitle>.
|
||||
<CiteTitle>Updated: August 2002</CiteTitle>.
|
||||
Explains setting up OpenJade to process SGML/XML DocBook documents. </Para>
|
||||
</ListItem>
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue