[Docutils-checkins] r3857 - in trunk/docutils: FAQ.txt docs/user/tools.txt

[<go...@us...>]

Author: goodger
Date: 2005-09-08 06:49:59 +0200 (Thu, 08 Sep 2005)
New Revision: 3857

Modified:
   trunk/docutils/FAQ.txt
   trunk/docutils/docs/user/tools.txt
Log:
clarified stylesheet requirement

Modified: trunk/docutils/FAQ.txt
===================================================================
--- trunk/docutils/FAQ.txt	2005-09-07 22:27:20 UTC (rev 3856)
+++ trunk/docutils/FAQ.txt	2005-09-08 04:49:59 UTC (rev 3857)
@@ -710,7 +710,7 @@
 ----------------------------------
 
 It produces XHTML compatible with the `XHTML 1.0`_ specification.  A
-cascading style sheet (provided as "tools/stylesheets/default.css") is
+cascading stylesheet (provided as "tools/stylesheets/default.css") is
 required for proper viewing with a modern graphical browser.  Correct
 rendering of the HTML produced depends on the CSS support of the
 browser.
@@ -795,8 +795,8 @@
 
 HTML is being used for dumb formatting for nothing but final display.
 A stylesheet *is required*, and one is provided:
-tools/stylesheets/default.css.  Of course, you're welcome to roll your
-own.  The default stylesheet provides rules to format ``<h1
+``tools/stylesheets/default.css``.  Of course, you're welcome to roll
+your own.  The default stylesheet provides rules to format ``<h1
 class="title">`` and ``<h2 class="subtitle">`` differently from
 ordinary ``<h1>`` and ``<h2>``::
 

Modified: trunk/docutils/docs/user/tools.txt
===================================================================
--- trunk/docutils/docs/user/tools.txt	2005-09-07 22:27:20 UTC (rev 3856)
+++ trunk/docutils/docs/user/tools.txt	2005-09-08 04:49:59 UTC (rev 3857)
@@ -99,16 +99,20 @@
 
 The ``rst2html.py`` front end reads standalone reStructuredText source
 files and produces HTML 4 (XHTML 1) output compatible with modern
-browsers.  For example, to process a reStructuredText file
-"``test.txt``" into HTML::
+browsers that support cascading stylesheets (CSS).  A stylesheet is
+required for proper rendering; an example is provided in
+``tools/stylesheets/default.css`` (see Stylesheets_ below).
 
-    rst2html.py test.txt test.html
+For example, to process a reStructuredText file "``test.txt``" into
+HTML::
 
+    rst2html.py --stylesheet=mystyles.css test.txt test.html
+
 Now open the "``test.html``" file in your favorite browser to see the
 results.  To get a footer with a link to the source file, date & time
 of processing, and links to the Docutils projects, add some options::
 
-    rst2html.py -stg test.txt test.html
+    rst2html.py --stylesheet=mystyles.css -stg test.txt test.html
 
 
 Stylesheets