diff options
| -rw-r--r-- | sandbox/code-block-directive/README.html | 55 | ||||
| -rw-r--r-- | sandbox/html4trans/README.html | 136 | ||||
| -rw-r--r-- | sandbox/html4trans/docs/usage.html | 436 |
3 files changed, 0 insertions, 627 deletions
diff --git a/sandbox/code-block-directive/README.html b/sandbox/code-block-directive/README.html deleted file mode 100644 index 28579cee9..000000000 --- a/sandbox/code-block-directive/README.html +++ /dev/null @@ -1,55 +0,0 @@ -<?xml version="1.0" encoding="iso-8859-1" ?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -<meta name="generator" content="Docutils 0.4.1: http://docutils.sourceforge.net/" /> -<title>Proposal for a code-block directive in docutils</title> -<meta name="author" content="Guenter Milde <milde@users.berlios.de>" /> -<meta name="date" content="2007-06-08" /> -<link rel="stylesheet" href="../../../../lib/python2.4/site-packages/docutils/writers/html4css1/html4css1.css" type="text/css" /> -</head> -<body> -<div class="document" id="proposal-for-a-code-block-directive-in-docutils"> -<h1 class="title">Proposal for a code-block directive in docutils</h1> -<table class="docinfo" frame="void" rules="none"> -<col class="docinfo-name" /> -<col class="docinfo-content" /> -<tbody valign="top"> -<tr><th class="docinfo-name">Author:</th> -<td>Guenter Milde <<a class="reference" href="mailto:milde@users.berlios.de">milde@users.berlios.de</a>></td></tr> -<tr><th class="docinfo-name">Date:</th> -<td>2007-06-08</td></tr> -</tbody> -</table> -<!-- -*- rst-mode -*- --> -<p>This sandbox project contains experimental code and documentation related to -the proposal for syntax highlight of source code in docutils using a -"code-block" directive.</p> -<p>See <a class="reference" href="docs/syntax-highlight.html">syntax-highlight.html</a> for the full picture.</p> -<dl class="docutils"> -<dt><a class="reference" href="pygments_code_block_directive.py">pygments_code_block_directive.py</a></dt> -<dd><p class="first">Working example: defines and registers a -code-block directive using the <a class="reference" href="http://pygments.org/">Pygments</a> syntax highlighter.</p> -<p class="last">colourful literal code (maybe outdated): -<a class="reference" href="docs/pygments_code_block_directive-bunt.py.html">pygments_code_block_directive-bunt.py.html</a></p> -</dd> -<dt><a class="reference" href="rst2html-highlight">rst2html-highlight</a></dt> -<dd>front end for reStructuredText -> HTML conversion supporting the -"code-block" directive.</dd> -<dt><a class="reference" href="docs">docs</a></dt> -<dd>Documentation, concepts, discussion, examples...</dd> -<dt><a class="reference" href="tools">tools</a></dt> -<dd>Style sheets, alternative (legacy) front ends, script for interactive -testing.</dd> -</dl> -<!-- References --> -</div> -<div class="footer"> -<hr class="footer" /> -<a class="reference" href="README.txt">View document source</a>. -Generated on: 2007-06-13. - -</div> -</body> -</html> diff --git a/sandbox/html4trans/README.html b/sandbox/html4trans/README.html deleted file mode 100644 index 7acf6ac2a..000000000 --- a/sandbox/html4trans/README.html +++ /dev/null @@ -1,136 +0,0 @@ -<?xml version="1.0" encoding="iso-8859-1" ?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -<meta name="generator" content="Docutils 0.4.1: http://docutils.sourceforge.net/" /> -<title>HTML writer for lightweight browsers</title> -<meta name="author" content="Guenter Milde <milde@users.BerliOS.de>" /> -<meta name="date" content="2007-06-13" /> -<link rel="stylesheet" href="../../../../lib/python2.4/site-packages/docutils/writers/html4css1/html4css1.css" type="text/css" /> -</head> -<body> -<div class="document" id="html-writer-for-lightweight-browsers"> -<h1 class="title">HTML writer for lightweight browsers</h1> -<table class="docinfo" frame="void" rules="none"> -<col class="docinfo-name" /> -<col class="docinfo-content" /> -<tbody valign="top"> -<tr><th class="docinfo-name">Author:</th> -<td>Guenter Milde <<a class="reference" href="mailto:milde@users.BerliOS.de">milde@users.BerliOS.de</a>></td></tr> -<tr><th class="docinfo-name">Date:</th> -<td>2007-06-13</td></tr> -</tbody> -</table> -<!-- -*- rst-mode -*- --> -<div class="contents topic"> -<p class="topic-title first"><a id="contents" name="contents">Contents</a></p> -<ul class="simple"> -<li><a class="reference" href="#motivation" id="id2" name="id2">Motivation</a></li> -<li><a class="reference" href="#solution" id="id3" name="id3">Solution</a></li> -<li><a class="reference" href="#drawbacks" id="id4" name="id4">Drawbacks</a></li> -<li><a class="reference" href="#files" id="id5" name="id5">Files</a></li> -<li><a class="reference" href="#installation" id="id6" name="id6">Installation</a></li> -<li><a class="reference" href="#usage" id="id7" name="id7">Usage</a></li> -<li><a class="reference" href="#links" id="id8" name="id8">Links</a></li> -</ul> -</div> -<div class="section"> -<h1><a class="toc-backref" href="#id2" id="motivation" name="motivation">Motivation</a></h1> -<p>The HTML Writer module, docutils/writers/html4css1.py produces XHTML -compatible with the XHTML 1.0 specification. Correct rendering of the HTML -produced depends on the CSS support of the browser. Browsers without full -CSS support (lightweight browsers, older browsers, text-only browsers, help -viewers) produce inferior results.</p> -<p>CSS is the state-of-the art technology for styling of html output and -provides many advantages. -However, correct rendering of HTML+CSS requires considerable resources in -form of program code, memory space and computation time.</p> -<p>On older machines or in embedded devices this might pose a serious problem. -Another example is a HTML help viewer of a program. It should start up fast -("immediately") and not take too much resources.</p> -<p>Editing and generating documentation with reStructuredText is possible with -modest requirements on computer power. Viewing the result should be as well.</p> -</div> -<div class="section"> -<h1><a class="toc-backref" href="#id3" id="solution" name="solution">Solution</a></h1> -<p>A separate HTML-transitional writer producing non-CSS based HTML.</p> -<p>The <a class="reference" href="html4trans.py">html4trans</a> writer module subclasses the <cite>html4css1.HTMLTranslator</cite> -and modifies it to remove the dependency on CSS browser support.</p> -<p>The output conforms to the XHTML version 1.0 Transitional DTD and contains -enough formatting information to be viewed without a cascading style sheet by -a lightweight html browser (e.g. <a class="reference" href="http://www.dillo.org">Dillo</a> or the console browser <a class="reference" href="http://elinks.cz">elinks</a>).</p> -</div> -<div class="section"> -<h1><a class="toc-backref" href="#id4" id="drawbacks" name="drawbacks">Drawbacks</a></h1> -<p>Doing without CSS styling comes at a cost.</p> -<ul class="simple"> -<li>The clear distinction of content and layout is lost. The HTML output -contains a fair amount of "hard-coded" visual markup.</li> -<li>CSS style sheets can still be used but cannot override the non-CSS layout -code. It is no longer possible to e.g. modify the colour of a warning text -with a style sheet.</li> -<li>Some more advanced features of CSS layout are hard or impossible to -achieve with pure HTML code. Less important features, not implemented in -this version of the "html4trans" writer are:<ul> -<li>Arabic, roman and alpha list markers for enumerated lists.</li> -<li>Grey background for inline literal and literal blocks.</li> -<li>Leading indentation in line-block objects.</li> -<li><tt class="docutils literal"><span class="pre">:Dedication:</span></tt> and <tt class="docutils literal"><span class="pre">:abstract:</span></tt> bibliographic fields.</li> -<li>Topics, Sidebars, and Rubrics.</li> -<li>Custom Roles with class attributes</li> -</ul> -</li> -</ul> -</div> -<div class="section"> -<h1><a class="toc-backref" href="#id5" id="files" name="files">Files</a></h1> -<ul class="simple"> -<li><a class="reference" href="html4trans.py">html4trans.py</a> -Simple Hypertext Markup Language document tree Writer.</li> -<li><a class="reference" href="rst2html_trans.py">rst2html_trans.py</a> -Front end to the Docutils Publisher, producing HTML not requiring -a CSS stylesheet.</li> -<li><a class="reference" href="test_html4trans.py">test_html4trans.py</a> -Test output & debugging script.</li> -<li><a class="reference" href="docs">docs</a> -Documentation</li> -<li><a class="reference" href="data">data</a> -Input and output samples.</li> -</ul> -</div> -<div class="section"> -<h1><a class="toc-backref" href="#id6" id="installation" name="installation">Installation</a></h1> -<p>Place <a class="reference" href="rst2html_trans.py">rst2html_trans.py</a> in the binary PATH and <a class="reference" href="html4trans.py">html4trans.py</a> in the -PYTHONPATH (or in the directory from where you start <tt class="docutils literal"><span class="pre">rst2html_trans.py</span></tt>).</p> -</div> -<div class="section"> -<h1><a class="toc-backref" href="#id7" id="usage" name="usage">Usage</a></h1> -<p>Identically to the standard <tt class="docutils literal"><span class="pre">rst2html</span></tt> front end:</p> -<pre class="literal-block"> -rst2html_trans.py [options] [<source> [<destination>]] -</pre> -<p>Also see the full <a class="reference" href="docs/usage.html">usage</a> text.</p> -</div> -<div class="section"> -<h1><a class="toc-backref" href="#id8" id="links" name="links">Links</a></h1> -<ul class="simple"> -<li><a class="reference" href="../bbum/DocArticle">DocArticle</a> -is a comparable project by Bill Bumgarner. It is more specific -in its approach, however, producing non-CSS based HTML that is compliant -with the O'Reilly DevCenter's article submission guidelines.</li> -<li><a class="reference" href="http://docutils.sourceforge.net/docs/api/cmdline-tool.html">Inside A Docutils Command-Line Front-End Tool</a> -How to roll your own Docutils front end. (Also see the other -<a class="reference" href="http://docutils.sourceforge.net/docs/index.html#api-api-reference-material-for-client-developers">API Reference Material for Client-Developers</a>.)</li> -</ul> -<!-- References --> -</div> -</div> -<div class="footer"> -<hr class="footer" /> -<a class="reference" href="README.txt">View document source</a>. -Generated on: 2007-06-13. - -</div> -</body> -</html> diff --git a/sandbox/html4trans/docs/usage.html b/sandbox/html4trans/docs/usage.html deleted file mode 100644 index 4b9977fc0..000000000 --- a/sandbox/html4trans/docs/usage.html +++ /dev/null @@ -1,436 +0,0 @@ -<?xml version="1.0" encoding="iso-8859-1" ?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> -<meta name="generator" content="Docutils 0.4.1: http://docutils.sourceforge.net/" /> -<title></title> -<link rel="stylesheet" href="../../../../../lib/python2.4/site-packages/docutils/writers/html4css1/html4css1.css" type="text/css" /> -</head> -<body> -<div class="document"> -<!-- -*- rst-mode -*- --> -<!-- Help text generated with ``rst2html_trans - -help``. --> -<div class="contents topic"> -<p class="topic-title first"><a id="contents" name="contents">Contents</a></p> -<ul class="simple"> -<li><a class="reference" href="#usage" id="id1" name="id1">Usage</a></li> -<li><a class="reference" href="#options" id="id2" name="id2">options</a><ul> -<li><a class="reference" href="#general-docutils-options" id="id3" name="id3">General Docutils Options</a></li> -<li><a class="reference" href="#restructuredtext-parser-options" id="id4" name="id4">reStructuredText Parser Options</a></li> -<li><a class="reference" href="#standalone-reader" id="id5" name="id5">Standalone Reader</a></li> -<li><a class="reference" href="#html-specific-options" id="id6" name="id6">HTML-Specific Options</a></li> -</ul> -</li> -</ul> -</div> -<div class="section"> -<h1><a class="toc-backref" href="#id1" id="usage" name="usage">Usage</a></h1> -<blockquote> -rst2html_trans.py [options] [<source> [<destination>]]</blockquote> -<p>Generates (X)HTML documents from standalone reStructuredText sources that do -not require a CSS stylesheet. Reads from <source> (default is stdin) and -writes to <destination> (default is stdout).</p> -</div> -<div class="section"> -<h1><a class="toc-backref" href="#id2" id="options" name="options">options</a></h1> -<div class="section"> -<h2><a class="toc-backref" href="#id3" id="general-docutils-options" name="general-docutils-options">General Docutils Options</a></h2> -<table class="docutils option-list" frame="void" rules="none"> -<col class="option" /> -<col class="description" /> -<tbody valign="top"> -<tr><td class="option-group"> -<kbd><span class="option">--title=<var>TITLE</var></span></kbd></td> -<td>Specify the document title as metadata (not part of -the document body). Overrides a document-provided -title. There is no default.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--generator</span>, <span class="option">-g</span></kbd></td> -</tr> -<tr><td> </td><td>Include a "Generated by Docutils" credit and link at -the end of the document.</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--no-generator</span></kbd></td> -<td>Do not include a generator credit.</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--date</span>, <span class="option">-d</span></kbd></td> -<td>Include the date at the end of the document (UTC).</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--time</span>, <span class="option">-t</span></kbd></td> -<td>Include the time & date at the end of the document -(UTC).</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--no-datestamp</span></kbd></td> -<td>Do not include a datestamp of any kind.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--source-link</span>, <span class="option">-s</span></kbd></td> -</tr> -<tr><td> </td><td>Include a "View document source" link (relative to -destination).</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--source-url=<var><URL></var></span></kbd></td> -</tr> -<tr><td> </td><td>Use the supplied <URL> verbatim for a "View document -source" link; implies --source-link.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--no-source-link</span></kbd></td> -</tr> -<tr><td> </td><td>Do not include a "View document source" link.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--toc-entry-backlinks</span></kbd></td> -</tr> -<tr><td> </td><td>Enable backlinks from section headers to table of -contents entries. This is the default.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--toc-top-backlinks</span></kbd></td> -</tr> -<tr><td> </td><td>Enable backlinks from section headers to the top of -the table of contents.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--no-toc-backlinks</span></kbd></td> -</tr> -<tr><td> </td><td>Disable backlinks to the table of contents.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--footnote-backlinks</span></kbd></td> -</tr> -<tr><td> </td><td>Enable backlinks from footnotes and citations to their -references. This is the default.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--no-footnote-backlinks</span></kbd></td> -</tr> -<tr><td> </td><td>Disable backlinks from footnotes and citations.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--section-numbering</span></kbd></td> -</tr> -<tr><td> </td><td>Enable Docutils section numbering (default: enabled).</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--no-section-numbering</span></kbd></td> -</tr> -<tr><td> </td><td>Disable Docutils section numbering (default: enabled).</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--strip-comments</span></kbd></td> -</tr> -<tr><td> </td><td>Remove comment elements from the document tree -(default: leave them).</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--leave-comments</span></kbd></td> -</tr> -<tr><td> </td><td>Leave comment elements in the document tree (this is -the default).</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--report=<var><level></var></span>, <span class="option">-r <var><level></var></span></kbd></td> -</tr> -<tr><td> </td><td>Set verbosity threshold; report system messages at or -higher than <level> (by name or number: "info" or "1", -warning/2, error/3, severe/4; also, "none" or "5"). -Default is 2 (warning).</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--verbose</span>, <span class="option">-v</span></kbd></td> -<td>Report all system messages, info-level and higher. -(Same as "--report=info".)</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--quiet</span>, <span class="option">-q</span></kbd></td> -<td>Do not report any system messages. (Same as "-- -report=none".)</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--halt=<var><level></var></span></kbd></td> -<td>Set the threshold (<level>) at or above which system -messages are converted to exceptions, halting -execution immediately by exiting (or propagating the -exception if --traceback set). Levels as in --report. -Default is 4 (severe).</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--strict</span></kbd></td> -<td>Same as "--halt=info": halt processing at the -slightest problem.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--exit-status=<var><level></var></span></kbd></td> -</tr> -<tr><td> </td><td>Enable a non-zero exit status for normal exit if non- -halting system messages (at or above <level>) were -generated. Levels as in --report. Default is 5 -(disabled). Exit status is the maximum system message -level plus 10 (11 for INFO, etc.).</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--debug</span></kbd></td> -<td>Report debug-level system messages and generate -diagnostic output.</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--no-debug</span></kbd></td> -<td>Do not report debug-level system messages or generate -diagnostic output.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--warnings=<var><file></var></span></kbd></td> -</tr> -<tr><td> </td><td>Send the output of system messages (warnings) to -<file>.</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--traceback</span></kbd></td> -<td>Enable Python tracebacks when halt-level system -messages and other exceptions occur. Useful for -debugging, and essential for issue reports.</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--no-traceback</span></kbd></td> -<td>Disable Python tracebacks when errors occur; report -just the error instead. This is the default.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--input-encoding=<var><name[:handler]></var></span>, <span class="option">-i <var><name[:handler]></var></span></kbd></td> -</tr> -<tr><td> </td><td>Specify the encoding of input text. Default is -locale-dependent. Optionally also specify the error -handler for undecodable characters, after a colon -(":"); default is "strict". (See "--intput-encoding- -error-handler".)</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--input-encoding-error-handler=<var>INPUT_ENCODING_ERROR_HANDLER</var></span></kbd></td> -</tr> -<tr><td> </td><td>Specify the error handler for undecodable characters -in the input. Acceptable values include "strict", -"ignore", and "replace". Default is "strict". -Usually specified as part of --input-encoding.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--output-encoding=<var><name[:handler]></var></span>, <span class="option">-o <var><name[:handler]></var></span></kbd></td> -</tr> -<tr><td> </td><td>Specify the text encoding for output. Default is -UTF-8. Optionally also specify the error handler for -unencodable characters, after a colon (":"); default -is "strict". (See "--output-encoding-error-handler".)</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--output-encoding-error-handler=<var>OUTPUT_ENCODING_ERROR_HANDLER</var></span></kbd></td> -</tr> -<tr><td> </td><td>Specify the error handler for unencodable characters -in the output. Acceptable values include "strict", -"ignore", "replace", "xmlcharrefreplace", and -"backslashreplace" (in Python 2.3+). Default is -"strict". Usually specified as part of --output- -encoding.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--error-encoding=<var><name[:handler]></var></span>, <span class="option">-e <var><name[:handler]></var></span></kbd></td> -</tr> -<tr><td> </td><td>Specify the text encoding for error output. Default -is ASCII. Optionally also specify the error handler -for unencodable characters, after a colon (":"); -default is "backslashreplace". (See "--output- -encoding-error-handler".)</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--error-encoding-error-handler=<var>ERROR_ENCODING_ERROR_HANDLER</var></span></kbd></td> -</tr> -<tr><td> </td><td>Specify the error handler for unencodable characters -in error output. See --output-encoding-error-handler -for acceptable values. Default is "backslashreplace". -Usually specified as part of --error-encoding.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--language=<var><name></var></span>, <span class="option">-l <var><name></var></span></kbd></td> -</tr> -<tr><td> </td><td>Specify the language of input text (ISO 639 2-letter -identifier). Default is "en" (English).</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--record-dependencies=<var><file></var></span></kbd></td> -</tr> -<tr><td> </td><td>Write dependencies (caused e.g. by file inclusions) to -<file>. Useful in conjunction with programs like -"make".</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--config=<var><file></var></span></kbd></td> -</tr> -<tr><td> </td><td>Read configuration settings from <file>, if it exists.</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--version</span>, <span class="option">-V</span></kbd></td> -<td>Show this program's version number and exit.</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--help</span>, <span class="option">-h</span></kbd></td> -<td>Show this help message and exit.</td></tr> -</tbody> -</table> -</div> -<div class="section"> -<h2><a class="toc-backref" href="#id4" id="restructuredtext-parser-options" name="restructuredtext-parser-options">reStructuredText Parser Options</a></h2> -<table class="docutils option-list" frame="void" rules="none"> -<col class="option" /> -<col class="description" /> -<tbody valign="top"> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--pep-references</span></kbd></td> -</tr> -<tr><td> </td><td>Recognize and link to standalone PEP references (like -"PEP 258").</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--pep-base-url=<var><URL></var></span></kbd></td> -</tr> -<tr><td> </td><td>Base URL for PEP references (default -"<a class="reference" href="http://www.python.org/peps/">http://www.python.org/peps/</a>").</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--rfc-references</span></kbd></td> -</tr> -<tr><td> </td><td>Recognize and link to standalone RFC references (like -"RFC 822").</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--rfc-base-url=<var><URL></var></span></kbd></td> -</tr> -<tr><td> </td><td>Base URL for RFC references (default -"<a class="reference" href="http://www.faqs.org/rfcs/">http://www.faqs.org/rfcs/</a>").</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--tab-width=<var><width></var></span></kbd></td> -</tr> -<tr><td> </td><td>Set number of spaces for tab expansion (default 8).</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--trim-footnote-reference-space</span></kbd></td> -</tr> -<tr><td> </td><td>Remove spaces before footnote references.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--leave-footnote-reference-space</span></kbd></td> -</tr> -<tr><td> </td><td>Leave spaces before footnote references.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--no-file-insertion</span></kbd></td> -</tr> -<tr><td> </td><td>Disable directives that insert the contents of -external file ("include" & "raw"); replaced with a -"warning" system message.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--file-insertion-enabled</span></kbd></td> -</tr> -<tr><td> </td><td>Enable directives that insert the contents of external -file ("include" & "raw"). Enabled by default.</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--no-raw</span></kbd></td> -<td>Disable the "raw" directives; replaced with a -"warning" system message.</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--raw-enabled</span></kbd></td> -<td>Enable the "raw" directive. Enabled by default.</td></tr> -</tbody> -</table> -</div> -<div class="section"> -<h2><a class="toc-backref" href="#id5" id="standalone-reader" name="standalone-reader">Standalone Reader</a></h2> -<table class="docutils option-list" frame="void" rules="none"> -<col class="option" /> -<col class="description" /> -<tbody valign="top"> -<tr><td class="option-group"> -<kbd><span class="option">--no-doc-title</span></kbd></td> -<td>Disable the promotion of a lone top-level section -title to document title (and subsequent section title -to document subtitle promotion; enabled by default).</td></tr> -<tr><td class="option-group"> -<kbd><span class="option">--no-doc-info</span></kbd></td> -<td>Disable the bibliographic field list transform -(enabled by default).</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--section-subtitles</span></kbd></td> -</tr> -<tr><td> </td><td>Activate the promotion of lone subsection titles to -section subtitles (disabled by default).</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--no-section-subtitles</span></kbd></td> -</tr> -<tr><td> </td><td>Deactivate the promotion of lone subsection titles.</td></tr> -</tbody> -</table> -</div> -<div class="section"> -<h2><a class="toc-backref" href="#id6" id="html-specific-options" name="html-specific-options">HTML-Specific Options</a></h2> -<table class="docutils option-list" frame="void" rules="none"> -<col class="option" /> -<col class="description" /> -<tbody valign="top"> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--stylesheet=<var><URL></var></span></kbd></td> -</tr> -<tr><td> </td><td>Specify a stylesheet URL, used verbatim. Overrides ---stylesheet-path.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--stylesheet-path=<var><file></var></span></kbd></td> -</tr> -<tr><td> </td><td>Specify a stylesheet file, relative to the current -working directory. The path is adjusted relative to -the output HTML file. Overrides --stylesheet. -Default: "../../../../lib/python2.4/site- -packages/docutils/writers/html4css1/html4css1.css"</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--embed-stylesheet</span></kbd></td> -</tr> -<tr><td> </td><td>Embed the stylesheet in the output HTML file. The -stylesheet file must be accessible during processing -(--stylesheet-path is recommended). This is the -default.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--link-stylesheet</span></kbd></td> -</tr> -<tr><td> </td><td>Link to the stylesheet in the output HTML file. -Default: embed the stylesheet, do not link to it.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--initial-header-level=<var><level></var></span></kbd></td> -</tr> -<tr><td> </td><td>Specify the initial header level. Default is 1 for -"<h1>". Does not affect document title & subtitle -(see --no-doc-title).</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--field-name-limit=<var><level></var></span></kbd></td> -</tr> -<tr><td> </td><td>Specify the maximum width (in characters) for one- -column field names. Longer field names will span an -entire row of the table used to render the field list. -Default is 14 characters. Use 0 for "no limit".</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--option-limit=<var><level></var></span></kbd></td> -</tr> -<tr><td> </td><td>Specify the maximum width (in characters) for options -in option lists. Longer options will span an entire -row of the table used to render the option list. -Default is 14 characters. Use 0 for "no limit".</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--footnote-references=<var><format></var></span></kbd></td> -</tr> -<tr><td> </td><td>Format for footnote references: one of "superscript" -or "brackets". Default is "brackets".</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--attribution=<var><format></var></span></kbd></td> -</tr> -<tr><td> </td><td>Format for block quote attributions: one of "dash" -(em-dash prefix), "parentheses"/"parens", or "none". -Default is "dash".</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--compact-lists</span></kbd></td> -</tr> -<tr><td> </td><td>Remove extra vertical whitespace between items of -"simple" bullet lists and enumerated lists. Default: -enabled.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--no-compact-lists</span></kbd></td> -</tr> -<tr><td> </td><td>Disable compact simple bullet and enumerated lists.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--compact-field-lists</span></kbd></td> -</tr> -<tr><td> </td><td>Remove extra vertical whitespace between items of -simple field lists. Default: enabled.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--no-compact-field-lists</span></kbd></td> -</tr> -<tr><td> </td><td>Disable compact simple field lists.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--no-xml-declaration</span></kbd></td> -</tr> -<tr><td> </td><td>Omit the XML declaration. Use with caution.</td></tr> -<tr><td class="option-group" colspan="2"> -<kbd><span class="option">--cloak-email-addresses</span></kbd></td> -</tr> -<tr><td> </td><td>Obfuscate email addresses to confuse harvesters while -still keeping email links usable with standards- -compliant browsers.</td></tr> -</tbody> -</table> -</div> -</div> -</div> -<div class="footer"> -<hr class="footer" /> -<a class="reference" href="usage.txt">View document source</a>. -Generated on: 2007-06-13. - -</div> -</body> -</html> |