From owner-svn-doc-head@FreeBSD.ORG Sun Jul 21 04:30:32 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 17722FE7; Sun, 21 Jul 2013 04:30:32 +0000 (UTC) (envelope-from wblock@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id E26961B7; Sun, 21 Jul 2013 04:30:31 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r6L4UVNC067487; Sun, 21 Jul 2013 04:30:31 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r6L4UV7T067486; Sun, 21 Jul 2013 04:30:31 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201307210430.r6L4UV7T067486@svn.freebsd.org> From: Warren Block Date: Sun, 21 Jul 2013 04:30:31 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 21 Jul 2013 04:30:32 -0000 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 @@ --> - Stylesheets + Style Sheets - 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. - - 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 + XML is concerned with content, and says nothing about how that content should be presented to + the reader or rendered on paper. Multiple style sheet languages + have been developed to describe visual layout, including Extensible Stylesheet Language Transformation (XSLT), Document Style Semantics and Specification Language (DSSSL), + and Cascading Style Sheets (CSS). + + The FDP documents use XSLT stylesheets to transform DocBook into XHTML, and then + CSS formatting is applied to the XHTML pages. Printable + output is currently rendered with legacy DSSSL stylesheets, but this will probably change in the future. - CSS + <acronym>CSS</acronym> - Cascading Stylesheets (CSS) are a mechanism for attaching + Cascading Style Sheets (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 + elements in an XHTML document without abusing XHTML to do so. The DocBook Documents - The FreeBSD DSSSL stylesheets include a reference to a - stylesheet, docbook.css, which is - expected to appear in the same directory as the XHTML files. - The project-wide CSS file is copied from + The &os; XSLT and DSSSL stylesheets refer to + docbook.css, which is + expected to be present in the same directory as the XHTML files. + The project-wide CSS file is copied from doc/share/misc/docbook.css when documents - are converted to XHTML, and is installed automatically. + are converted to XHTML, and is installed automatically.