Tina Ji, Karen Collier, Jeremy Buhler
The proof of concept below was superseded by Sitka's published Evergreen documentation, available under a Creative Commons license in HTML and PDF:
For more information about Sitka's DocBook including a zip file with source xml see the following messages to the OPEN-ILS-DOCUMENTATION list:
Jeremy Buhler - July 6, 2010
Note: the links below are no longer active
This mock-up Evergreen manual is a sample and proof of concept for the Evergreen Documentation Interest Group (DIG). It is adapted from existing Sitka documentation and an Evergreen glossary. Author and copyright information is not accurate and serves only to illustrate DocBook elements and formatting.
The XML files were written in XMLmind and oXygen XML Editor. Transforms to HTML and PDF were done with the oXygen XML Editor using the Saxon6.5.5 transformer.
The proof of concept consists of 6 XML files linked from the root file
xi:include. The file tree mirrors the document structure - the
cat directory corresponds to the Cataloguing Part, with one XML file for each section.
Media folders contain linked images and screenshots.
To allow for multilingual versions this structure is repeated in parallel directories, one for each English (
en) and French (
fr). In the French version the text is not translated but
xml:lang is set to
fr so that headings and links are rendered correctly during the transform. A separate set of stamped images is also used to distinguish the French version.
Below is the source file structure as viewed in the oXygen XML Editor.
A .zip of the source files (XML and media, 2.7Mb) is available for download.
The oXygen XML Editor was used to generate HTML and PDF output using the Saxon6.5.5 transformer with the DocBook - HTML Chunk and DocBook PDF transformation scenarios. To customize output the following two parameters were changed from the defaults in the DocBook HTML - Chunk scenario:
sitka.cssfile (for the styled version) the
html.stylesheetparameter was set to
imagedatatags have the attribute
scale="60"which scales images to 60% their actual size, required only for PDF output. To preserve full image size for HTML output the boolean parameter
ignore.image.scalingwas set to
We used a wide range of DocBook elements to illustrate how they render in HTML and PDF transforms. Elements such as
<bibliosource> are not rendered by default even though they appear in the XML. A list of DocBook elements used in this proof of concept is available for download.
Links to the
sitka.css stylesheet were added to HTML output using the
html.stylesheet transformation parameter. This sample stylesheet is available here.