From owner-svn-doc-head@FreeBSD.ORG Tue Jul 2 14:41:24 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 3E8264A0; Tue, 2 Jul 2013 14:41:24 +0000 (UTC) (envelope-from pgj@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 20E321140; Tue, 2 Jul 2013 14:41:24 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r62EfOYi068697; Tue, 2 Jul 2013 14:41:24 GMT (envelope-from pgj@svn.freebsd.org) Received: (from pgj@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r62EfNOi068696; Tue, 2 Jul 2013 14:41:23 GMT (envelope-from pgj@svn.freebsd.org) Message-Id: <201307021441.r62EfNOi068696@svn.freebsd.org> From: Gabor Pali Date: Tue, 2 Jul 2013 14:41:23 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 02 Jul 2013 14:41:24 -0000 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 @@

Thanks to all the reporters for the excellent work! This report - contains 8 entries and we hope you enjoy reading it.

+ contains 9 entries and we hope you enjoy reading it.

The deadline for submissions covering between July and September 2013 @@ -61,6 +61,12 @@ Ports + + docs + + Documentation + + PC-BSD @@ -404,4 +410,53 @@ Remove the dependency on HAL. + + + Upgrading the Documentation Set to DocBook 5.0 + + + + + Gábor + Kövesdán + + gabor@FreeBSD.org + + + + +

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.

+ +

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.

+ +

This project is generously founded by The &os; Foundation.

+ + + + Finish the implementation of the rendering process. + + Integrate the rendering solution into the + infrastructure. + + Merge back changes to head. + +