Metadata-Version: 2.1
Name: ahdcreative-sphinx-theme
Version: 1.0.0rc0
Summary: Sphinx AHDCreative Theme
Home-page: https://github.com/ahdcreative/sphinx_ahd_theme
Author: AHDCreative
Author-email: hello@ahd-creative.agency
Project-URL: Bug Tracker, https://github.com/ahdcrearive/sphinx_ahd_theme/issues
Classifier: Framework :: Sphinx
Classifier: Framework :: Sphinx :: Theme
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: OS Independent
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Documentation
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# [Sphinx AHD theme](https://sphinx-ahd-theme.netlify.app/)

[![CI status](https://github.com/ahdcreative/sphinx_ahd_theme/workflows/CI/badge.svg)](https://github.com/ahdcreative/sphinx_ahd_theme/actions?query=workflow%3ACI) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Sphinx AHD theme contains all files required to build a Sphinx extension that provides the theme.

-   [MIT license](https://github.com/ahcreative/sphinx_ahd_theme/blob/main/LICENSE)
-   [Repository](https://github.com/ahdcreative/sphinx_ahd_theme)
-   [Security](https://github.com/ahdcreative/sphinx_ahd_theme/blob/main/SECURITY.md)
-   [Changelog](https://github.com/ahdcreative/sphinx_ahd_theme/blob/main/CHANGELOG.md)
-   Supports Python > 3.7

## Installation

```sh
pip install sphinx-ahd-theme
```

## Usage

Select the "Sphinx AHD theme" in the `conf.py` file of a Sphinx

```python
# include the theme in the list of extensions to be loaded
extensions = ['sphinx_ahd_theme', …]

# select the theme
html_theme = 'sphinx_ahd_theme'
```

-   See the documentation for more usage instructions

## Development

### Getting started

-   [Instructions for Mac, Linux, and Windows](docs/development.rst)

### Release process

Checklist:

-   [ ] `CHANGELOG.md` is updated
-   [ ] `setup.cfg` is updated (see `version`)
-   [ ] Everything is committed, clean checkout
-   [ ] `~/.pypirc` has a username and password (token)
-   [ ] Add a git tag and a Github release once completed

With an active virtual environment:

```sh
python -m pip install --upgrade -r requirements.txt
make clean
make clean-frontend
npm ci
npm run build
prerelease
git tag -a N.N.N -m "N.N.N"
git push origin N.N.N
python -m build
python -m twine upload --repository pypi dist/*
postrelease
```

## Credits

[Sphinx AHD theme](https://github.com/ahdcreative/sphinx_ahd_theme) is based on [Sphinx Typo3 theme](https://github.com/TYPO3-Documentation/sphinx_typo3_theme) which is based on [t3SphinxThemeRtd](https://github.com/typo3-documentation/t3SphinxThemeRtd) which is based on the [Read the Docs Sphinx theme](https://github.com/readthedocs/sphinx_rtd_theme).
