Date: Sun, 21 Jul 2013 04:30:31 +0000 (UTC) From: Warren Block <wblock@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42337 - head/en_US.ISO8859-1/books/fdp-primer/stylesheets Message-ID: <201307210430.r6L4UV7T067486@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: wblock Date: Sun Jul 21 04:30:31 2013 New Revision: 42337 URL: http://svnweb.freebsd.org/changeset/doc/42337 Log: Update and expand the stylesheet chapter. Modified: head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml Modified: head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml Sun Jul 21 01:36:45 2013 (r42336) +++ head/en_US.ISO8859-1/books/fdp-primer/stylesheets/chapter.xml Sun Jul 21 04:30:31 2013 (r42337) @@ -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>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><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>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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201307210430.r6L4UV7T067486>