os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- Update the information on stylesheets

Browse source 
- Remove the DSSSL part since they are quite obsolete and should not be
  tweaked
This commit is contained in:
Gabor Kovesdan 2013-05-23 09:55:34 +00:00
parent 54b7fdabb7
commit 6d669db1eb
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=41716
1 changed files with 8 additions and 28 deletions

36
en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml
View file

@ -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>