Metadata-Version: 2.4
Name: gp-furo-theme
Version: 0.0.1a30
Summary: Tailwind v4 port of the Furo Sphinx theme for git-pull project documentation
Project-URL: Repository, https://github.com/git-pull/gp-sphinx
Author-email: Tony Narlock <tony@git-pull.com>
License: MIT
License-File: LICENSE-FURO
Keywords: documentation,furo,sphinx,tailwind,theme
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Sphinx
Classifier: Framework :: Sphinx :: Theme
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Documentation
Classifier: Topic :: Documentation :: Sphinx
Classifier: Typing :: Typed
Requires-Python: <4.0,>=3.10
Requires-Dist: accessible-pygments>=0.0.5
Requires-Dist: beautifulsoup4
Requires-Dist: pygments
Requires-Dist: sphinx-basic-ng>=1.0.0b2
Requires-Dist: sphinx>=8.1
Description-Content-Type: text/markdown

# gp-furo-theme

A Tailwind-v4-driven port of the [Furo](https://github.com/pradyunsg/furo)
Sphinx theme for git-pull project documentation. Renders byte-equivalent HTML
and visually-equivalent CSS to upstream Furo while sourcing all styles from
Tailwind v4 layers and the `@gp-sphinx/furo-tokens` package.

## Status

Skeleton — only the theme registration hook (`setup()`) is wired up. Template
ports, asset pipeline, and Python hooks (`_html_page_context`,
`_builder_inited`, `_overwrite_pygments_css`, `_asset_hash`,
`WrapTableAndMathInAContainerTransform`) land in subsequent commits.

## Usage (eventual)

```python
# conf.py
html_theme = "gp-furo"
```

## Attribution

Templates, styles, and scripts are ported from upstream Furo at the commit
pinned in `../gp-furo-tokens/upstream/furo-vars.json`. Furo is MIT-licensed
by Pradyun Gedam; the full license text is reproduced at `LICENSE-FURO`.
Each ported file carries a 3-line attribution header pointing at upstream.
