Skip to main content
Pre-release

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

sphinx-ux-autodoc-layout

Componentized layout for Sphinx autodoc output. It preserves Sphinx's outer dl / dt / dd structure while rebuilding managed object-description entries into stable api-* components. The current shared layout covers Python API objects, pytest fixtures, Sphinx confval entries, docutils rst:* entries, and internal FastMCP mcp:tool prototypes used to validate future consolidation work.

The extension keeps header composition in a late doctree-resolved pass so badges, source links, and permalinks can be positioned independently without raw HTML mutation. Large signatures can fold into native multiline signature markup, and expanded folded signatures show annotations by default via api_signature_show_annotations.

For shared consumers, the public helper surface now includes:

  • build_api_card_entry() for section-card consumers that need the same inner api-* shell without becoming desc entries
  • build_api_summary_section() for summary/index wrappers such as config and fixture tables

Install

$ pip install sphinx-ux-autodoc-layout

Usage

Standalone Sphinx project:

extensions = ["sphinx.ext.autodoc", "sphinx_ux_autodoc_layout"]
api_layout_enabled = True

With gp-sphinx:

conf = merge_sphinx_config(
    ...,
    extra_extensions=["sphinx_ux_autodoc_layout"],
    api_layout_enabled=True,
)

Documentation

See the full documentation for configuration reference, CSS classes, and live demos.

Metadata

Release files for sphinx-ux-autodoc-layout 0.1.0a38

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-ux-autodoc-layout 0.1.0a38
File Size Uploaded
sphinx_ux_autodoc_layout-0.1.0a38.tar.gz 30.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for sphinx-ux-autodoc-layout 0.1.0a38
File Interpreter ABI Platform
sphinx_ux_autodoc_layout-0.1.0a38-py3-none-any.whl Python 3 none any Details

Total release size: 66.1 kB

Release files / sphinx_ux_autodoc_layout-0.1.0a38.tar.gz

Download URL sphinx_ux_autodoc_layout-0.1.0a38.tar.gz
Size 30.8 kB
Tags Source
SHA-256 checksum
How to use checksums
321bf86d2a2d722fbad512db06e3fce2ea9a6cccb07c5657b19daf9fc0327bb3
BLAKE2b-256 checksum
How to use checksums
4b77efd705589f62ad6d1af2d6a58490b4076b9a6d8c8fca3e7cd39a7e667bbf
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 Aug 30, 2026.

Transparency log

Release files / sphinx_ux_autodoc_layout-0.1.0a38-py3-none-any.whl

Download URL sphinx_ux_autodoc_layout-0.1.0a38-py3-none-any.whl
Size 35.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cc265a05501ffc2166a48db55769ba37fa53003f4608b2e24cea362e331b2fd3
BLAKE2b-256 checksum
How to use checksums
9febfcdfe267966a724d3069e9d8ae49f653531ee79987f4b4ef0a2f42302494
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 Aug 30, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.0a38 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