Date: Tue, 2 Jul 2013 14:41:23 +0000 (UTC) From: Gabor Pali <pgj@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42117 - head/en_US.ISO8859-1/htdocs/news/status Message-ID: <201307021441.r62EfNOi068696@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: pgj Date: Tue Jul 2 14:41:23 2013 New Revision: 42117 URL: http://svnweb.freebsd.org/changeset/doc/42117 Log: - Add entry on DocBook 5 transition Submitted by: gabor Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml ============================================================================== --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 2 13:55:18 2013 (r42116) +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 2 14:41:23 2013 (r42117) @@ -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ábor</given> + <common>Kövesdá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 — 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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201307021441.r62EfNOi068696>