Metadata-Version: 2.1
Name: pydata-sphinx-theme
Version: 0.10.0rc1
Summary: Bootstrap-based Sphinx theme from the PyData community
Maintainer-Email: Joris Van den Bossche <jorisvandenbossche@gmail.com>
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Framework :: Sphinx
Classifier: Framework :: Sphinx :: Theme
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Requires-Dist: sphinx>=4.0.2
Requires-Dist: beautifulsoup4
Requires-Dist: docutils!=0.17.0
Requires-Dist: packaging
Requires-Dist: pygments>=2.7
Requires-Dist: sphinx<5,>=4; extra == "doc"
Requires-Dist: numpydoc; extra == "doc"
Requires-Dist: myst-nb; extra == "doc"
Requires-Dist: pytest; extra == "doc"
Requires-Dist: pytest-regressions; extra == "doc"
Requires-Dist: rich; extra == "doc"
Requires-Dist: sphinxext-rediraffe; extra == "doc"
Requires-Dist: sphinx-sitemap; extra == "doc"
Requires-Dist: jupyter_sphinx; extra == "doc"
Requires-Dist: pandas; extra == "doc"
Requires-Dist: plotly; extra == "doc"
Requires-Dist: matplotlib; extra == "doc"
Requires-Dist: numpy; extra == "doc"
Requires-Dist: xarray; extra == "doc"
Requires-Dist: sphinx-copybutton; extra == "doc"
Requires-Dist: sphinx-design; extra == "doc"
Requires-Dist: sphinx-togglebutton; extra == "doc"
Requires-Dist: nbsphinx; extra == "doc"
Requires-Dist: pytest; extra == "test"
Requires-Dist: pydata-sphinx-theme[doc]; extra == "test"
Requires-Dist: pytest-cov; extra == "coverage"
Requires-Dist: codecov; extra == "coverage"
Requires-Dist: pydata-sphinx-theme[test]; extra == "coverage"
Requires-Dist: pyyaml; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: nox; extra == "dev"
Requires-Dist: pydata-sphinx-theme[coverage]; extra == "dev"
Provides-Extra: doc
Provides-Extra: test
Provides-Extra: coverage
Provides-Extra: dev
Description-Content-Type: text/markdown

# The PyData Sphinx Theme

[![pypi](https://img.shields.io/pypi/v/pydata-sphinx-theme)](https://pypi.org/project/pydata-sphinx-theme/)
[![conda-forge](https://img.shields.io/conda/vn/conda-forge/pydata-sphinx-theme.svg)](https://anaconda.org/conda-forge/pydata-sphinx-theme)
[![continuous-integration](https://github.com/pydata/pydata-sphinx-theme/actions/workflows/tests.yml/badge.svg)](https://github.com/pydata/pydata-sphinx-theme/actions/workflows/tests.yml)
[![docs](https://readthedocs.org/projects/pydata-sphinx-theme/badge/)](https://readthedocs.org/projects/pydata-sphinx-theme/builds/)
[![codecov](https://codecov.io/gh/pydata/pydata-sphinx-theme/branch/main/graph/badge.svg?token=NwOObjYacn)](https://codecov.io/gh/pydata/pydata-sphinx-theme)

A clean, three-column, Bootstrap-based Sphinx theme by and for the [PyData community](https://pydata.org).

- 📚 Documentation: https://pydata-sphinx-theme.readthedocs.io/en/latest/
- 💡 Examples: https://pydata-sphinx-theme.readthedocs.io/en/latest/demo
- 🙌 Contribute: https://pydata-sphinx-theme.readthedocs.io/en/latest/contribute/index.html

[![demo site](./docs/_static/theme_landing.png)](https://pydata-sphinx-theme.readthedocs.io/en/stable)

## Installation and usage

The theme is available on PyPI and conda-forge. You can install
and use as follows:

- Install the `pydata-sphinx-theme` in your doc build environment:

  ```
  pip install pydata-sphinx-theme
  # or
  conda install pydata-sphinx-theme --channel conda-forge
  ```

- Then, in the `conf.py` of your sphinx docs, you update the `html_theme`
  configuration option:

  ```
  html_theme = "pydata_sphinx_theme"
  ```

And that's it!

> **Note**
> This theme may not work with the latest major versions of Sphinx, especially
> if they have only recently been released. Please give us a few months of
> time to work out any bugs and changes when new releases are made.
> See [our contributing documentation](docs/contribute/topics.md) for more information.

## Contribute to and develop the theme

Contributions are very welcome! Installing the development version, building
the demo docs and developing the css/js of the theme, etc, is explained in
more detail in the contributing section of the documentation:

- [Contributing documentation](https://pydata-sphinx-theme.readthedocs.io/en/stable/contribute/index.html)
