diff options
Diffstat (limited to 'en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml')
| -rw-r--r-- | en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml | 102 |
1 files changed, 0 insertions, 102 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 deleted file mode 100644 index 3b7626e5df..0000000000 --- a/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.sgml +++ /dev/null @@ -1,102 +0,0 @@ -<!-- Copyright (c) 1998, 1999 Nik Clayton, All rights reserved. - - Redistribution and use in source (SGML DocBook) and 'compiled' forms - (SGML HTML, PDF, PostScript, RTF and so forth) with or without - modification, are permitted provided that the following conditions - are met: - - 1. Redistributions of source code (SGML DocBook) must retain the above - copyright notice, this list of conditions and the following - disclaimer as the first lines of this file unmodified. - - 2. Redistributions in compiled form (transformed to other DTDs, - converted to PDF, PostScript, RTF and other formats) must reproduce - the above copyright notice, this list of conditions and the - following disclaimer in the documentation and/or other materials - provided with the distribution. - - THIS DOCUMENTATION IS PROVIDED BY NIK CLAYTON "AS IS" AND ANY EXPRESS OR - IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES - OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE - DISCLAIMED. IN NO EVENT SHALL NIK CLAYTON BE LIABLE FOR ANY DIRECT, - INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES - (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR - SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) - HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, - STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN - ANY WAY OUT OF THE USE OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE - POSSIBILITY OF SUCH DAMAGE. - - $FreeBSD$ ---> - -<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> - - <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> - </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> - - <sect2> - <title>The Web site (HTML documents)</title> - - <para>The FreeBSD web site does not currently use CSS. Unfortunately, - the look and feel is constructed using abuses of HTML of varying - degrees. This should be fixed, and would be a good project for - someone looking to contribute to the documentation project.</para> - </sect2> - - <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 - are converted to HTML, and is installed automatically.</para> - </sect2> - </sect1> -</chapter> - -<!-- - Local Variables: - mode: sgml - sgml-declaration: "../chapter.decl" - sgml-indent-data: t - sgml-omittag: nil - sgml-always-quote-attributes: t - sgml-parent-document: ("../book.sgml" "part" "chapter") - End: ---> |