...

1. Peri worked with Jeff to add the documents to SVN. See Developing Rice DocBook Documentation
   (Kuali OLE follows followed Rice and is currently using the DocBook 5 format for documentation and the docbkx-maven plugin to generate the documentation as part of our maven build.)
   The difference between OLE and Rice documentation is that OLE has decided to use Webhelp output for our documentation whereas Rice uses only HTML.  See the plugin documentation here: http://docbkx-tools.sourceforge.net/docbkx-maven-plugin/plugin-info.html.

2. Needed to change the image file references to ../images/filename.png and reference files to ../html/linkname (for html)
   Example:

   Code Block
   <link xlink:href="../html/releaseNotes.html">HTML</link> <link xlink:href="../pdf/releaseNotes.pdf">PDF</link>

   For webhelp, when linking FROM the index page (which follows the html format), links appear the same way

   Code Block
   <link xlink:href="../webhelp/ADMIN/index.html">Webhelp</link>

   However IF you are inserting a link from webhelp back to the index page or to another webhelp space, format is

   Code Block
   <link xlink:href="../../../html/Index.html"> <link xlink:href="../../../webhelp/BASICS/index.html">OLE Basic Functionality and Key Concepts</link>

3. Separated out the chapters into individual xml files and pasted the docbook document type declaration in the chapter element:

   Code Block
   <chapter xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="en-US">

4. Created an index page

...

Peri had to do some modifications to get the webhelp to show display correctly.  We had to modify images and tables to get them to display correctly.  Webhelp pages are now linked with OLE.

See the plugin documentation: http://docbkx-tools.sourceforge.net/docbkx-maven-plugin/plugin-info.html

DocBook Notes

I typically use the GUI (author mode) of oXygen to modify DocBook and I display full tags with attributes when I am editing (so that I do not accidentally put text or tags in the wrong location).

The structure for OLE

...