408 lines
16 KiB
HTML
408 lines
16 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
|
||
|
<HTML>
|
||
|
<HEAD>
|
||
|
<TITLE>The Linux Documentation Project: Authors - Contribute / Help</TITLE>
|
||
|
<META NAME="description" CONTENT="Linux Documentation Project Authors area">
|
||
|
</HEAD>
|
||
|
|
||
|
<BODY bgcolor="#AAAAAA" LINK="#003355" ALINK="#003355" VLINK="#003355">
|
||
|
|
||
|
<TABLE WIDTH="100%" BORDER="0" CELLPADDING="4" CELLSPACING="0">
|
||
|
<TR>
|
||
|
<TD ALIGN="center" VALIGN="top"><A HREF="../index.html"><IMG SRC="../images/ldp.gif" WIDTH="300" HEIGHT="120" ALIGN="absmiddle" BORDER="0" ALT="The Linux Documentation Project"></A>
|
||
|
</TR>
|
||
|
|
||
|
<TR BGCOLOR="#AAAAAA">
|
||
|
<TD ALIGN="center"><font face="arial,helvetica" color="#ffffff"><B>
|
||
|
<A HREF="../index.html"><font face="arial,helvetica" color="#ffffff">
|
||
|
home</font></A> |
|
||
|
<A HREF="../docs.html#howto"><font face="arial,helvetica" color="#ffffff"> HOWTOs</font></A> |
|
||
|
<A HREF="../guides.html"><font face="arial,helvetica" color="#ffffff">
|
||
|
Guides</font></A> |
|
||
|
<A HREF="../docs.html#faq"><font face="arial,helvetica" color="#ffffff">
|
||
|
FAQs</font></A> |
|
||
|
<A HREF="../docs.html#man"><font face="arial,helvetica" color="#ffffff">
|
||
|
man pages</font></A> |
|
||
|
<A HREF="../docs.html#lg"><font face="arial,helvetica" color="#ffffff">
|
||
|
Linux Gazette</font></A> |
|
||
|
<A HREF="../docs.html#lf"><font face="arial,helvetica" color="#ffffff">
|
||
|
LinuxFocus</font></A>
|
||
|
</B></font></TD>
|
||
|
</TR>
|
||
|
|
||
|
<TR BGCOLOR="#BBCCEE">
|
||
|
<TD ALIGN="center" VALIGN="center"><BR>
|
||
|
<H4><FONT FACE="arial,helvetica">
|
||
|
Linux Documentation Project: Authors - Contribute / Help</FONT></H4>
|
||
|
</TD></TR>
|
||
|
|
||
|
<TR><TD BGCOLOR="#FFFFFF">
|
||
|
<P><font face="Arial, Helvetica, sans-serif">
|
||
|
<!-- getting started -->
|
||
|
|
||
|
<table width="100%" border="0" cellspacing="2" cellpadding="2">
|
||
|
<tr align="left" valign="top">
|
||
|
<td width="99%" bgcolor="#BBCCEE" height="2">
|
||
|
<a name="gs"></a>
|
||
|
<font face="Arial, Helvetica, sans-serif"><b>
|
||
|
<font color="#000000">Getting Started</font>
|
||
|
</b></font>
|
||
|
</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p>
|
||
|
<font face="Arial, Helvetica, sans-serif">
|
||
|
The LDP is always looking for people to assist in the
|
||
|
<A href="../manifesto.html">quest</A> for developing and
|
||
|
providing free, high quality documentation for the
|
||
|
GNU/Linux operating system.
|
||
|
</p>
|
||
|
|
||
|
<p>
|
||
|
Potential volunteers should become familiar with the information
|
||
|
contained in the
|
||
|
<A href="../LDP/LDP-Author-Guide/index.html">LDP Author Guide</A>
|
||
|
(formerly known as the "<i>HOWTO-HOWTO</i>").
|
||
|
They should also consider joining the general LDP discussion
|
||
|
list (<a href="mailto:discuss-subscribe@en.tldp.org.NOSPAM">discuss@en.tldp.org</a>).
|
||
|
Let us know what your skill set is, what you would like to
|
||
|
help the LDP with, etc. We are <i>always</i> in need of
|
||
|
volunteers!
|
||
|
</p>
|
||
|
|
||
|
|
||
|
<!-- tasks -->
|
||
|
|
||
|
<P><BR></P>
|
||
|
<table width="100%" border="0" cellspacing="2" cellpadding="2">
|
||
|
<tr align="left" valign="top">
|
||
|
<td width="99%" bgcolor="#BBCCEE" height="2">
|
||
|
<a name="tasks"></a>
|
||
|
<font face="Arial, Helvetica, sans-serif"><b>
|
||
|
<font color="#000000">Tasks</font>
|
||
|
</b></font>
|
||
|
</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p>
|
||
|
If you wish to volunteer to assist in the document authoring process,
|
||
|
here are some tasks that require attention:
|
||
|
<p>
|
||
|
<ul>
|
||
|
<li><p>Work on a <b><a href="inprogress.html">technical or language
|
||
|
review</a></b> of a new or existing document.</p></li>
|
||
|
|
||
|
<li><p>
|
||
|
Provide <b><a href="inprogress.html#markup">markup assistance</a></b> for
|
||
|
various documents.
|
||
|
</p>
|
||
|
</li>
|
||
|
<li><p>
|
||
|
Become an owner for these (currently)
|
||
|
<b><a href="unmaint.html">unmaintained documents</a></b>.
|
||
|
</p>
|
||
|
</li>
|
||
|
<li><p>
|
||
|
Write a new HOWTO, FAQ or Guide. Here is a list of
|
||
|
documents that are
|
||
|
"<b><a href="inprogress.html">in progress</a></b>".
|
||
|
</p>
|
||
|
</li>
|
||
|
<li><p>
|
||
|
You can also <b><a href="suggest.html">suggest a document</a></b> (one
|
||
|
that needs to be written, or included from some other source) that
|
||
|
you believe should be part of the LDP collection.
|
||
|
</ul>
|
||
|
|
||
|
|
||
|
<!-- resources -->
|
||
|
|
||
|
<P><BR></P>
|
||
|
<table width="100%" border="0" cellspacing="2" cellpadding="2">
|
||
|
<tr align="left" valign="top">
|
||
|
<td width="99%" bgcolor="#BBCCEE" height="2">
|
||
|
<a name="resources"></a>
|
||
|
<font face="Arial, Helvetica, sans-serif"><b>
|
||
|
<font color="#000000">Resources</font>
|
||
|
</b></font>
|
||
|
</td>
|
||
|
</tr>
|
||
|
</table>
|
||
|
|
||
|
<p>
|
||
|
<ul>
|
||
|
<li><p>
|
||
|
First and foremost, consult the
|
||
|
<A href="../LDP/LDP-Author-Guide/index.html"><b>LDP Authoring Guide</b></A>
|
||
|
(formerly known as the "<i>HOWTO-HOWTO</i>").
|
||
|
For additional guidelines on <i>style</i>, examine the
|
||
|
<A href="http://developer.gnome.org/documents/style-guide/"><b>GNOME
|
||
|
Documentation Style Guide</b></a>.
|
||
|
Documents related to <b>DocBook</b> can be
|
||
|
accessed <a href="#dbref">below</a>.
|
||
|
</p></li>
|
||
|
|
||
|
<li><p>
|
||
|
<strong>Flowcharts</strong> (in PDF) that outline various
|
||
|
TLDP processes:
|
||
|
<p><ul>
|
||
|
<li><A href="pubprocess.pdf"><b>TLDP Review and Publishing Process</b></A>
|
||
|
<li><A href="maint.pdf"><b>TLDP Document Maintenance Process</b></A>
|
||
|
</ul></p>
|
||
|
</li>
|
||
|
|
||
|
<li><p>
|
||
|
<A href="../manifesto.html"><b>License / manifesto</b></A> and
|
||
|
<A href="../mailinfo.html"><b>mailing list(s)</b></A>.
|
||
|
</p></li>
|
||
|
|
||
|
<li><p><b>DTDs</b>:
|
||
|
<p>
|
||
|
The LDP accepts documents marked-up in:<br><br>
|
||
|
<b>Linuxdoc SGML; DocBook SGML v4.2, v4.1 or v3.x; and DocBook XML v4.2 or v4.1.2</b>
|
||
|
</p>
|
||
|
<p>
|
||
|
Copies of these DTDs are available here <i>(local LDP copies in zip format)</i>:
|
||
|
<p><ul>
|
||
|
<li><A href="tools/docbkx42.zip"><b>DocBook XML v4.2</b></A>
|
||
|
<li><A href="tools/docbkx412.zip"><b>DocBook XML v4.1.2</b></A>
|
||
|
<li><A href="tools/docbk42.zip"><b>DocBook SGML v4.2</b></A>
|
||
|
<li><A href="tools/docbk41.zip"><b>DocBook SGML v4.1</b></A>
|
||
|
<li><A href="tools/docbk31.zip"><b>DocBook SGML v3.1</b></A>
|
||
|
</ul></p>
|
||
|
</p>
|
||
|
<p>
|
||
|
They can also be found on <A href="http://www.oasis-open.org/docbook/">official
|
||
|
DocBook Homepage</a> (<i>http://www.oasis-open.org/docbook/</i>).
|
||
|
</p>
|
||
|
</p>
|
||
|
</li>
|
||
|
|
||
|
<li><p><b>Authoring Templates</b>:
|
||
|
<P><UL>
|
||
|
<li>DocBook <A href="template/big-howto-template.sgml">SGML source</A>
|
||
|
(<i>also shown as processed
|
||
|
<A href="template/index.html">HTML</A></i>). </li>
|
||
|
<li>DocBook <A href="template/Sample-HOWTO.xml">XML source</A>
|
||
|
(<i>also shown as processed
|
||
|
<A href="template/Sample-HOWTO.html">HTML</A></i>). </li>
|
||
|
<li>Linuxdoc <A href="template-ld/big-howto-template-ld.sgml">SGML source</A>
|
||
|
(<i>also shown as processed
|
||
|
<A href="template-ld/big-howto-template-ld.html">HTML</A></i>). </li>
|
||
|
<li>Linuxdoc <A href="template-ld/small-howto-template-ld.sgml">SGML source</A>
|
||
|
(<i>minimal template for smaller HOWTOs; also shown as processed
|
||
|
<A href="template-ld/small-howto-template-ld.html">HTML</A></i>). </li>
|
||
|
<li><a href="http://www.nyx.net/~sgjoen/The_LDP_HOWTO_Generator_ng.html">TLDP
|
||
|
HOWTO Generator</a> created by <i>Stein Gjoen</i> provides a set of fill-in
|
||
|
forms which in turn generate a customized Linuxdoc SGML template. </li>
|
||
|
</UL>
|
||
|
</P>
|
||
|
</p>
|
||
|
</li>
|
||
|
|
||
|
<li><p><b>DSSSL (stylesheets)</b>:
|
||
|
<p>The standard
|
||
|
<A href="http://docbook.sourceforge.net/projects/dsssl/"><b>DocBook DSSSL
|
||
|
Stylesheets</b></a> and
|
||
|
the <A href="tools/ldp.dsl"><b>LDP customized stylesheet</b></a> (ldp.dsl).
|
||
|
<i>Updated 2005-05-10</i>.
|
||
|
</p>
|
||
|
</li>
|
||
|
|
||
|
<li><p><b>XSL (stylesheets)</b>:
|
||
|
<p>The standard
|
||
|
<A href="http://docbook.sourceforge.net/projects/xsl/index.html"><b>DocBook
|
||
|
XSL Stylesheets</b></a>, and a set of
|
||
|
<A href="http://www.happy-monkey.net/docbook/"><b>LDP customized XSL stylesheets</b></a>.
|
||
|
Contact <a href="mailto:dhorton@NOSPAM.speakeasy.net">David Horton</a> if you
|
||
|
have questions or comments on the customized stylesheets.
|
||
|
<i>Updated 2004-09-10</i>.
|
||
|
</p>
|
||
|
</li>
|
||
|
|
||
|
<li><p><b>Entity files</b>:
|
||
|
<p>Local LDP copy (<a href="tools/entities.tar.gz">gzipped tar file</a>).
|
||
|
</p>
|
||
|
</li>
|
||
|
|
||
|
|
||
|
<li><a name="dbref"></a><p><b>DocBook Reference Material</b>:
|
||
|
<p>
|
||
|
<UL>
|
||
|
<li><A href="http://docbook.org/tdg/en/html/docbook.html"><b>DocBook: The
|
||
|
Definitive Guide</b></a>, by <i>Norman Walsh</i> and <i>Leonard Muellner</i>.
|
||
|
<br/>Another copy (PDF) is available <a href="http://www.karakas-online.de/downloads/docbook-the-definitive-guide-2.0.6.pdf">here</a> (<i>courtesy of Chris Karakas, <a href="http://www.karakas-online.de" target=
|
||
|
_new">www.karakas-online.de</a></i>).
|
||
|
</li>
|
||
|
<li><A href="http://docbook.org/tdg/en/html/quickref.html"><b>DocBook
|
||
|
Quick Reference</b></a> (4.1.2, 3.1, etc.)</li>
|
||
|
<li><A href="../HOWTO/DocBook-Demystification-HOWTO/"><b>DocBook
|
||
|
Demystification HOWTO</b></A>, by <i>Eric Raymond</i>. </li>
|
||
|
<li><A href="../HOWTO/DocBook-OpenJade-SGML-XML-HOWTO/"><b>DocBook
|
||
|
XML/SGML Processing Using OpenJade</b></A>, by <i>Saqib Ali</i>. </li>
|
||
|
<li><A href="../HOWTO/DocBook-Install/"><b>DocBook
|
||
|
Install mini-HOWTO</b></A>, by <i>Robert B. Easter</i>. </li>
|
||
|
<li><A href="http://hvdkooij.xs4all.nl/docs-docbook.en.cms"><b>Setup your
|
||
|
own docbook processing</b></a>, chronicled by
|
||
|
<i>Hugo van der Kooij</i>.</li>
|
||
|
<li><A href="http://docbook.godoy.homeip.net:81/"><b>Godoy's
|
||
|
DocBook SGML/XML reference page</b></a>, <i>(Jorge Godoy)</i>. </li>
|
||
|
<li><A href="http://www.docbook.org/tdg/en/html/ref-charents.html"><b>DocBook
|
||
|
Character Entity Reference</b></a>. </li>
|
||
|
<li>DocBook.org <a href="http://docbook.org/mailinglist/">mailing lists</a>. </li>
|
||
|
<li><a href="http://www.nwalsh.com/docs/tutorials/winwriters2001/">
|
||
|
<b>Introducing DocBook</b></a>, a slide show by <i>Norman Walsh</i>. </li>
|
||
|
<li><a href="http://acs40.arsdigita.com/doc/docbook-primer.html"><b>ArsDigita
|
||
|
DocBook Primer</b></a></li>
|
||
|
<li>A <a href="http://bgu.chez.tiscali.fr/doc/db4lyx/"><b>tutorial</b></a> on
|
||
|
Lyx & DocBook.</li>
|
||
|
<li>From the IBM developerWorks library:
|
||
|
"<a href="http://ibm.com/developerworks/library/l-docbk.html"><b>A gentle guide to DocBook</b></a>". </li>
|
||
|
<li><a href="http://jimweller.net/jim/dbxmlqs/"><b>DocBook XML
|
||
|
v4.1.2 Quick Start Guide</b></a> by <i>Jim Weller</i>. </li>
|
||
|
<li><a href="http://www.lodestar2.com/people/dyork/talks/2002/ols/docbook-tutorial/"><b>Single-Source Publishing with DocBook XML</b></a>
|
||
|
by <i>Dan York</i>. </li>
|
||
|
<li><a href="http://articles.linuxguru.net/view/202"><b>Docbook + Emacs</b></a>
|
||
|
an article by <i>Alejandro Imass</i>.
|
||
|
<li><a href="http://www.sagehill.net/docbookxsl/"><b>DocBook XSL: The Complete Guide</b></a>
|
||
|
by <i>Robert Stayton</i>.
|
||
|
<li><a href="http://www.snee.com/bob/sgmlfree/psgmqref.html"><b>Emacs/PSGML Quick Reference</b></a> by <i>Bob DuCharme</i> (also see
|
||
|
<a href="http://www.snee.com/bob/sgmlfree/">SGML CD: Free SGML Software and How to Use It</a>).
|
||
|
<li><a href="http://www.happy-monkey.net/docbook/gui-editor.html"><b>Writing DocBook XML With A GUI Editor</b></a>
|
||
|
by <i>David Horton</i>.
|
||
|
</UL>
|
||
|
</p>
|
||
|
</li>
|
||
|
|
||
|
<li><p><b>DocBook Environment & Processing</b>:
|
||
|
<p><ul>
|
||
|
<li>A complete set of
|
||
|
<a href="http://wiki.docbook.org/topic/DebianGnuLinuxPackages"><b>Debian
|
||
|
packages</b></a> (<i>DocBook Wiki</i>) for installation.</li>
|
||
|
<li><i>Saqib Ali's</i> DocBook XML Validator & Transformer:
|
||
|
<a href="http://validate.sf.net"><b>http://validate.sf.net</b></a>
|
||
|
</li>
|
||
|
<li><A href="http://wiki.docbook.org/topic/ConvertOtherFormatsToDocBook"><b>List
|
||
|
of resources</b></a> for converting other formats to DocBook.</li>
|
||
|
<li><A href="http://txt2docbook.sourceforge.net/"><b>Txt2DocBook</b></a>, a tool that
|
||
|
allows one to convert a ascii (README-like) file to a valid
|
||
|
DocBook XML file.</li>
|
||
|
<li><a href="http://www.eecs.umich.edu/~ppadala/projects/tidy/"><b>html2db</b></a>,
|
||
|
written by
|
||
|
<a href="mailto:ppadala@cise.ufl.edu.NOSPAM">ppadala@cise.ufl.edu</a>,
|
||
|
does a good job of converting HTML to DocBook SGML/XML.
|
||
|
</li>
|
||
|
<li>The <a href="tools/ldp_mk"><b>LDP document processing script</b></a> (<em>ldp_mk</em>), a perl script
|
||
|
that produces all variants from a single source (SGML/XML). <i>Updated 2005-10-12</i>.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</p>
|
||
|
</li>
|
||
|
|
||
|
|
||
|
|
||
|
<li><a name="linuxdoc"></a><p><b>LinuxDoc Information</b>:
|
||
|
<p>
|
||
|
<UL>
|
||
|
<li><a href="../HOWTO/Howtos-with-LinuxDoc.html"><b>Howtos-with-LinuxDoc
|
||
|
mini-HOWTO</b></a>, written by <i>David S. Lawyer</i>,
|
||
|
describes how to write HOWTOs using the simple LinuxDoc markup.
|
||
|
</li>
|
||
|
<li><a href="../HOWTO/Linuxdoc-Reference.html"><b>Linuxdoc Reference</b></a>,
|
||
|
written by <i>Uwe Böhme</i>,
|
||
|
is intended to be a reference for the SGML document type definition LinuxDoc. </li>
|
||
|
<li><a href="tools/ld2db.zip"><b>ld2db</b></a>,
|
||
|
developed by <i>Reuben Thomas</i>, is used to convert LinuxDoc SGML
|
||
|
to DocBook SGML. Be advised that the resultant filtered output should
|
||
|
be checked for accuracy. </li>
|
||
|
</UL>
|
||
|
</p>
|
||
|
</li>
|
||
|
|
||
|
|
||
|
<li><p><b>LinuxDoc Processing</b>:
|
||
|
<p>
|
||
|
<UL>
|
||
|
<li>The latest <a href="tools/linuxdoc-tools.tar.gz"><b>LinuxDoc
|
||
|
Tools</b></a> (v0.9.21; 595k). More information can be found
|
||
|
<a href="http://packages.qa.debian.org/l/linuxdoc-tools.html">here</a>. </li>
|
||
|
<li><a href="http://www.nyx.net/~sgjoen/The_LDP_HOWTO_Generator.html">TLDP
|
||
|
HOWTO Generator</a> created by <i>Stein Gjoen</i> provides a set of fill-in
|
||
|
forms which in turn generate a customized Linuxdoc SGML template. </li>
|
||
|
<li><i>Stein Gjoen's</i> TARPL page:
|
||
|
<a href="http://www.nyx.net/~sgjoen/tarpl.html"><b>http://www.nyx.net/~sgjoen/tarpl.html</b></a>
|
||
|
</li>
|
||
|
</UL>
|
||
|
</p>
|
||
|
</li>
|
||
|
|
||
|
<li><p><a name="pdf"></a><b>PDF/Postscript Output (ldp_print: v0.90, 2002-08-09)</b>:
|
||
|
<p>Toolset (<b>ldp_print</b>) that the LDP uses to produce PDF and PostScript
|
||
|
variants. Works on the single-HTML-file representation of
|
||
|
a DocBook SGML/XML instance - ONLY! See the README in the
|
||
|
<a href="tools/ldp_print.tgz">package</a> for details.
|
||
|
<b>ldp_print</b> relies on the
|
||
|
<a href="http://www.easysw.com/htmldoc/"><b>HTMLDOC</b></a> from
|
||
|
<a href="http://www.easysw.com/">Easy Software Products</a>.
|
||
|
</p>
|
||
|
</li>
|
||
|
|
||
|
<li><p><a name="cvs"></a><b>CVS information</b>:
|
||
|
<p>
|
||
|
<ul>
|
||
|
<li><a href="http://www.cvshome.org/"><b>cvshome.org</b></a>,
|
||
|
the Concurrent Versions System (cvs) home page. </li>
|
||
|
<li><a href="http://cvsbook.red-bean.com/"><b>Open Source Development
|
||
|
with CVS</b></a>, a book by <i>Karl Fogel</i>.
|
||
|
</li>
|
||
|
</ul>
|
||
|
</p>
|
||
|
</li>
|
||
|
|
||
|
<li><p><b>Misc</b>:
|
||
|
<p>
|
||
|
<ul>
|
||
|
<li><A href="http://www.dictionary.com/"><b>dictionary.com</b></a>. </li>
|
||
|
<li><A href="http://www.thesaurus.com/"><b>thesaurus.com</b></a>. </li>
|
||
|
<li><A href="http://www.webopedia.com/"><b>Webopedia</b></a> (online
|
||
|
dictionary and search engine for computer and Internet technology). </li>
|
||
|
</ul>
|
||
|
</p>
|
||
|
</li>
|
||
|
</ul>
|
||
|
|
||
|
<P>
|
||
|
<BR>
|
||
|
</TD></TR>
|
||
|
|
||
|
<TR BGCOLOR="#AAAAAA">
|
||
|
<TD ALIGN="center"><font face="arial,helvetica" color="#ffffff"><B>
|
||
|
<A HREF="../index.html"><font face="arial,helvetica" color="#ffffff">
|
||
|
home</font></A> |
|
||
|
<A HREF="../docs.html#howto"><font face="arial,helvetica" color="#ffffff"> HOWTOs</font></A> |
|
||
|
<A HREF="../guides.html"><font face="arial,helvetica" color="#ffffff">
|
||
|
Guides</font></A> |
|
||
|
<A HREF="../docs.html#faq"><font face="arial,helvetica" color="#ffffff">
|
||
|
FAQs</font></A> |
|
||
|
<A HREF="../docs.html#man"><font face="arial,helvetica" color="#ffffff">
|
||
|
man pages</font></A> |
|
||
|
<A HREF="../docs.html#lg"><font face="arial,helvetica" color="#ffffff">
|
||
|
Linux Gazette</font></A> |
|
||
|
<A HREF="../docs.html#lf"><font face="arial,helvetica" color="#ffffff">
|
||
|
LinuxFocus</font></A>
|
||
|
</B></font></TD>
|
||
|
</TR>
|
||
|
|
||
|
<TR BGCOLOR="#AAAAAA">
|
||
|
<TD ALIGN="center"><font face="arial,helvetica" size="-1">
|
||
|
Last Modified: 2010-11-22 |
|
||
|
<a href="mailto:feedback@en.tldp.org.NOSPAM">feedback@en.tldp.org</a></font></TD>
|
||
|
</TR>
|
||
|
</TABLE>
|
||
|
|
||
|
</BODY>
|
||
|
</HTML>
|
||
|
|