diff options
author | Warren Block <wblock@FreeBSD.org> | 2012-05-21 14:25:02 +0000 |
---|---|---|
committer | Warren Block <wblock@FreeBSD.org> | 2012-05-21 14:25:02 +0000 |
commit | 3f961c7d1d265cb02ebb9b234db8133569c1f0d3 (patch) | |
tree | 8bd413414c5a64342ef23f3d86ddbaa09ae06e7f /en_US.ISO8859-1 | |
parent | 3e5623c655d903c2d84c0f173f46af8399fb580e (diff) | |
download | doc-3f961c7d1d265cb02ebb9b234db8133569c1f0d3.tar.gz doc-3f961c7d1d265cb02ebb9b234db8133569c1f0d3.zip |
Whitespace-only commits, wrap long lines and remove whitespace from
blank lines. Translators, please ignore.
Notes
Notes:
svn path=/head/; revision=38869
Diffstat (limited to 'en_US.ISO8859-1')
-rw-r--r-- | en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml | 67 |
1 files changed, 35 insertions, 32 deletions
diff --git a/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml b/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml index 8b8ba4b461..74cc6b9631 100644 --- a/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml +++ b/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml @@ -32,50 +32,53 @@ <chapter id="stylesheets"> <title>* Stylesheets</title> - - <para>SGML 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> - - <para>For DocBook, we are using stylesheets written in DSSSL. For HTML we - are using CSS.</para> + + <para>SGML 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> + + <para>For DocBook, we are using stylesheets written in DSSSL. For + HTML 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/sgml/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> + + <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/sgml/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> <sect1 id="stylesheets-css"> <title>CSS</title> - <para>Cascading Stylesheets (CSS) are a mechanism for attaching style - information (font, weight, size, color, and so forth) to elements in an - HTML document without abusing HTML to do so.</para> + <para>Cascading Stylesheets (CSS) are a mechanism for attaching + style information (font, weight, size, color, and so forth) to + elements in an HTML document without abusing HTML to do + so.</para> <sect2> <title>The DocBook Documents</title> - <para>The FreeBSD DSSSL stylesheets include a reference to a stylesheet, - <filename>docbook.css</filename>, which is expected to appear in the - same directory as the HTML files. The project-wide CSS file is copied - from <filename>doc/share/misc/docbook.css</filename> when documents + <para>The FreeBSD DSSSL stylesheets include a reference to a + stylesheet, <filename>docbook.css</filename>, which is + expected to appear in the same directory as the HTML files. + The project-wide CSS file is copied from + <filename>doc/share/misc/docbook.css</filename> when documents are converted to HTML, and is installed automatically.</para> </sect2> </sect1> |