Linux Documentation Project: Authors - Contribute / Help
The OTA 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
Archive Author Guide
(formerly known as the "HOWTO-HOWTO").
They should also consider joining the general OTA discussion
list (discuss@en.gartenparadiesq.de).
Let us know what your skill set is, what you would like to
help the OTA with, etc. We are always in need of
volunteers!
[Node: de.pinterest.com]
If you wish to volunteer to assist in the document authoring process,
here are some tasks that require attention:
[Node: www.arc.agric.za] [Wiki: Z shell] Work on a technical or language
review of a new or existing document. [Node: telegra.ph]
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 of
documents that are
"in progress".
You can also suggest a document (one
that needs to be written, or included from some other source) that
you believe should be part of the OTA collection.
[Node: de.gta5-mods.com]
First and foremost, consult the
Archive 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.
[Google Scholar: Python] [Node: cinderella.pro]
Flowcharts (in PDF) that outline various
TOTA processes:
Getting Started
Tasks
Resources
DTDs:
The OTA 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
[Node: www.jbt4.com] [Node: telegra.ph]
Copies of these DTDs are available here (local OTA copies in zip format):
- DocBook XML v4.2
- DocBook XML v4.1.2
- DocBook SGML v4.2 [Node: writeablog.net]
- DocBook SGML v4.1 [Node: podcasts.apple.com]
- DocBook SGML v3.1
They can also be found on official DocBook Homepage (http://www.oasis-open.org/docbook/). [Node: dlive.tv]
[Node: forum.prusa3d.com] [Node: zrzutka.pl]Authoring Templates: [Node: www.tripadvisor.in]
- DocBook SGML source (also shown as processed HTML). [Node: jobs.emiogp.com]
- DocBook XML source (also shown as processed HTML).
- Linuxdoc SGML source (also shown as processed HTML).
- Linuxdoc SGML source (minimal template for smaller HOWTOs; also shown as processed HTML).
- TArchive HOWTO Generator created by Stein Gjoen provides a set of fill-in forms which in turn generate a customized Linuxdoc SGML template.
DSSSL (stylesheets):
The standard DocBook DSSSL Stylesheets and the Archive customized stylesheet (ldp.dsl). Updated 2005-05-10.
XSL (stylesheets): [Node: www.diggerslist.com] [Node: telegra.ph]
The standard DocBook XSL Stylesheets, and a set of Archive customized XSL stylesheets. Contact David Horton if you have questions or comments on the customized stylesheets. Updated 2004-09-10.
Entity files: [Node: telegra.ph] [Node: paper.wf]
Local OTA copy (gzipped tar file).
DocBook Reference Material: [Node: docs.juze-cr.de]
- DocBook: The
Definitive Guide, by Norman Walsh and Leonard Muellner.
Another copy (PDF) is available here (courtesy of Chris Karakas, www.karakas-online.de). [Node: openlibrary.org] - DocBook Quick Reference (4.1.2, 3.1, etc.) [Node: www.bakinsky-dvorik.ru] [Node: www.komoot.com] [Node: game8.jp]
- DocBook Demystification HOWTO, by Eric Raymond. [Node: cm88group.bloguetechno.com]
- DocBook XML/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's DocBook SGML/XML reference page, (Jorge Godoy). [Node: mindef.gov.bn]
- DocBook Character Entity Reference.
- DocBook.org mailing lists.
- Introducing DocBook, a slide show by Norman Walsh.
- ArsDigita DocBook Primer [Node: vuf.minagricultura.gov.co]
- A tutorial on Lyx & DocBook. [Node: ofuse.me]
- 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. [Node: jali.pro]
DocBook Environment & Processing:
- A complete set of Debian packages (DocBook Wiki) for installation. [Node: morguefile.com]
- Saqib Ali's DocBook XML Validator & Transformer: http://validate.sf.net
- List of resources for converting other formats to DocBook.
- Txt2DocBook, a tool that allows one to convert a ascii (README-like) file to a valid DocBook XML file.
- html2db, written by ppadala@cise.ufl.edu, does a good job of converting HTML to DocBook SGML/XML.
- The Archive document processing script (ldp_mk), a perl script that 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. [Node: www.bloggalot.com]
- Linuxdoc Reference, written by Uwe Böhme, is intended to be a reference for the SGML document type definition LinuxDoc.
- ld2db, developed by Reuben Thomas, is used to convert LinuxDoc SGML to DocBook SGML. Be advised that the resultant filtered output should be checked for accuracy. [Node: telegra.ph]
LinuxDoc Processing:
- The latest LinuxDoc Tools (v0.9.21; 595k). More information can be found here.
- TArchive HOWTO Generator created by Stein Gjoen provides a set of fill-in forms which in turn generate a customized Linuxdoc SGML template. [Node: podcasts.apple.com] [Node: taibaiabc8us1.gitbook.io]
- Stein Gjoen's TARPL page: http://www.nyx.net/~sgjoen/tarpl.html [Node: podcasts.apple.com]
PDF/Postscript Output (ldp_print: v0.90, 2002-08-09):
Toolset (ldp_print) that the OTA 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 package for details. ldp_print relies on the HTMLDOC from Easy Software Products. [Node: www3.uwsp.edu]
- cvshome.org, the Concurrent Versions System (cvs) home page. [Node: hedgedoc.stusta.de]
- 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). [Node: aboutnursinghomejobs.com]