geometor.pappus.sphinx_ext

Sphinx extension for Pappus of Alexandria’s Synagoge Multi-Track Book Codex.

Registers the el (“Greek (Hultsch 1876)”) companion track in photon_platform.publish.book at build time and configures offline-safe intersphinx_mapping entries against locally built sibling GEOMETOR repositories whenever their docs/objects.inv inventories exist on disk.

Attributes

GREEK_TRACK_KEY

GREEK_TRACK_LABEL

SIBLING_CODICES

Functions

register_greek_book_track() → None

Extend photon_platform.publish.book to recognize <stem>-el Greek tracks.

configure_local_intersphinx([intersphinx_mapping, ...]) → dict[str, tuple[str, str]]

Bind local sibling objects.inv inventories and prune unreachable remote-only targets.

setup(app) → dict[str, object]

Initialize the geometor.pappus.sphinx_ext Sphinx extension.

Module Contents

geometor.pappus.sphinx_ext.GREEK_TRACK_KEY = 'el'
geometor.pappus.sphinx_ext.GREEK_TRACK_LABEL = 'Greek (Hultsch 1876)'
geometor.pappus.sphinx_ext.SIBLING_CODICES: tuple[tuple[str, str, str], ...] = (('euclid', 'euclid', 'https://geometor.github.io/euclid'), ('elements', 'elements',...
geometor.pappus.sphinx_ext.register_greek_book_track() → None

Extend photon_platform.publish.book to recognize <stem>-el Greek tracks.

geometor.pappus.sphinx_ext.configure_local_intersphinx(intersphinx_mapping: dict[str, Any] | None = None, project_root: pathlib.Path | None = None) → dict[str, tuple[str, str]]

Bind local sibling objects.inv inventories and prune unreachable remote-only targets.

Parameters:
  • intersphinx_mapping – Optional live Sphinx intersphinx_mapping dict to update in-place.

  • project_root – Path to /home/phi/PROJECTS/geometor/pappus; inferred from package path if None.

Returns:

Dictionary of locally resolved (base_url, objects_inv_path) entries.

geometor.pappus.sphinx_ext.setup(app: object) → dict[str, object]

Initialize the geometor.pappus.sphinx_ext Sphinx extension.