Index: head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml =================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml (revision 41715) +++ head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml (revision 41716) @@ -1,86 +1,66 @@ - * 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 Cascading Stylesheets (CSS) are a mechanism for attaching style information (font, weight, size, color, and so forth) to elements in an XHTML document without abusing XHTML to do so. The DocBook Documents The FreeBSD DSSSL stylesheets include a reference to a stylesheet, docbook.css, which is expected to appear in the same directory as the XHTML files. The project-wide CSS file is copied from doc/share/misc/docbook.css when documents are converted to XHTML, and is installed automatically.