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

[Dan Scott]

Thanks for the feedback, George!

I should point out the shiny new Windows addition to the Wiki page on
setting up DocBook transforms from the command line
(http://open-ils.org/dokuwiki/doku.php?id=documentation:setting_up_docbook_transforms)
- but that pointer comes with a caveat.

Betty Ing, the Conifer documentation intern, reported running into
some DLL dependency problems with the instructions as they are
currently written; on a clean Windows system, one might need to
download all of the DLLs in the directory instead of just the two that
I indicated. I suspect that my test Windows system was contaminated
with versions of the required DLLs that had been installed by other
software packages. We'll update the instructions once we've worked out
all of the required steps... sigh.

Dan

2009/1/16 George Duimovich <gparser at gmail.com>:
> 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
>
>
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
>
>



-- 
Dan Scott
Laurentian University