使用 Homebrew, Nix, zypper 安装 docutils

项目链接

• 主页

命令和别名

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

项目历史

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.

采用历史

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.

使用方式

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.

为什么软件包爱好者会关心

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.

时间线

• 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.

来源

• 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