- Rename .sgml files to .xml

- Reflect the rename in referencing files

Approved by:	doceng (implicit)

1 files changed, 86 insertions, 0 deletions

diff --git a/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml b/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml
new file mode 100644
index 0000000000..0d4153c004
--- /dev/null
+++ b/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml
@@ -0,0 +1,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>