diff --git a/.github/release.yml b/.github/release.yml new file mode 100644 index 00000000..9d1e0987 --- /dev/null +++ b/.github/release.yml @@ -0,0 +1,5 @@ +changelog: + exclude: + authors: + - dependabot + - pre-commit-ci diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 07f7d4c7..6ba1903c 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -1,6 +1,16 @@ Changelog ========= +`2024.4 `_ +---------------------------------------------------------------------------- + +- Add colour to version change directives (#185) + Contributed by Hugo van Kemenade +- Only show 'Last updated on ...' when ``last_updated`` defined (#183) + Contributed by Hugo van Kemenade +- Use system font stack for all code (#186) + Contributed by Hugo van Kemenade + `2024.3 `_ ---------------------------------------------------------------------------- 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..9e46db68 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -6,9 +6,9 @@ requires = [ [project] name = "python-docs-theme" -version = "2024.3" +version = "2024.4" 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" diff --git a/python_docs_theme/layout.html b/python_docs_theme/layout.html index d387ef38..9762b06c 100644 --- a/python_docs_theme/layout.html +++ b/python_docs_theme/layout.html @@ -136,21 +136,35 @@

{{ _('Navigation') }}

{% block footer %}
- © {% if theme_copyright_url or hasdoc('copyright') %}{% endif %}{% trans %}Copyright{% endtrans %}{% if theme_copyright_url or hasdoc('copyright') %}{% endif %} {{ copyright|e }}. + © {% if theme_copyright_url or hasdoc('copyright') %} + + {% endif %} + {% trans %}Copyright{% endtrans %} + {% if theme_copyright_url or hasdoc('copyright') %} + + {% endif %} {{ copyright|e }}.
{% trans %}This page is licensed under the Python Software Foundation License Version 2.{% endtrans %}
{% trans %}Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.{% endtrans %}
- {% if theme_license_url %}{% trans license_file=theme_license_url %}See History and License for more information.{% endtrans %}
{% endif %} - {% if theme_hosted_on %}{% trans hosted_on=theme_hosted_on %}Hosted on {{ hosted_on }}.{% endtrans %}
{% endif %} + {% if theme_license_url %} + {% trans license_file=theme_license_url %}See History and License for more information.{% endtrans %}
+ {% endif %} + {% if theme_hosted_on %} + {% trans hosted_on=theme_hosted_on %}Hosted on {{ hosted_on }}.{% endtrans %}
+ {% endif %}
{% include "footerdonate.html" %}
- {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %} - {% if theme_issues_url %}{% trans %}Found a bug?{% endtrans %}{% endif %} + {%- if last_updated %} + {% trans last_updated=last_updated|e %}Last updated on {{ last_updated }}.{% endtrans %} + {%- endif %} + {% if theme_issues_url %} + {% trans %}Found a bug?{% endtrans %} + {% endif %}
{% trans sphinx_version=sphinx_version|e %}Created using Sphinx {{ sphinx_version }}.{% endtrans %} diff --git a/python_docs_theme/static/pydoctheme.css b/python_docs_theme/static/pydoctheme.css index 39c4e333..0d7840c0 100644 --- a/python_docs_theme/static/pydoctheme.css +++ b/python_docs_theme/static/pydoctheme.css @@ -333,7 +333,7 @@ div.footer a:hover { dl > dt span ~ em, .sig { - font-family: ui-monospace, "Cascadia Mono", "Segoe UI Mono", "Liberation Mono", Menlo, Monaco, Consolas, monospace; + font-family: Menlo, Consolas, Monaco, Liberation Mono, Lucida Console, monospace; } .toctree-wrapper ul { @@ -622,3 +622,50 @@ div.genindex-jumpbox a { margin-top: -2em; } } + +/* Version change directives */ +:root { + --versionadded: rgb(41 100 51); + --versionchanged: rgb(133 72 38); + --deprecated: rgb(159 49 51); + + --versionadded-border: rgb(79 196 100); + --versionchanged-border: rgb(244, 227, 76); + --deprecated-border: rgb(244, 76, 78); +} + +div.versionadded, +div.versionchanged, +div.deprecated, +div.deprecated-removed { + border-left: 3px solid; + padding: 0 1rem; +} + +div.versionadded { + border-left-color: var(--versionadded-border); +} + +div.versionchanged { + border-left-color: var(--versionchanged-border); +} + +div.deprecated, +div.deprecated-removed, +div.versionremoved { + border-left-color: var(--deprecated-border); +} + +div.versionadded .versionmodified { + color: var(--versionadded); +} + +div.versionchanged .versionmodified { + color: var(--versionchanged); +} + +div.deprecated .versionmodified, +div.deprecated-removed .versionmodified, +div.versionremoved .versionmodified { + color: var(--deprecated); +} diff --git a/python_docs_theme/static/pydoctheme_dark.css b/python_docs_theme/static/pydoctheme_dark.css index 758d3de6..cae6eae6 100644 --- a/python_docs_theme/static/pydoctheme_dark.css +++ b/python_docs_theme/static/pydoctheme_dark.css @@ -140,3 +140,10 @@ img.invert-in-dark-mode { .sig.cpp .k, .sig.cpp .kt { color: #5283ff; } + +/* Version change directives */ +:root { + --versionadded: rgb(79 196 100); + --versionchanged: rgb(244, 227, 76); + --deprecated: rgb(244, 76, 78); +}