Re: [Firebird-docs] Things to improve

[Paul V. <pa...@vi...>]

Hi all,

>> - Internal links to elements at chapter/article level or above
>> don't work.
>
> This is solved in the new version of the DocBook stylesheets.

> The new stylesheets also fix a problem I mentioned in the Docwriting
> Howto: non-monospaced <literallayout> was badly rendered (as fully
> justified lines, or worse).

> I'm planning to commit the new stylesheets to CVS in a couple of
> days.

OK, done. I also updated our own driver stylesheet fo.xsl, a) to
bypass some minor drawbacks of the new DocBook stylesheets, and
b) to give non-graphical admonitions a colored background (based on
Carlos' solution).

I'm also planning to upgrade to a newer version of Apache FOP (it
produces smaller PDF files and fixes at least one bug in our current
version), and examining if it's worthwhile upgrading Saxon and/or
the DocBook core files.

If all this sounds like Chinese:

- DocBook core files: contain the DocBook Document Type Definition.
  The latest stable version (4.3) has some additions we could use
  (though nothing really spectacular).

- DocBook stylesheets: lots of XSL files containing templates for
  the conversion of our DocBook XML source docs to HTML, XHTML,
  FO, etc...

- Saxon: an XSLT processor, that reads our DocBook XML sources and
  produces HTML, XHTML, FO etc... according to the transformation
  rules in the abovementioned stylesheets.

- FO: Formatting Objects. An intermediate format from which PDF,
  RTF, PostScript etc. can be produced.

- Apache FOP: a Formatting Objects Processor. It reads a FO file
  and produces PDF (and more if we want it to).


Greetings,
Paul Vinkenoog