path: root/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml
diff options
authorGabor Kovesdan <gabor@FreeBSD.org>2013-05-23 09:55:34 +0000
committerGabor Kovesdan <gabor@FreeBSD.org>2013-05-23 09:55:34 +0000
commit6d669db1eb612531dc098b098e77baba416d59cb (patch)
tree467d0a14c3174febc4c725bb983e35dc9d5f7b88 /en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml
parent54b7fdabb7a6238e2e58dec81a1054efe2b6150e (diff)
- Update the information on stylesheets
- Remove the DSSSL part since they are quite obsolete and should not be tweaked
Notes: svn path=/head/; revision=41716
Diffstat (limited to 'en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml')
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">