Packages¶

The workspace ships independently-installable Sphinx packages organized by family. Each package has its own page; the grid below auto-enumerates the full set as the workspace evolves.

gp-sphinx is the umbrella entry point — its merge_sphinx_config() wires up the full stack for downstream projects in ~10 lines of conf.py. Every other package is opt-in and independently installable.

Common libraries¶

The rendering pipeline every autodoc extension consumes, plus shared page primitives:

sphinx-ux-badges — badge primitives and colour palette
sphinx-ux-autodoc-layout — structural presenter for api-* entry components
sphinx-autodoc-typehints-gp — annotation normalization and type rendering
sphinx-fonts — IBM Plex font preloading
sphinx-gp-mermaid — build-time mermaid diagrams as dual-theme inline SVG

Code highlighting¶

Pygments lexers and inline literal helpers for code-heavy documentation:

sphinx-gp-highlighting — directory-tree code blocks and inline command/path highlighting

Autodoc extensions¶

Domain-specific autodoc extensions — each adds directives that generate documentation from a particular source-construct family (Python APIs, argparse parsers, pytest fixtures, etc.):

sphinx-autodoc-api-style — Python API rendering style
sphinx-autodoc-argparse — argparse parsers + subcommands
sphinx-autodoc-docutils — docutils directives + nodes
sphinx-autodoc-fastmcp — FastMCP tools, prompts, resources
sphinx-autodoc-pytest-fixtures — pytest fixtures
sphinx-autodoc-sphinx — Sphinx config values

Build utils¶

PEP 517 backends and orchestration helpers for theme asset pipelines:

sphinx-vite-builder — PEP 517 backend + Sphinx extension that runs Vite via pnpm

Theme and coordinator¶

Shared Sphinx configuration and presentation assets:

gp-sphinx — umbrella coordinator (merge_sphinx_config())
sphinx-gp-theme — Furo child theme with the gp-sphinx default palette
gp-furo-theme — Tailwind v4 port of upstream Furo for git-pull projects

SEO and agent formats¶

Meta-tag, crawlability, and LLM-friendly output extensions auto-loaded by gp-sphinx when docs_url is set:

sphinx-gp-opengraph — Open Graph + Twitter Card meta tags
sphinx-gp-sitemap — sitemap.xml for crawl indexing
sphinx-gp-llms — llms.txt, llms-full.txt, docs.json, per-page .md twins

Design philosophy¶

Together, the common libraries provide one autodoc design system: every autodoc extension shares the same badge palette, the same componentized HTML output structure, and the same static type annotation pipeline — so Python APIs, pytest fixtures, Sphinx config values, docutils directives, and FastMCP tools all look like they belong together.