diff options
author | Gabor Kovesdan <gabor@FreeBSD.org> | 2013-05-23 09:55:34 +0000 |
---|---|---|
committer | Gabor Kovesdan <gabor@FreeBSD.org> | 2013-05-23 09:55:34 +0000 |
commit | 6d669db1eb612531dc098b098e77baba416d59cb (patch) | |
tree | 467d0a14c3174febc4c725bb983e35dc9d5f7b88 /en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml | |
parent | 54b7fdabb7a6238e2e58dec81a1054efe2b6150e (diff) | |
download | doc-6d669db1eb612531dc098b098e77baba416d59cb.tar.gz doc-6d669db1eb612531dc098b098e77baba416d59cb.zip |
- Update the information on stylesheets
- Remove the DSSSL part since they are quite obsolete and should not be
tweaked
Notes
Notes:
svn path=/head/; revision=41716
Diffstat (limited to 'en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml')
-rw-r--r-- | en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml | 36 |
1 files changed, 8 insertions, 28 deletions
diff --git a/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml b/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml index bfdbca8f4e..27e37e1370 100644 --- a/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml +++ b/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml @@ -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> |