os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Add entry on DocBook 5 transition

Browse source 
Submitted by:	gabor
This commit is contained in:
Gabor Pali 2013-07-02 14:41:23 +00:00
parent b09fcf35cc
commit a7d36203e9
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=42117
1 changed files with 56 additions and 1 deletions

57
en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml
View file

@ -18,7 +18,7 @@
<!-- XXX: keep updating the number of entries -->
<p>Thanks to all the reporters for the excellent work! This report
contains 8 entries and we hope you enjoy reading it.</p>
contains 9 entries and we hope you enjoy reading it.</p>
<!-- XXX: set date for the next set of submissions -->
<p>The deadline for submissions covering between July and September 2013
@ -61,6 +61,12 @@
<description>Ports</description>
</category>
<category>
<name>docs</name>
<description>Documentation</description>
</category>
<project cat='proj'>
<title>PC-BSD</title>
@ -404,4 +410,53 @@
<task>Remove the dependency on HAL.</task>
</help>
</project>
<project cat='docs'>
<title>Upgrading the Documentation Set to DocBook 5.0</title>
<contact>
<person>
<name>
<given>G&aacute;bor</given>
<common>K&ouml;vesd&aacute;n</common>
</name>
<email>gabor@FreeBSD.org</email>
</person>
</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
technologies &mdash; DSSSL and Jade. Besides, DocBook 5.0
provides a 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
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
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
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>
</body>
<help>
<task>Finish the implementation of the rendering process.</task>
<task>Integrate the rendering solution into the
infrastructure.</task>
<task>Merge back changes to <tt>head</tt>.</task>
</help>
</project>
</report>