Documentation Components

From GnuCash
Revision as of 01:34, 12 August 2017 by Fell (talk | contribs) (Supported Output formats: cosmetics)
Jump to: navigation, search

The Docbook based Gnucash documentation makes use of several components to produce the different output forms. See also the README file.

Supported Output formats

Our primary target is the context sensitive help F1 for the program. It's format is OS dependent:

  • Docbook for Gnome's Yelp
  • HTML
    • plain for MacOs's browser
    • compiled for Windows help viewer.

Additional supported are for offline reading:

  • PDF
  • Mobi
  • ePub

Source file templates

Current Source files have a marker

<!--
      (Do not remove this comment block.)
  Template Maintained by the GNOME Documentation Project:
	  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Feb 12, 2002
-->

Fell (talk) considers replacement by Gnome Doc Utils.

Processing

XML

The processing is done by Extensible Stylesheet Language Transformations (XSLT), where xsltproc applies on the elements of the source XML file the instructions of the respective XSL file.

For that reason the repository contains in the xsl directory a copy of docbook-xsl, currently 2017 in version 1.75.2.

After you installed it locally, you should have its reference documentation under file:///usr/share/doc/packages/docbook-xsl-stylesheets/html/index.html. For the HowTo see Bob Stayton's DocBook XSL: The Complete Guide.

OMF

Our omf.make has in its header
#	This file was taken from scrollkeeper_example2, a package illustrating
#	how to install documentation and OMF files for use with ScrollKeeper
#	0.3.x and 0.4.x.  For more information, see:
#		http://scrollkeeper.sourceforge.net/	
# 	Version: 0.1.2 (last updated: March 20, 2002)

Alternatives to docbook-xslt

by yelp

Yelp offers its own tools and stylesheets [1], which are significant smaller: file:///usr/share/yelp-xsl/xslt.

yelp-build can process

  • from: Mallard, DocBook, man, info, and HTML documents
  • to: HTML, EPUB, ...

It might be useful to run sometimes yelp-check to verify the compatibility.

by GDU

is based on the usually make and has his own xslts, too: file:///usr/share/xml/gnome/xslt