From owner-svn-doc-head@FreeBSD.ORG Thu May 23 09:55:34 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 D9F8AAF1; Thu, 23 May 2013 09:55:34 +0000 (UTC) (envelope-from gabor@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 B26FA165; Thu, 23 May 2013 09:55:34 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.6/8.14.6) with ESMTP id r4N9tYMa040050; Thu, 23 May 2013 09:55:34 GMT (envelope-from gabor@svn.freebsd.org) Received: (from gabor@localhost) by svn.freebsd.org (8.14.6/8.14.5/Submit) id r4N9tYJn040049; Thu, 23 May 2013 09:55:34 GMT (envelope-from gabor@svn.freebsd.org) Message-Id: <201305230955.r4N9tYJn040049@svn.freebsd.org> From: Gabor Kovesdan Date: Thu, 23 May 2013 09:55:34 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r41716 - head/en_US.ISO8859-1/books/fdp-primer/stylesheets 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: Thu, 23 May 2013 09:55:34 -0000 Author: gabor Date: Thu May 23 09:55:34 2013 New Revision: 41716 URL: http://svnweb.freebsd.org/changeset/doc/41716 Log: - Update the information on stylesheets - Remove the DSSSL part since they are quite obsolete and should not be tweaked Modified: head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml Thu May 23 09:50:47 2013 (r41715) +++ head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml Thu May 23 09:55:34 2013 (r41716) @@ -32,37 +32,17 @@ --> - * Stylesheets + Stylesheets - SGML says nothing about how a document should be displayed to + XML says nothing about how a document should be displayed to the user, or rendered on paper. To do that, various languages - have been developed to describe stylesheets, including DynaText, - Panorama, SPICE, JSSS, FOSI, CSS, and DSSSL. + have been developed to describe stylesheets, including XSLT, XSL FO + or CSS. - For DocBook, we are using stylesheets written in DSSSL. For - XHTML we are using CSS. - - - * DSSSL - - The Documentation Project uses a slightly customized version - of Norm Walsh's modular DocBook stylesheets. - - These can be found in textproc/dsssl-docbook-modular. - - The modified stylesheets are not in the ports system. - Instead they are part of the Documentation Project source - repository, and can be found in - doc/share/xml/freebsd.dsl. It is well - commented, and pending completion of this section you are - encouraged to examine that file to see how some of the available - options in the standard stylesheets have been configured in - order to customize the output for the FreeBSD Documentation - Project. That file also contains examples showing how to extend - the elements that the stylesheet understands, which is how the - FreeBSD specific elements have been formatted. - + We use XSLT stylesheets to transform DocBook into XHTML and then + we apply CSS formatting to XHTML pages. Currently, the printable + output is rendered with legacy DSSSL stylesheets but this may + probably change in the future. CSS