aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml
blob: 0d4153c004e4106298968faf21ad46a83fc94feb (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!-- 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
    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/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 XHTML document without abusing XHTML 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 XHTML files.
	The project-wide CSS file is copied from
	<filename>doc/share/misc/docbook.css</filename> when documents
	are converted to XHTML, and is installed automatically.</para>
    </sect2>
  </sect1>
</chapter>