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

[Karen Schneider]

Great stuff, all!

Regarding this statement: "If you are using Windows, installing an XSLT
processor is
unfortunately not a simple process." I am new to Docbook, however, I spoke
with some people today on the Docbook IRC channel who confirmed that there
are several Windows XML editors that do facilitate this. XXE (XMLMind
Editor) is one of them, Oxygen is another, and Syntext Serna is one more.
There is a fuller list of Windows XML editors on the Docbook project page:

http://wiki.docbook.org/topic/DocBookAuthoringTools?highlight=(authoring)

I've tried XXE and Oxygen and plan to look at Syntext Serna. (So far Oxygen
wins.) Obviously, I'm not a specialist like Dan or George so I'm speaking
from a very slim margin of experience, but *at least according to my
conversations this morning to Docbook-knowledgable people who are working in
such an environment,* being on Windows is not a deterrent.

Karen G. Schneider
Equinox Community Librarian

On Fri, Jan 16, 2009 at 9:48 AM, Dan Scott <denials at gmail.com> wrote:

> 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
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation
>



-- 
-- 
| Karen G. Schneider
| Community Librarian
| Equinox Software Inc. "The Evergreen Experts"
| Toll-free: 1.877.Open.ILS (1.877.673.6457) x712
| E-Mail/AIM: kgs at esilibrary.com
| Web: http://www.esilibrary.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://list.georgialibraries.org/pipermail/open-ils-documentation/attachments/20090116/58de2451/attachment-0001.htm