[OPEN-ILS-DOCUMENTATION] DocBook 5.0 super-quick HOWTO

[George Duimovich]

Thanks Dan.

I checked it out and only had minor problems with some xsl tranforms. I have
a somewhat dated version of XMLSpy on my Windows desktop and it worked well
enough to transform the samples with ease (open file > assign XSL...).  I
haven't looked recently to see what open source XML editors are available
for the Windows environment, but I know folks around here have used XMLSpy &
Oxygen Editor (the later has some reasonable academic/non-profit pricing).

The only minor problem I had was my editor defaulted to IE for parsing in
"browser" / view mode, so a few of stylesheets I tried choked with IE
(probably fixable with some tweaks to the browser options, etc.).

George Duimovich
NRCan Library / Bibliothèque RNCan

On Mon, Dec 8, 2008 at 2:28 PM, Dan Scott <denials at gmail.com> wrote:

> I've been playing a little bit with DocBook 5 XML and using XInclude
> to compose a document from multiple files, and committed changes to
> the sample documents at
> http://svn.open-ils.org/trac/ILS/browser/trunk/docs/ to demonstrate
> that experiment.
>
> To try it out yourself:
>
> 1. Download the "docbook-xsl-ns" stylesheets from
> http://sourceforge.net/project/showfiles.php?group_id=21935#files
> 2. Download the sample files from
> http://svn.open-ils.org/trac/ILS/browser/trunk/docs/
> 3. Use the xsltproc utility (part of the xsltproc package on Debian
> and Ubuntu) to process the document using your preferred stylesheet;
> in my case, the stylesheets have been unzipped into
> /home/dan/docbook-xsl-ns-1.74.0 directory. You have to pass the
> --xinclude parameter to force xsltproc to include XInclude'd files; on
> my system, the command to process the whole sample manual is as
> follows:
>
> xsltproc --xinclude /home/dan/docbook-xsl-ns-1.74.0/xhtml/onechunk.xsl
> index.xml
>
> (This automatically generates a single HTML file named "index.html").
>
> If you are using Windows, installing an XSLT processor is
> unfortunately not a simple process. The Cygwin utilities
> (http://www.cygwin.com) offer a freely downloadable compiled version
> of xsltproc, but the install and use process is a bit painful. There
> are also various Java-based tools that are available, but that seem to
> require annoying amounts of environment variables to be set to get
> things working properly.
>
> --
> Dan Scott
> Laurentian University
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://list.georgialibraries.org/pipermail/open-ils-documentation/attachments/20090116/c404933f/attachment.htm