Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

sphinx-autodoc-docutils

Sphinx extension for turning docutils components — directives, roles, transforms, readers, parsers, writers, custom nodes, and translators — into copyable reference entries inside your docs site.

The extension keeps its semantic rst:* parse path, but the rendered body regions, badges, and shared type formatting now come from sphinx_ux_autodoc_layout, sphinx_ux_badges, and sphinx_autodoc_typehints_gp.

Install

$ pip install sphinx-autodoc-docutils

Usage

extensions = ["sphinx_autodoc_docutils"]

Then document directive classes and role callables with eval-rst:

```{eval-rst}
.. autodirective:: my_project.docs_ext.MyDirective
```

```{eval-rst}
.. autorole:: my_project.docs_roles.cli_option_role
```

Every docutils extension point gets the same single + bulk pair:

.. autotransform:: my_project.transforms.SanitizeTransform

.. autoreader:: my_project.readers.ArticleReader

.. autoparser:: my_project.parsers.LineParser

.. autowriter:: my_project.writers.PlainWriter

.. autonode:: my_project.nodes.icon

.. autotranslator:: my_project.writers.PlainTranslator

For module-wide reference pages:

.. autodirectives:: my_project.docs_ext

.. autoroles:: my_project.docs_roles

.. autotransforms:: my_project

Component entries register targets in a docutils Sphinx domain, so prose can cross-reference them with roles like :docutils:transform:`SanitizeTransform`.

Documentation

See the full documentation for live demos, directive option rendering, and downstream usage patterns.

Metadata

Release files for sphinx-autodoc-docutils 0.1.0a39

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sphinx-autodoc-docutils 0.1.0a39
File Size Uploaded
sphinx_autodoc_docutils-0.1.0a39.tar.gz 22.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for sphinx-autodoc-docutils 0.1.0a39
File Interpreter ABI Platform
sphinx_autodoc_docutils-0.1.0a39-py3-none-any.whl Python 3 none any Details

Total release size: 55.5 kB

Release files / sphinx_autodoc_docutils-0.1.0a39.tar.gz

Download URL sphinx_autodoc_docutils-0.1.0a39.tar.gz
Size 22.8 kB
Tags Source
SHA-256 checksum
How to use checksums
780bd8359a912c81665953e923f1a0c5a44911f7c7cfe00780cbd515f5cf6af7
BLAKE2b-256 checksum
How to use checksums
1fbeddc8823e659d856164c7ef8c5239a512714c90ace188f3050f2ab202676e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 6, 2026.

Transparency log

Release files / sphinx_autodoc_docutils-0.1.0a39-py3-none-any.whl

Download URL sphinx_autodoc_docutils-0.1.0a39-py3-none-any.whl
Size 32.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
21a9952a9b02bf07467f4b57bf84ddd364abf6fbbb1f0734d6ce977bae433cfe
BLAKE2b-256 checksum
How to use checksums
73b2cb4abf1593d2de3e904472a2fa4fb4f506c4dad4053ddba4af0f67110aa1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 6, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.0a39 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page