[OPEN-ILS-DOCUMENTATION] ***SPAM*** Re: DocBook questions

[jeremy]

Hi Robert,

Further to Shannon's reply, a few more comments below:

> 1) Is anyone currently working on the root document for the docbook
> documentation or the stylesheet? I was thinking of starting to work on
> this, but wanted to be sure it wasn't already covered.

I don't know of anyone working on it but would be willing to help and
can share what Sitka's learned about using an xsl customization layer.

> 2) Last year SITKA sent out links to the XML files for their Evergreen
> documentation. I think this is a good starting point for  the DIG
> work. Would SITKA folks mind us copying and using their XML
> structure/files as the starting point? 

The link we sent last year was a proof of concept with very limited
content.  More recently Sitka posted a zip with DocBook xml for our
full documentation set (see Apr 8 message at
http://georgialibraries.markmail.org/message/pumtsszknka55zcu) .  The
zip is available at
http://coconut.pines.bclibrary.ca:21080/docbook/Sitka/current/sitka_docs_xml.zip and is updated to match the online html version.  Images were excluded to reduce size and because many are Sitka-specific, but we can share those as well upon request.

Everything is shared under a Creative Commons by-sa license.  If Sitka
xml structure/files can be re-purposed that would be great.

> 3)  I think  SITKA used OXygen for their XML creation. I am using
> linux tools for creating the XML and testing with a linux command line
> DocBook processor. Does anyone know if there are any issues with
> documentation being created by different tools will have issues once
> they are brought all together?. I am sure that document clean up can
> fix it. 

Sitka uses oXygen for writing/editing but generates html and pdf output
on the command line with xsltproc and fop.  I am not aware of any issues
with using different tools for writing and processing.  That said, Sitka
xml may transform differently if using DocBook stylesheets out of the
box.  For images in particular Sitka's xml is written to work with our
customization layer.  If you're interested I'd be happy to go into
detail off list.

Thanks,
Jeremy


-- 
Jeremy Buhler
Trainer/Help Desk Specialist
Sitka Evergreen Implementation
jbuhler at sitka.bclibraries.ca