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.
[Node: management.ju.edu.jo]
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!
If you wish to volunteer to assist in the document authoring process,
here are some tasks that require attention:
[Node: wiki.0-24.jp] Work on a technical or language
review of a new or existing document.
Provide markup assistance for
various documents.
[Node: telegra.ph]
Become an owner for these (currently)
unmaintained documents.
[Node: md.cm-ss13.com]
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: podcasts.apple.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.
Flowcharts (in PDF) that outline various
TOTA processes:
[Symfony Definition] [Node: podcasts.apple.com] [Node: mx.pinterest.com] [VPN History]
Getting Started
Tasks
Resources
[Node: telegra.ph] [Node: www.arc.agric.za]
[Node: telegra.ph]
License / manifesto and mailing list(s).
[Academic results for JWT]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: ro.enrollbusiness.com]
Copies of these DTDs are available here (local OTA copies in zip format):
- DocBook XML v4.2 [Node: telegra.ph] [Node: www.band.us]
- 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:
[Node: www.horticulturaljobs.com] [Wiki: Go programming language]
- DocBook SGML source (also shown as processed HTML). [Node: www.arc.agric.za]
- DocBook XML source (also shown as processed HTML).
- Linuxdoc SGML source (also shown as processed HTML). [Node: management.ju.edu.jo]
- Linuxdoc SGML source (minimal template for smaller HOWTOs; also shown as processed HTML). [Node: blogfreely.net]
- 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: share.evernote.com]
DSSSL (stylesheets):
The standard DocBook DSSSL Stylesheets and the Archive customized stylesheet (ldp.dsl). Updated 2005-05-10. [Node: telegra.ph]
[Node: postheaven.net] [Node: jump.5ch.net]XSL (stylesheets):
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:
Local OTA copy (gzipped tar file). [Node: paper.wf]
DocBook Reference Material:
- 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: management.ju.edu.jo] - DocBook Quick Reference (4.1.2, 3.1, etc.)
- DocBook Demystification HOWTO, by Eric Raymond.
- 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. [Academic results for PHP]
- Godoy's DocBook SGML/XML reference page, (Jorge Godoy).
- DocBook Character Entity Reference.
- DocBook.org mailing lists. [Node: buckeyescoop.com] [Reference: Spring Framework]
- Introducing DocBook, a slide show by Norman Walsh. [Node: hedgedoc.dezentrale.space]
- ArsDigita DocBook Primer [Node: podcasts.apple.com] [Node: cinderella.pro] [Node: hedgedoc.digillab.uni-augsburg.de]
- A tutorial on Lyx & DocBook.
- From the IBM developerWorks library: "A gentle guide to DocBook". [Node: likeminds.fun]
- DocBook XML v4.1.2 Quick Start Guide by Jim Weller.
- Single-Source Publishing with DocBook XML by Dan York. [Node: forums.gamersbillofrights.com]
- Docbook + Emacs an article by Alejandro Imass. [Node: www.pearltrees.com]
- DocBook XSL: The Complete Guide by Robert Stayton. [Node: my.enrollbusiness.com]
- Emacs/PSGML Quick Reference by Bob DuCharme (also see SGML CD: Free SGML Software and How to Use It). [Node: my.enrollbusiness.com]
- Writing DocBook XML With A GUI Editor by David Horton.
DocBook Environment & Processing:
- A complete set of Debian packages (DocBook Wiki) for installation.
- 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. [Node: bem88u.webflow.io]
LinuxDoc Information: [Node: ml007.k12.sd.us]
- Howtos-with-LinuxDoc mini-HOWTO, written by David S. Lawyer, describes how to write HOWTOs using the simple LinuxDoc markup. [Node: portfolium.com]
- Linuxdoc Reference, written by Uwe Böhme, is intended to be a reference for the SGML document type definition LinuxDoc. [Node: www.kadenze.com]
- 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: indiasocialbook.in] [Google Scholar: Unity game engine]
LinuxDoc Processing: [Node: telegra.ph]
- 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: www.codementor.io]
- Stein Gjoen's TARPL page: http://www.nyx.net/~sgjoen/tarpl.html [Node: ml007.k12.sd.us]
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.
[Wiki: Arch Linux] [Node: userstyles.world]
- cvshome.org, the Concurrent Versions System (cvs) home page. [Node: addons.mozilla.org]
- Open Source Development with CVS, a book by Karl Fogel.
Misc: [Node: faithlife.com]
- dictionary.com.
- thesaurus.com.
- Webopedia (online dictionary and search engine for computer and Internet technology).