Date: Thu, 23 May 2013 09:55:34 +0000 (UTC) From: Gabor Kovesdan <gabor@FreeBSD.org> 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 Message-ID: <201305230955.r4N9tYJn040049@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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 @@ --> <chapter id="stylesheets"> - <title>* Stylesheets</title> + <title>Stylesheets</title> - <para>SGML says nothing about how a document should be displayed to + <para>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.</para> + have been developed to describe stylesheets, including XSLT, XSL FO + or CSS.</para> - <para>For DocBook, we are using stylesheets written in DSSSL. For - XHTML we are using CSS.</para> - - <sect1 id="stylesheets-dsssl"> - <title>* DSSSL</title> - - <para>The Documentation Project uses a slightly customized version - of Norm Walsh's modular DocBook stylesheets.</para> - - <para>These can be found in <filename - role="package">textproc/dsssl-docbook-modular</filename>.</para> - - <para>The modified stylesheets are not in the ports system. - Instead they are part of the Documentation Project source - repository, and can be found in - <filename>doc/share/xml/freebsd.dsl</filename>. 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.</para> - </sect1> + <para>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.</para> <sect1 id="stylesheets-css"> <title>CSS</title>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201305230955.r4N9tYJn040049>