The Linux Documentation Project: Authors - Contribute / Help home | HOWTOs | Guides | FAQs | man pages | Linux Gazette | LinuxFocus Linux Documentation Project: Authors - Contribute / Help Getting Started The LDP is always looking for people to assist in the quest for developing and providing free, high quality documentation for the GNU/Linux operating system.Potential volunteers should become familiar with the information contained in the LDP Author Guide (formerly known as the " HOWTO-HOWTO "). They should also consider joining the general LDP discussion list ( discuss@en.tldp.org ). Let us know what your skill set is, what you would like to help the LDP with, etc. We are always in need of volunteers!Tasks If you wish to volunteer to assist in the document authoring process, here are some tasks that require attention:Work on a technical or language review of a new or existing document. Provide markup assistance for various documents.Become an owner for these (currently)unmaintained documents .Write a new HOWTO, FAQ or Guide. Here is a list ofdocuments that are " in progress ".You can also suggest a document (onethat needs to be written, or included from some other source) thatyou believe should be part of the LDP collection.Resources First and foremost, consult the LDP Authoring Guide (formerly known as the " HOWTO-HOWTO "). For additional guidelines on style , examine the GNOME Documentation Style Guide . Documents related to DocBook can be accessed below .Flowcharts (in PDF) that outline variousTLDP processes:TLDP Review and Publishing Process TLDP Document Maintenance Process License / manifesto andmailing list(s) .DTDs : The LDP accepts documents marked-up in: Linuxdoc SGML; DocBook SGML v4.2, v4.1 or v3.x; and DocBook XML v4.2 or v4.1.2 Copies of these DTDs are available here (local LDP copies in zip format) :DocBook XML v4.2 DocBook XML v4.1.2 DocBook SGML v4.2 DocBook SGML v4.1 DocBook SGML v3.1 They can also be found on official DocBook Homepage ( http://www.oasis-open.org/docbook/ ).Authoring Templates :DocBook SGML source ( also shown as processedHTML ). DocBook XML source ( also shown as processedHTML ). Linuxdoc SGML source ( also shown as processedHTML ). Linuxdoc SGML source ( minimal template for smaller HOWTOs; also shown as processedHTML ). TLDPHOWTO Generator created by Stein Gjoen provides a set of fill-in forms which in turn generate a customized Linuxdoc SGML template. DSSSL (stylesheets) :The standardDocBook DSSSLStylesheets and the LDP customized stylesheet (ldp.dsl).Updated 2005-05-10 .XSL (stylesheets) :The standardDocBookXSL Stylesheets , and a set ofLDP customized XSL stylesheets .Contact David Horton if youhave questions or comments on the customized stylesheets.Updated 2004-09-10 .Entity files :Local LDP copy ( gzipped tar file ).DocBook Reference Material :DocBook: TheDefinitive Guide , by Norman Walsh and Leonard Muellner .Another copy (PDF) is available here ( courtesy of Chris Karakas, www.karakas-online.de ).DocBookQuick Reference (4.1.2, 3.1, etc.) DocBookDemystification HOWTO , by Eric Raymond . DocBookXML/SGML Processing Using OpenJade , by Saqib Ali . DocBook Install mini-HOWTO , by Robert B. Easter . Setup your own docbook processing , chronicled by Hugo van der Kooij . Godoy'sDocBook SGML/XML reference page , (Jorge Godoy) . DocBookCharacter Entity Reference . DocBook.org mailing lists . Introducing DocBook , a slide show by Norman Walsh . ArsDigita DocBook Primer A tutorial onLyx & DocBook. From the IBM developerWorks library: " A gentle guide to DocBook ". DocBook XML v4.1.2 Quick Start Guide by Jim Weller . Single-Source Publishing with DocBook XML by Dan York . Docbook + Emacs an article by Alejandro Imass .DocBook XSL: The Complete Guide by Robert Stayton .Emacs/PSGML Quick Reference by Bob DuCharme (also see SGML CD: Free SGML Software and How to Use It ).Writing DocBook XML With A GUI Editor by David Horton .DocBook Environment & Processing :A complete set ofDebianpackages ( DocBook Wiki ) for installation. Saqib Ali's DocBook XML Validator & Transformer: http://validate.sf.net Listof resources for converting other formats to DocBook. Txt2DocBook , a tool thatallows one to convert a ascii (README-like) file to a validDocBook XML file. html2db ,written by ppadala@cise.ufl.edu ,does a good job of converting HTML to DocBook SGML/XML.The LDP document processing script ( ldp_mk ), a perl scriptthat produces all variants from a single source (SGML/XML). Updated 2005-10-12 .LinuxDoc Information :Howtos-with-LinuxDoc mini-HOWTO , written by David S. Lawyer ,describes how to write HOWTOs using the simple LinuxDoc markup.Linuxdoc Reference ,written by Uwe Bhme ,is intended to be a reference for the SGML document type definition LinuxDoc. ld2db ,developed by Reuben Thomas , is used to convert LinuxDoc SGMLto DocBook SGML. Be advised that the resultant filtered output shouldbe checked for accuracy. LinuxDoc Processing :The latest LinuxDoc Tools (v0.9.21; 595k). More information can be found here . TLDPHOWTO Generator created by Stein Gjoen provides a set of fill-in forms which in turn generate a customized Linuxdoc SGML template. Stein Gjoen's TARPL page: http://www.nyx.net/~sgjoen/tarpl.html PDF/Postscript Output (ldp_print: v0.90, 2002-08-09) :Toolset ( ldp_print ) that the LDP uses to produce PDF and PostScriptvariants. Works on the single-HTML-file representation ofa DocBook SGML/XML instance - ONLY! See the README in thepackage for details.ldp_print relies on the HTMLDOC fromEasy Software Products .CVS information :cvshome.org ,the Concurrent Versions System (cvs) home page. Open Source Development with CVS , a book by Karl Fogel .Misc :dictionary.com . thesaurus.com . Webopedia (online dictionary and search engine for computer and Internet technology). home | HOWTOs | Guides | FAQs | man pages | Linux Gazette | LinuxFocus Last Modified: 2010-11-22 | feedback@en.tldp.org