Re: [Phpwebsite-developers] Build Proceedure for the XML Manual Files

[Mike N. <mh...@us...>]

On Sun, 2004-03-14 at 16:54, Greg Morgan wrote:
> Here's what I have done so far 
> http://kissalice.sourceforge.net/phpmanual/output/set1.html.  It has all 
> my rough ideas in rough rough form.  I cleaned up the CVS section today. 
>   I have added an "Installation, Upgrade, and Maintenance" and fleshed 
> out the "Developer's Guide".  Essentially, I have cobble many of my 
> phpWS forum responses together.  I've started to manipulate them into a 
> manual.  I think Ray O. on the LEAF list said that's one way to help. 
> Watch what is happening in the mailing lists/forums and try and solve 
> those problems. LOL, I've created a few of my own with docbook.

Greg,
Nice work. :-)

> In the http://kissalice.sourceforge.net/phpmanual/ directory are two 
> files.  00readme.txt explains what I had to do to get this working on 
> Redhat's fedora core 1.  That file says, "
> jw -f docbook -b html -o output manual.xml
> 
> docbook2html manual.xml

That is a jade wrapper script. It's not recommended for DocBook XML. You
should be using xsltproc or saxon with the DocBook XSL Stylesheets.

> While working on this book, I had to change all instances of
> "http://docbook.org/xml/4.2/docbookx.dtd" to
> "/usr/share/sgml/docbook/sgml-dtd-4.2-1.0-22.1/docbook.dtd"
> on Fedora Core 1."

Your catalog files in /etc/xml aren't setup properly. See:

        Catalog support
        http://xmlsoft.org/catalog.html

> The jw with -o to output placed all the html files in the output 
> directory.  makemanual.sh is the jw command in a shell script.
> 
> I don't understand why the official manuals look like this
<snip>

This is a result of the xslt engine (jade) you used. Auto-generated
chapter numbers are different for the DSSSL stylesheets.

> Any solutions and feedback would be appreciated.

Take a look at these resources:

        DocBookXSL: The Complete Guide
        http://www.sagehill.net/docbookxsl/
        
        DocBookXSLStylesheet Documentation
        http://docbook.sourceforge.net/release/xsl/current/doc/
        
        DocBook Wiki
        http://www.docbook.org/wiki/moin.cgi/
        
        Docbook Frequently Asked Questions
        http://www.dpawson.co.uk/
        
Also, take a look at the XXE DocBook editor.

        XMLmind XML Editor
        http://www.xmlmind.com/xmleditor/

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs