diff --git a/README.rst b/README.md similarity index 61% rename from README.rst rename to README.md index 5055bad1..f77b4910 100644 --- a/README.rst +++ b/README.md @@ -1,5 +1,4 @@ -Python Docs Sphinx Theme -========================= +# Python Docs Sphinx Theme This is the theme for the Python documentation. @@ -10,22 +9,24 @@ projects if you so choose, but please keep in mind that in doing so you're also choosing to accept some of the responsibility for maintaining that collective trust. -To use the theme, install it into your docs build environment via ``pip`` +To use the theme, install it into your docs build environment via `pip` (preferably in a virtual environment). -Configuration options ---------------------- +## Configuration options -To use this theme, add the following to ``conf.py``: +To use this theme, add the following to `conf.py`: -- ``html_theme = 'python_docs_theme'`` +- `html_theme = 'python_docs_theme'` -- ``html_sidebars``, defaults taken from https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_sidebars +- `html_sidebars`, defaults taken from https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_sidebars -Preview -------- +## Preview See a demo of the CPython docs using this theme: - https://python-docs-theme-previews.readthedocs.io + +The kitchen sink is a showcase of every Sphinx feature: + +- https://sphinx-themes.org/sample-sites/python-docs-theme/kitchen-sink/ diff --git a/pyproject.toml b/pyproject.toml index fc5f5513..c376bbd3 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -8,7 +8,7 @@ requires = [ name = "python-docs-theme" version = "2024.3" description = "The Sphinx theme for the CPython docs and related projects" -readme = "README.rst" +readme = "README.md" license.file = "LICENSE" authors = [{name = "PyPA", email = "distutils-sig@python.org"}] requires-python = ">=3.8"