DocBook manuals (was Re: [TriLUG] Network file system.)

[Mike Mueller]

On Tuesday 27 August 2002 08:01, Ben Simpson wrote:
<snip>
> I am writing it on a linux machine and would like to know what document
> format most people use? (other than .doc)  Kword? Abiword?
<snip>

DocBook.

It requires more work to produce at first but that work pays off in the long 
run because it solves the distribution problems.  It also means that your 
work has more value because the source is in an open self-describing format.  
Since your are writing for people in a technology transition, the ability to 
output an HTML product allows your targeted users to easily use the same 
document in both the proprietary and open environments.

Here is a list of DocBook links from my Konqueror bookmarks.xml.  They are 
loosely ordered by frequency of my use.  You can include the following lines 
in your $HOME/.kde/share/apps/konqueror/bookmarks.xml file. :

   <folder folded="no" >
    <title>DocBook</title>
    <bookmark icon="www" href="http://www.docbook.org" >
     <title>DocBook.org</title>
    </bookmark>
    <bookmark icon="favicons/www.oasis-open.org" 
href="http://www.oasis-open.org/docbook/documentation/reference/html/docbook.html" 
>
     <title>DocBook - Guide</title>
    </bookmark>
    <bookmark icon="www" 
href="http://www-106.ibm.com/developerworks/library/l-docbk.html#h5" >
     <title>A gentle guide to DocBook</title>
    </bookmark>
    <bookmark icon="www" 
href="http://www.tldp.org/HOWTO/DocBook-OpenJade-SGML-XML-HOWTO/index.html" >
     <title>HOWTO DocBook XML/SGML Processing Using OpenJade</title>
    </bookmark>
    <bookmark icon="www" 
href="http://www.tldp.org/LDP/LDP-Author-Guide/index.html" >
     <title>HOWTO LDP Author Guide</title>
    </bookmark>
    <bookmark icon="www" href="http://docbook.sourceforge.net/" >
     <title>Welcome to the DocBook Open Repository</title>
    </bookmark>
    <bookmark icon="www" 
href="http://docbook.org/wiki/moin.cgi/DocBookDocumentation" >
     <title>DocBookDocumentation - DocBook Wiki</title>
    </bookmark>
    <bookmark icon="www" 
href="http://newbiedoc.sourceforge.net/metadoc/docbook-guide.en.html" >
     <title>NewbieDoc Docbook Guide</title>
    </bookmark>
    <bookmark icon="www" 
href="http://tldp.org/archives/ldp-docbook/msg00107.html" >
     <title>Callout images</title>
    </bookmark>
    <bookmark icon="favicons/old.lwn.net" 
href="http://old.lwn.net/2000/features/DocBook/" >
     <title>Exploring SGML DocBook</title>
    </bookmark>
    <bookmark icon="www" href="http://people.freebsd.org/%7Enik/sgmlxml.gif" >
     <title>Process Flow Diagram</title>
    </bookmark>
    <bookmark icon="www" 
href="http://nis-www.lanl.gov/%7Erosalia/mydocs/docbook-intro/docbook-intro.html" 
>
     <title>Get Going With DocBook</title>
    </bookmark>
    <bookmark icon="www" href="http://people.redhat.com/twaugh/" >
     <title>My home page</title>
    </bookmark>
    <bookmark icon="www" href="http://www.krysalis.org/centipede/" >
     <title>Krysalis Centipede</title>
    </bookmark>
    <bookmark icon="favicons/www.oasis-open.org" 
href="http://www.oasis-open.org/committees/entity/spec-2001-08-06.html" >
     <title>XML Catalogs</title>
    </bookmark>
    <bookmark icon="favicons/wwws.sun.com" 
href="http://wwws.sun.com/software/xml/developers/resolver/" >
     <title>XML Entity and URI Resolvers</title>
    </bookmark>
    <bookmark icon="favicons/xml.apache.org" 
href="http://xml.apache.org/dist/commons/" >
     <title>xml-commons README homepage</title>
    </bookmark>
    <bookmark icon="www" href="http://docbook.sourceforge.net/projects/xsl/" >
     <title>DocBook XSL Stylesheets</title>
    </bookmark>
    <bookmark icon="www" href="http://docbook.org/wiki/moin.cgi/FrontPage" >
     <title>FrontPage - DocBook Wiki</title>
    </bookmark>
    <bookmark icon="favicons/www.oasis-open.org" 
href="http://www.oasis-open.org/docbook/" >
     <title>DocBook Technical Committee</title>
    </bookmark>
    <bookmark icon="favicons/www.cbbrowne.com" 
href="http://www.cbbrowne.com/info/sgmldtds.html" >
     <title>Some Notable DTDs</title>
    </bookmark>
    <bookmark icon="www" 
href="http://www.trilug.org/pipermail/trilug/Week-of-Mon-20020624/thread.html#8627" 
>
     <title>The TriLUG Week-of-Mon-20020624 Archive by Thread</title>
    </bookmark>
    <bookmark icon="www" href="http://www.sgmltools.org" >
     <title>SGMLtools project</title>
    </bookmark>
   </folder>


-- 
mueller, mike

The larger purpose of the economic order, including Wall Street, is to 
support the material conditions for human existence, not to undermine and 
destabilize them.

-Editorial, The Nation, August 19, 2002