svn commit: r922455 - /qpid/trunk/qpid/doc/book/README.txt

[jo...@apache.org]

Author: jonathan
Date: Fri Mar 12 23:35:36 2010
New Revision: 922455

URL: http://svn.apache.org/viewvc?rev=922455&view=rev
Log:
Information on building and editing the documentation source.

Added:
    qpid/trunk/qpid/doc/book/README.txt

Added: qpid/trunk/qpid/doc/book/README.txt
URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/README.txt?rev=922455&view=auto
==============================================================================
--- qpid/trunk/qpid/doc/book/README.txt (added)
+++ qpid/trunk/qpid/doc/book/README.txt Fri Mar 12 23:35:36 2010
@@ -0,0 +1,50 @@
+The documentation in this directory is written in DocBook 4.5. The
+original content was taken from the Apache Qpid Wiki. 
+
+1. Getting DocBook
+
+Docbook is documented here: 
+http://docbook.org/tdg/
+
+The Docbook DTDs and schemas are here:
+http://www.docbook.org/schemas/
+
+Stylesheets for creating PDF, HTML, and various other formats are here: 
+http://sourceforge.net/projects/docbook/files/
+
+DocBook packages exist for some Linux systems. For instance, on my
+Fedora 11 system, I have installed these RPMs:
+
+  docbook-dtds-0:1.0-47.fc11.noarch
+  docbook-simple-0:1.1-5.fc11.noarch
+  docbook-style-xsl-0:1.75.2-1.fc11.noarch
+  
+
+2. Editing Tools
+
+For Emacs, I like nxml-mode, especially if you learn how to use tag
+completion, outlining, etc.  This is described in some detail in
+http://www.dpawson.co.uk/relaxng/nxml/info.html.
+
+For vi, the macros described in this Linux Journal article may be
+helpful: http://www.linuxjournal.com/article/7737.
+
+Commercial XML editors provide good support for DocBook. On Windows, I
+like Stylus Studio (http://www.stylusstudio.com/). On Linux, I like
+Oxygen (http://www.oxygenxml.com/).
+
+Here's a page on authoring tools for DocBook:
+http://wiki.docbook.org/topic/DocBookAuthoringTools
+
+
+3. Building the Documentation
+
+I have checked in a shell script, build.sh, which builds a PDF. It
+will soon be replaced by an ANT file.
+
+In addition to DocBook, you need the following software:
+
+- An XInclude processor. The shell script uses xmllint.
+- An XSLT processor. The shell script uses xsltproc.
+- An XSL:FO processor. The shell script uses Apache FOP (fop-0.95-3.noarch on Fedora).
+  



---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project:      http://qpid.apache.org
Use/Interact: mailto:commits-subscribe@qpid.apache.org