Installer docutils avec Homebrew, Nix, zypper

Liens du projet

• Page d'accueil
• Dépôt
• Docs amont
• Page du gestionnaire de paquets

Commandes et alias

• docutils
• rst2html
• rst2html4
• rst2html5
• rst2latex
• rst2man
• rst2odt
• rst2pseudoxml
• rst2s5
• rst2xetex
• rst2xml

Historique du projet

The project's roots are in the Python documentation community. reStructuredText was designed by David Goodger as a revision and reinterpretation of StructuredText and Setext, with goals of readable plaintext markup, unambiguous parsing, and conversion into useful structured formats.

Docutils grew out of Python Doc-SIG discussions around docstring processing. Goodger's history notes StructuredText's 1996 origins, his late-1999 encounter with it, a November 2000 first draft of a revised specification, a June 2001 project web site and first release, and the 2002 merger of the reStructuredText and Docstring Processing System projects into Docutils.

Historique d'adoption

Docutils became the reference implementation for reStructuredText and a foundation for Python documentation tooling. The FAQ describes support for standalone files, PEPs, Python docstrings, and client code such as Sphinx extensions, while Homebrew and PyPI packaging keep the command-line tools widely available.

Modes d'utilisation

Users run front-end tools to convert reStructuredText to HTML, LaTeX, man pages, ODT, XML, pseudoxml, and other formats, or call the `docutils` Python package as a library. Configuration can come from system, local, or user-level docutils config files.

Pourquoi les passionnés de paquets s'y intéressent

Docutils is package-nerd significant because it is infrastructure disguised as a text converter. It links Python docstring conventions, PEP publishing, Sphinx-era documentation, command-line document conversion, and a decades-long release history into one small but foundational package.

Chronologie

• 1996: StructuredText first released in the Zope ecosystem.
• 1999: David Goodger discovered StructuredText while looking for Python module documentation tooling.
• 2000: First reStructuredText draft posted to Python Doc-SIG.
• 2001: Project web site and first release rolled out.
• 2002: reStructuredText and Docstring Processing System projects merged and renamed Docutils.
• 2026: Docutils 0.23 listed in release notes and packaged by Homebrew.

Related projects

• Docutils is related to StructuredText, Setext, Python PEP tooling, Sphinx, and the wider Python documentation ecosystem. Its FAQ explicitly points to Sphinx as client code using reStructuredText for Python auto-documentation.

Sources

• https://docutils.sourceforge.io/FAQ.html
• https://docutils.sourceforge.io/docs/ref/rst/introduction.html
• https://docutils.sourceforge.io/docs/ref/rst/history.html
• https://docutils.sourceforge.io/RELEASE-NOTES.html
• https://sourceforge.net/p/docutils/code/HEAD/tree
• https://formulae.brew.sh/api/formula/docutils.json