From fc4ef794223f9189d3007a1c5a94ec50d71ef605 Mon Sep 17 00:00:00 2001
From: Gabor Pali The Documentation Project has been behind with the used
- standards until recently when we switched to a real XML toolchain
- and DocBook 4.5. However, we still depend on obsoleted
+ The Documentation Project has been using old versions of markup
+ standards until recently when we switched to a real XML
+ toolchain and DocBook 4.5. However, we still depend on obsolete
technologies — DSSSL and Jade. Besides, DocBook 5.0
- provides a cleaner markup and some nice new features.
The objective of this project is to upgrade the documentation set to DocBook 5.0 and to find a way to properly render our - sources without using DSSSL since the DSSSL stylesheets are + sources without using DSSSL, since the DSSSL stylesheets are discontinued and cannot render DocBook 5.0. The documentation sources have already been successfully transformed to DocBook - 5.0 and the development of the rendering process is under + 5.0 and updates to the rendering process are under development. The common opinion among &os; developers is that Java is a heavy dependency that should be avoided. This has suggested the transformation of DocBook sources to TeX and use TeX as a rendering backend. There are two ways to do this; the sources can be transformed either directly or through the XSL FO - output generated by the stylesheets that the DocBook Project - provides. The latter approach has been chosen as a preferred + output generated by the stylesheets provided for the DocBook Project. + The latter approach has been chosen as a preferred way since it better fits the existing documentation infrastructure and provides easier customization.
-This project is generously founded by The &os; Foundation.
+This project is generously funded by The &os; Foundation.