aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml
diff options
context:
space:
mode:
authorWarren Block <wblock@FreeBSD.org>2013-07-21 04:30:31 +0000
committerWarren Block <wblock@FreeBSD.org>2013-07-21 04:30:31 +0000
commit72a3b45f6321c8bbb1eea40e6e9954bce765f3b8 (patch)
tree58d848a9d7237f30cbf3e74cdc6c68e5f0d9e99c /en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml
parent118449562a15d74f4293d3f684605e29465689d7 (diff)
downloaddoc-72a3b45f6321c8bbb1eea40e6e9954bce765f3b8.tar.gz
doc-72a3b45f6321c8bbb1eea40e6e9954bce765f3b8.zip
Update and expand the stylesheet chapter.
Notes
Notes: svn path=/head/; revision=42337
Diffstat (limited to 'en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml')
-rw-r--r--en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml32
1 files changed, 16 insertions, 16 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
index 27e37e1370..820d9963e6 100644
--- a/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml
+++ b/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml
@@ -32,35 +32,35 @@
-->
<chapter id="stylesheets">
- <title>Stylesheets</title>
+ <title>Style Sheets</title>
- <para>XML 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 XSLT, XSL FO
- or CSS.</para>
+ <para><acronym>XML</acronym> is concerned with content, and says nothing about how that content should be presented to
+ the reader or rendered on paper. Multiple <emphasis>style sheet</emphasis> languages
+ have been developed to describe visual layout, including Extensible Stylesheet Language Transformation (<acronym>XSLT</acronym>), Document Style Semantics and Specification Language (<acronym>DSSSL</acronym>),
+ and Cascading Style Sheets (<acronym>CSS</acronym>).</para>
- <para>We use XSLT stylesheets to transform DocBook into XHTML and then
- we apply CSS formatting to XHTML pages. Currently, the printable
- output is rendered with legacy DSSSL stylesheets but this may
+ <para>The <acronym>FDP</acronym> documents use <acronym>XSLT</acronym> stylesheets to transform DocBook into <acronym>XHTML</acronym>, and then
+ <acronym>CSS</acronym> formatting is applied to the <acronym>XHTML</acronym> pages. Printable
+ output is currently rendered with legacy <acronym>DSSSL</acronym> stylesheets, but this will
probably change in the future.</para>
<sect1 id="stylesheets-css">
- <title>CSS</title>
+ <title><acronym>CSS</acronym></title>
- <para>Cascading Stylesheets (CSS) are a mechanism for attaching
+ <para>Cascading Style Sheets (<acronym>CSS</acronym>) 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
+ elements in an <acronym>XHTML</acronym> document without abusing <acronym>XHTML</acronym> 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
+ <para>The &os; <acronym>XSLT</acronym> and <acronym>DSSSL</acronym> stylesheets refer to
+ <filename>docbook.css</filename>, which is
+ expected to be present in the same directory as the <acronym>XHTML</acronym> files.
+ The project-wide <acronym>CSS</acronym> file is copied from
<filename>doc/share/misc/docbook.css</filename> when documents
- are converted to XHTML, and is installed automatically.</para>
+ are converted to <acronym>XHTML</acronym>, and is installed automatically.</para>
</sect2>
</sect1>
</chapter>