| Server IP : 82.148.16.210 / Your IP : 216.73.216.19 Web Server : nginx/1.29.5 System : Linux mail.sarafai.ru 6.1.0-43-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.162-1 (2026-02-08) x86_64 User : root ( 0) PHP Version : 7.4.33 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /usr/share/doc/docutils-doc/docs/ |
Upload File : |
<?xml version="1.0" encoding="utf-8" ?> <!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=utf-8" /> <meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" /> <title>Docutils Project Documentation Overview</title> <meta name="author" content="David Goodger" /> <meta name="date" content="2022-06-13" /> <meta name="copyright" content="This document has been placed in the public domain." /> <link rel="stylesheet" href="../css/html4css1.css" type="text/css" /> </head> <body> <div class="header"> <a class="reference external" href="https://docutils.sourceforge.io/">Docutils</a> | Overview | <a class="reference internal" href="#project-fundamentals">About</a> | <a class="reference internal" href="#user">Users</a> | <a class="reference internal" href="#ref">Reference</a> | <a class="reference internal" href="#howto">Developers</a> <hr class="header"/> </div> <div class="document" id="docutils-project-documentation-overview"> <h1 class="title">Docutils Project Documentation Overview</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>David Goodger</td></tr> <tr><th class="docinfo-name">Contact:</th> <td><a class="first last reference external" href="mailto:docutils-develop@lists.sourceforge.net">docutils-develop@lists.sourceforge.net</a></td></tr> <tr><th class="docinfo-name">Date:</th> <td>2022-06-13</td></tr> <tr><th class="docinfo-name">Revision:</th> <td>9069</td></tr> <tr><th class="docinfo-name">Copyright:</th> <td>This document has been placed in the public domain.</td></tr> </tbody> </table> <p>The latest working documents may be accessed individually below, or from the <tt class="docutils literal">docs</tt> directory of the <a class="reference external" href="https://docutils.sourceforge.io/#download">Docutils distribution</a>.</p> <div class="contents topic" id="contents"> <p class="topic-title">Contents</p> <ul class="simple"> <li><a class="reference internal" href="#docutils-stakeholders" id="toc-entry-1">Docutils Stakeholders</a></li> <li><a class="reference internal" href="#project-fundamentals" id="toc-entry-2">Project Fundamentals</a></li> <li><a class="reference internal" href="#introductory-tutorial-material-for-end-users" id="toc-entry-3">Introductory & Tutorial Material for End-Users</a></li> <li><a class="reference internal" href="#reference-material-for-all-groups" id="toc-entry-4">Reference Material for All Groups</a></li> <li><a class="reference internal" href="#api-reference-material-for-client-developers" id="toc-entry-5">API Reference Material for Client-Developers</a></li> <li><a class="reference internal" href="#instructions-for-developers" id="toc-entry-6">Instructions for Developers</a></li> <li><a class="reference internal" href="#development-notes-and-plans-for-core-developers" id="toc-entry-7">Development Notes and Plans for Core-Developers</a></li> </ul> </div> <div class="section" id="docutils-stakeholders"> <h1><a class="toc-backref" href="#toc-entry-1">Docutils Stakeholders</a></h1> <p>Docutils stakeholders can be categorized in several groups:</p> <ol class="arabic simple"> <li>End-users: users of reStructuredText and the Docutils tools. Although some are developers (e.g. Python developers utilizing reStructuredText for docstrings in their source), many are not.</li> <li>Client-developers: developers using Docutils as a library, programmers developing <em>with</em> Docutils.</li> <li>Component-developers: those who implement application-specific components, directives, and/or roles, separately from Docutils.</li> <li>Core-developers: developers of the Docutils codebase and participants in the Docutils project community.</li> <li>Re-implementers: developers of alternate implementations of Docutils.</li> </ol> <p>There's a lot of overlap between these groups. Most (perhaps all) core-developers, component-developers, client-developers, and re-implementers are also end-users. Core-developers are also client-developers, and may also be component-developers in other projects. Component-developers are also client-developers.</p> </div> <div class="section" id="project-fundamentals"> <h1><a class="toc-backref" href="#toc-entry-2">Project Fundamentals</a></h1> <p>These files are for all Docutils stakeholders. They are kept at the top level of the Docutils project directory.</p> <table class="narrow run-in docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field"><th class="field-name"><a class="reference external" href="../README.html">README</a>:</th><td class="field-body">Project overview: quick-start, requirements, installation, and usage.</td> </tr> <tr class="field"><th class="field-name"><a class="reference external" href="../COPYING.html">COPYING</a>:</th><td class="field-body">Conditions for Docutils redistribution, with links to licenses.</td> </tr> <tr class="field"><th class="field-name"><a class="reference external" href="../FAQ.html">FAQ</a>:</th><td class="field-body">Docutils Frequently Asked Questions. If you have a question or issue, there's a good chance it's already answered here.</td> </tr> <tr class="field"><th class="field-name"><a class="reference external" href="../BUGS.html">BUGS</a>:</th><td class="field-body">A list of known bugs, and how to report a bug.</td> </tr> <tr class="field"><th class="field-name"><a class="reference external" href="../RELEASE-NOTES.html">RELEASE-NOTES</a>:</th><td class="field-body">Summary of the major changes in recent releases and notice of future incompatible changes.</td> </tr> <tr class="field"><th class="field-name"><a class="reference external" href="../HISTORY.html">HISTORY</a>:</th><td class="field-body">Detailed change history log.</td> </tr> <tr class="field"><th class="field-name"><a class="reference external" href="../THANKS.html">THANKS</a>:</th><td class="field-body">Acknowledgements.</td> </tr> </tbody> </table> </div> <div class="section" id="introductory-tutorial-material-for-end-users"> <span id="user"></span><h1><a class="toc-backref" href="#toc-entry-3">Introductory & Tutorial Material for End-Users</a></h1> <dl class="docutils"> <dt>Docutils-general:</dt> <dd><ul class="first last simple"> <li><a class="reference external" href="user/tools.html">Docutils Front-End Tools</a></li> <li><a class="reference external" href="user/config.html">Docutils Configuration</a></li> <li><a class="reference external" href="user/mailing-lists.html">Docutils Mailing Lists</a></li> <li><a class="reference external" href="user/links.html">Docutils Link List</a></li> </ul> </dd> <dt>Writer-specific:</dt> <dd><ul class="first last simple"> <li><a class="reference external" href="user/html.html">Docutils HTML Writers</a></li> <li><a class="reference external" href="user/slide-shows.html">Easy Slide Shows With reStructuredText & S5</a></li> <li><a class="reference external" href="user/latex.html">Docutils LaTeX Writer</a></li> <li><a class="reference external" href="user/manpage.html">Man Page Writer for Docutils</a></li> <li><a class="reference external" href="user/odt.html">Docutils ODF/OpenOffice/odt Writer</a></li> </ul> </dd> <dt><a class="reference external" href="https://docutils.sourceforge.io/rst.html">reStructuredText</a>:</dt> <dd><ul class="first last simple"> <li><a class="reference external" href="user/rst/quickstart.html">A ReStructuredText Primer</a> (see also the <a class="reference external" href="user/rst/quickstart.txt">text source</a>)</li> <li><a class="reference external" href="user/rst/quickref.html">Quick reStructuredText</a> (user reference)</li> <li><a class="reference external" href="user/rst/cheatsheet.txt">reStructuredText Cheat Sheet</a> (text only; 1 page for syntax, 1 page directive & role reference)</li> <li><a class="reference external" href="user/rst/demo.html">Demonstration</a> of most reStructuredText features (see also the <a class="reference external" href="user/rst/demo.txt">text source</a>)</li> </ul> </dd> <dt>Editor support:</dt> <dd><ul class="first last simple"> <li><a class="reference external" href="user/emacs.html">Emacs support for reStructuredText</a></li> </ul> </dd> </dl> </div> <div class="section" id="reference-material-for-all-groups"> <span id="ref"></span><h1><a class="toc-backref" href="#toc-entry-4">Reference Material for All Groups</a></h1> <p>Many of these files began as developer specifications, but now that they're mature and used by end-users and client-developers, they have become reference material. Successful specs evolve into refs.</p> <dl class="docutils"> <dt>Docutils-general:</dt> <dd><ul class="first last simple"> <li><a class="reference external" href="ref/doctree.html">The Docutils Document Tree</a> (incomplete)</li> <li><a class="reference external" href="ref/docutils.dtd">Docutils Generic DTD</a></li> <li><a class="reference external" href="ref/soextblx.dtd">OASIS XML Exchange Table Model Declaration Module</a> (CALS tables DTD module)</li> <li><a class="reference external" href="peps/pep-0258.html">Docutils Design Specification</a> (PEP 258)</li> </ul> </dd> <dt><a class="reference external" href="https://docutils.sourceforge.io/rst.html">reStructuredText</a>:</dt> <dd><ul class="first last simple"> <li><a class="reference external" href="ref/rst/introduction.html">An Introduction to reStructuredText</a> (includes the <a class="reference external" href="ref/rst/introduction.html#goals">Goals</a> and <a class="reference external" href="ref/rst/introduction.html#history">History</a> of reStructuredText)</li> <li><a class="reference external" href="ref/rst/restructuredtext.html">reStructuredText Markup Specification</a></li> <li><a class="reference external" href="ref/rst/directives.html">reStructuredText Directives</a></li> <li><a class="reference external" href="ref/rst/roles.html">reStructuredText Interpreted Text Roles</a></li> <li><a class="reference external" href="ref/rst/definitions.html">reStructuredText Standard Definition Files</a></li> <li><a class="reference external" href="ref/rst/mathematics.html">LaTeX syntax for mathematics</a> (syntax used in "math" directive and role)</li> </ul> </dd> </dl> <dl class="docutils" id="peps"> <dt>Python Enhancement Proposals</dt> <dd><ul class="first simple"> <li><a class="reference external" href="peps/pep-0256.html">PEP 256: Docstring Processing System Framework</a> is a high-level generic proposal. [<a class="reference external" href="https://peps.python.org/pep-0256">PEP 256</a> in the <a class="reference external" href="https://peps.python.org">master repository</a>]</li> <li><a class="reference external" href="peps/pep-0257.html">PEP 257: Docstring Conventions</a> addresses docstring style and touches on content. [<a class="reference external" href="https://peps.python.org/pep-0257">PEP 257</a> in the <a class="reference external" href="https://peps.python.org">master repository</a>]</li> <li><a class="reference external" href="peps/pep-0258.html">PEP 258: Docutils Design Specification</a> is an overview of the architecture of Docutils. It documents design issues and implementation details. [<a class="reference external" href="https://peps.python.org/pep-0258">PEP 258</a> in the <a class="reference external" href="https://peps.python.org">master repository</a>]</li> <li><a class="reference external" href="peps/pep-0287.html">PEP 287: reStructuredText Docstring Format</a> proposes a standard markup syntax. [<a class="reference external" href="https://peps.python.org/pep-0287">PEP 287</a> in the <a class="reference external" href="https://peps.python.org">master repository</a>]</li> </ul> <p class="last">Please note that PEPs in the <a class="reference external" href="https://peps.python.org">master repository</a> developed independent from the local versions after submission.</p> </dd> <dt>Prehistoric:</dt> <dd><a class="reference external" href="https://docutils.sourceforge.io/mirror/setext.html">Setext Documents Mirror</a></dd> </dl> </div> <div class="section" id="api-reference-material-for-client-developers"> <span id="api"></span><h1><a class="toc-backref" href="#toc-entry-5">API Reference Material for Client-Developers</a></h1> <ul class="simple"> <li><a class="reference external" href="api/publisher.html">The Docutils Publisher</a></li> <li><a class="reference external" href="api/runtime-settings.html">Docutils Runtime Settings</a></li> <li><a class="reference external" href="api/transforms.html">Docutils Transforms</a></li> </ul> <p>The <a class="reference external" href="peps/pep-0258.html">Docutils Design Specification</a> (PEP 258) is a must-read for any Docutils developer.</p> </div> <div class="section" id="instructions-for-developers"> <span id="howto"></span><h1><a class="toc-backref" href="#toc-entry-6">Instructions for Developers</a></h1> <table class="docutils field-list" frame="void" rules="none"> <col class="field-name" /> <col class="field-body" /> <tbody valign="top"> <tr class="field"><th class="field-name">Security:</th><td class="field-body"><a class="reference external" href="howto/security.html">Deploying Docutils Securely</a></td> </tr> </tbody> </table> <ul class="simple"> <li><a class="reference external" href="howto/cmdline-tool.html">Inside A Docutils Command-Line Front-End Tool</a></li> <li><a class="reference external" href="howto/html-stylesheets.html">Writing HTML (CSS) Stylesheets for Docutils</a></li> <li><a class="reference external" href="howto/i18n.html">Docutils Internationalization</a></li> <li><a class="reference external" href="howto/rst-directives.html">Creating reStructuredText Directives</a></li> <li><a class="reference external" href="howto/rst-roles.html">Creating reStructuredText Interpreted Text Roles</a></li> </ul> </div> <div class="section" id="development-notes-and-plans-for-core-developers"> <span id="dev"></span><h1><a class="toc-backref" href="#toc-entry-7">Development Notes and Plans for Core-Developers</a></h1> <dl class="docutils"> <dt>Docutils-general:</dt> <dd><ul class="first last simple"> <li><a class="reference external" href="dev/hacking.html">Docutils Hacker's Guide</a></li> <li><a class="reference external" href="dev/distributing.html">Docutils Distributor's Guide</a></li> <li><a class="reference external" href="dev/todo.html">Docutils To Do List</a></li> <li><a class="reference external" href="dev/policies.html">Docutils Project Policies</a></li> <li><a class="reference external" href="dev/website.html">Docutils Web Site</a></li> <li><a class="reference external" href="dev/release.html">Docutils Release Procedure</a></li> <li><a class="reference external" href="dev/repository.html">The Docutils Subversion Repository</a></li> <li><a class="reference external" href="dev/testing.html">Docutils Testing</a></li> <li><a class="reference external" href="dev/semantics.html">Docstring Semantics</a> (incomplete)</li> <li><a class="reference external" href="dev/pysource.html">Python Source Reader</a> (incomplete)</li> <li><a class="reference external" href="dev/pysource.dtd">Docutils Python DTD</a></li> <li><a class="reference external" href="dev/enthought-plan.html">Plan for Enthought API Documentation Tool</a></li> <li><a class="reference external" href="dev/enthought-rfp.html">Enthought API Documentation Tool RFP</a></li> </ul> </dd> <dt><a class="reference external" href="https://docutils.sourceforge.io/rst.html">reStructuredText</a>:</dt> <dd><ul class="first last simple"> <li><a class="reference external" href="dev/rst/alternatives.html">A Record of reStructuredText Syntax Alternatives</a></li> <li><a class="reference external" href="dev/rst/problems.html">Problems With StructuredText</a></li> </ul> </dd> </dl> <!-- Local Variables: mode: indented-text indent-tabs-mode: nil sentence-end-double-space: t fill-column: 70 End: --> </div> </div> </body> </html>