- Fixes in the Q2 DocBook entry
Submitted by: bjk, wblock
This commit is contained in:
parent
e0d40d0885
commit
fc4ef79422
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=42122
1 changed files with 9 additions and 9 deletions
|
@ -425,29 +425,29 @@
|
|||
</contact>
|
||||
|
||||
<body>
|
||||
<p>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
|
||||
<p>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.</p>
|
||||
provides cleaner markup and some nice new features.</p>
|
||||
|
||||
<p>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.</p>
|
||||
|
||||
<p>This project is generously founded by The &os; Foundation.</p>
|
||||
<p>This project is generously funded by The &os; Foundation.</p>
|
||||
</body>
|
||||
|
||||
<help>
|
||||
|
|
Loading…
Reference in a new issue