<!-- 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 customised 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 customise 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:
-->
