python-docs-theme 2026.4__tar.gz → 2026.7__tar.gz

python_docs_theme-2026.7/.babel.cfg

@@ -0,0 +1,3 @@
+[javascript: **.js]
+
+[jinja2: **.html]

python_docs_theme-2026.7/.github/dependabot.yml

@@ -0,0 +1,14 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: monthly
+    assignees:
+      - "ezio-melotti"
+    groups:
+      actions:
+        patterns:
+          - "*"
+    cooldown:
+      default-days: 7

python_docs_theme-2026.7/.github/release.yml

@@ -0,0 +1,5 @@
+changelog:
+  exclude:
+    authors:
+      - dependabot[bot]
+      - pre-commit-ci[bot]

python_docs_theme-2026.7/.github/workflows/lint.yml

@@ -0,0 +1,19 @@
+name: Lint
+
+on: [push, pull_request, workflow_dispatch]
+
+permissions: {}
+
+env:
+  FORCE_COLOR: 1
+  RUFF_OUTPUT_FORMAT: github
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+      - uses: j178/prek-action@bdca6f102f98e2b4c7029491a53dfd366469e33d # v2.0.4

python_docs_theme-2026.7/.github/workflows/pypi-package.yml

@@ -0,0 +1,52 @@
+name: Build & maybe upload PyPI package
+
+on:
+  push:
+  pull_request:
+  release:
+    types:
+      - published
+  workflow_dispatch:
+
+permissions: {}
+
+env:
+  FORCE_COLOR: 1
+
+jobs:
+  # Always build & lint package.
+  build-package:
+    name: Build & verify package
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+
+      - uses: hynek/build-and-inspect-python-package@d44ca7d91762de7a7d5436ddae667c6da6d1c3df # v2.18.0
+
+  # Upload to real PyPI on GitHub Releases.
+  release-pypi:
+    name: Publish to PyPI
+    environment: release-pypi
+    # Only run for published releases.
+    if: |
+      github.repository_owner == 'python'
+      && github.event.action == 'published'
+    runs-on: ubuntu-latest
+    needs: build-package
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download packages built by build-and-inspect-python-package
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: Packages
+          path: dist
+
+      - name: Upload package to PyPI
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0

python_docs_theme-2026.7/.github/workflows/tests.yml

@@ -0,0 +1,95 @@
+name: Tests
+
+on: [push, pull_request, workflow_dispatch]
+
+permissions: {}
+
+env:
+  FORCE_COLOR: 1
+
+jobs:
+  build_doc:
+    name: Build CPython docs
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.15", "3.14", "3.13", "3.12"]
+        include:
+          - python-version: "3.15"
+            branch: "main"
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+          cache: pip
+      - name: Clone docsbuild scripts
+        run: |
+          git clone https://github.com/python/docsbuild-scripts/
+      - name: Set up requirements
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r docsbuild-scripts/requirements.txt
+      - name: Build documentation
+        run: >
+          python ./docsbuild-scripts/build_docs.py
+          --quick
+          --build-root ./build_root
+          --www-root ./www
+          --log-directory ./logs
+          --group "$(id -g)"
+          --skip-cache-invalidation
+          --theme "$(pwd)"
+          --languages en
+          --branches ${{ matrix.branch || matrix.python-version }}
+          ${{ matrix.branch == 'main' && '--select-output no-html' || '' }}
+      - name: Show logs
+        if: failure()
+        run: |
+          cat ./logs/docsbuild.log
+      - name: Upload
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: doc-html-${{ matrix.python-version }}
+          path: www/
+
+  translations:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: ["ubuntu-latest", "windows-latest"]
+        # Test minimum supported and latest stable from 3.x series
+        python-version: ["3.12", "3"]
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+          cache: pip
+      - name: Install dependencies
+        run: |
+          pip install --upgrade pip
+          pip install -r requirements.txt
+      - name: Remove locale file for testing
+        shell: bash
+        run: rm -rf python_docs_theme/locale/pt_BR/
+      - run: python babel_runner.py extract
+      - run: python babel_runner.py init -l pt_BR
+      - run: python babel_runner.py update
+      - run: python babel_runner.py update -l pt_BR
+      - run: python babel_runner.py compile
+      - run: python babel_runner.py compile -l pt_BR
+      - name: Print .pot file
+        shell: bash
+        run: cat python_docs_theme/locale/python-docs-theme.pot
+      - name: Print .po file
+        shell: bash
+        run: cat python_docs_theme/locale/pt_BR/LC_MESSAGES/python-docs-theme.po

python_docs_theme-2026.7/.gitignore

@@ -0,0 +1,101 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/

python_docs_theme-2026.7/.pre-commit-config.yaml

@@ -0,0 +1,56 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.20
+    hooks:
+      - id: ruff-check
+        args: [--exit-non-zero-on-fix]
+
+  - repo: https://github.com/psf/black-pre-commit-mirror
+    rev: 26.5.1
+    hooks:
+      - id: black
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-case-conflict
+      - id: check-merge-conflict
+      - id: check-toml
+      - id: check-yaml
+      - id: debug-statements
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+
+  - repo: https://github.com/python-jsonschema/check-jsonschema
+    rev: 0.37.4
+    hooks:
+      - id: check-dependabot
+      - id: check-github-workflows
+
+  - repo: https://github.com/rhysd/actionlint
+    rev: v1.7.12
+    hooks:
+      - id: actionlint
+
+  - repo: https://github.com/zizmorcore/zizmor-pre-commit
+    rev: v1.26.1
+    hooks:
+      - id: zizmor
+
+  - repo: https://github.com/tox-dev/pyproject-fmt
+    rev: v2.25.1
+    hooks:
+      - id: pyproject-fmt
+
+  - repo: https://github.com/abravalheri/validate-pyproject
+    rev: v0.25
+    hooks:
+      - id: validate-pyproject
+
+  - repo: meta
+    hooks:
+      - id: check-hooks-apply
+      - id: check-useless-excludes
+
+ci:
+  autoupdate_schedule: quarterly

python_docs_theme-2026.7/.readthedocs.yml

@@ -0,0 +1,15 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+# Project page: https://readthedocs.org/projects/python-docs-theme-previews/
+
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3"
+
+  commands:
+    - git clone --depth=1 https://github.com/python/cpython
+    - make html CPYTHON_PATH=cpython
+    - mv cpython/Doc/build _readthedocs

python_docs_theme-2026.7/CHANGELOG.md

@@ -0,0 +1,273 @@
+# Changelog
+
+## [2026.7](https://github.com/python/python-docs-theme/releases/tag/2026.7)
+
+* Add Vietnamese translation by @StanFromIreland in https://github.com/python/python-docs-theme/pull/309
+* Switch to Hatchling build hooks for i18n packaging and exclude .po from wheels by @StanFromIreland in https://github.com/python/python-docs-theme/pull/312
+
+## [2026.4](https://github.com/python/python-docs-theme/releases/tag/2026.4)
+
+* Add styling for the `soft-deprecated` class by @StanFromIreland
+  in https://github.com/python/python-docs-theme/pull/305
+* Add Tamil translation in https://github.com/python/python-docs-theme/pull/304
+* Fix the vertical alignment of `:Editor:` by @pradyunsg in
+  https://github.com/python/python-docs-theme/pull/303
+
+## [2026.3](https://github.com/python/python-docs-theme/releases/tag/2026.3)
+
+* Add colors for new thread-safety levels by @lysnikolaou in https://github.com/python/python-docs-theme/pull/299
+
+## [2026.2](https://github.com/python/python-docs-theme/releases/tag/2026.2)
+
+* Style codeblock `:caption:` by @StanFromIreland in https://github.com/python/python-docs-theme/pull/288
+* Enable copy button for shell sessions and consoles by @hugovk in https://github.com/python/python-docs-theme/pull/295
+* Add colors for thread safety annotations by @lysnikolaou in https://github.com/python/python-docs-theme/pull/297
+
+## [2025.12](https://github.com/python/python-docs-theme/releases/tag/2025.12)
+
+* Add support for green, red and yellow side borders for code examples by @hugovk in https://github.com/python/python-docs-theme/pull/285
+* Add Portuguese translation by @NyaPuma in https://github.com/python/python-docs-theme/pull/281
+* Add support for Python 3.15 by @hugovk in https://github.com/python/python-docs-theme/pull/282
+* Convert CHANGELOG and CONTRIBUTING from .rst to .md by @hugovk in https://github.com/python/python-docs-theme/pull/277
+* Add zizmor to CI and fix findings by @hugovk in https://github.com/python/python-docs-theme/pull/283
+
+## [2025.10](https://github.com/python/python-docs-theme/releases/tag/2025.10)
+
+* Add Romanian translation by @octaG-M in https://github.com/python/python-docs-theme/pull/272
+* Add Arabic and Russian translations by @StanFromIreland in https://github.com/python/python-docs-theme/pull/274
+* Add French translation by @JulienPalard in https://github.com/python/python-docs-theme/pull/275
+* Update authors in `pyproject.toml` by @StanFromIreland in https://github.com/python/python-docs-theme/pull/271
+* Add link to devguide in README by @StanFromIreland in https://github.com/python/python-docs-theme/pull/266
+
+## [2025.9.2](https://github.com/python/python-docs-theme/releases/tag/2025.9.2)
+
+* Add Korean and Indonesian translations from Transifex in https://github.com/python/python-docs-theme/pull/264
+* Add German translation by @cmaureir in https://github.com/python/python-docs-theme/pull/262
+* Fix compilation of translations and loading of translations on pages with html
+  source in https://github.com/python/python-docs-theme/pull/263
+* Fix search button cutting off long translations in https://github.com/python/python-docs-theme/pull/268
+* Fix `Copy` button copying line numbers by @StanFromIreland in https://github.com/python/python-docs-theme/pull/270
+
+## [2025.9.1](https://github.com/python/python-docs-theme/releases/tag/2025.9.1)
+
+* Add Japanese, Turkish and Spanish translations from Transifex in https://github.com/python/python-docs-theme/pull/259
+
+## [2025.9](https://github.com/python/python-docs-theme/releases/tag/2025.9)
+
+* Enable theme translation and add Polish by @StanFromIreland in https://github.com/python/python-docs-theme/pull/246
+* Add Greek translation by @lysnikolaou and @skpanagiotis in https://github.com/python/python-docs-theme/pull/256 and https://github.com/python/python-docs-theme/pull/257
+* Add Swedish translation by @yeager in https://github.com/python/python-docs-theme/pull/250
+* Add Brazilian Portuguese, Simplified Chinese and Traditional Chinese translations from [Transifex](https://explore.transifex.com/python-doc/python-docs-theme/) in https://github.com/python/python-docs-theme/pull/253
+
+## [2025.5](https://github.com/python/python-docs-theme/releases/tag/2025.5)
+
+* Make the copy button only appear when hovered over or clicked on by @kevteg in https://github.com/python/python-docs-theme/pull/243
+
+## [2025.4.1](https://github.com/python/python-docs-theme/releases/tag/2025.4.1)
+
+* Fix copy button with multiple tracebacks by @tomasr8 in https://github.com/python/python-docs-theme/pull/240
+
+## [2025.4](https://github.com/python/python-docs-theme/releases/tag/2025.4)
+
+* Require Sphinx 7.3 by @AA-Turner in https://github.com/python/python-docs-theme/pull/221
+* Add support for Python 3.14 by @hugovk https://github.com/python/python-docs-theme/pull/236
+* Drop support for Python 3.10 and 3.11 by @hugovk in https://github.com/python/python-docs-theme/pull/234
+* Add a copy button to code samples by @tomasr8 in https://github.com/python/python-docs-theme/pull/231
+* Add missing i18n for copy button titles by @tomasr8 in https://github.com/python/python-docs-theme/pull/225
+* Use consistent line-height for light & dark theme by @tomasr8 in https://github.com/python/python-docs-theme/pull/227
+* Remove self-closing tags by @hugovk in https://github.com/python/python-docs-theme/pull/226
+* Replace deprecated classifier with licence expression (PEP 639) by @hugovk in https://github.com/python/python-docs-theme/pull/237
+
+## [2025.2](https://github.com/python/python-docs-theme/releases/tag/2025.2)
+
+- Note minimum requirements for Sphinx (#216)
+    Contributed by Adam Turner
+- Horizontally centre the sidebar collapse button (#219)
+    Contributed by Tomas Roun
+- Make sidebar width more flexible (#218)
+    Contributed by Tomas Roun
+- Set `__version__` in the runtime package (#222)
+    Contributed by Adam Turner
+
+## [2024.12](https://github.com/python/python-docs-theme/releases/tag/2024.12)
+
+- Hide header and search bar when printing (#204)
+    Contributed by Hugo van Kemenade
+
+## [2024.10](https://github.com/python/python-docs-theme/releases/tag/2024.10)
+
+- Add support for Python 3.13 (#196)
+    Contributed by Hugo van Kemenade
+- Drop support for Python 3.8 (#197)
+    Contributed by Hugo van Kemenade
+- Add script for handling translations (#195)
+    Contributed by Rafael Fontenelle
+- Generate digital attestations for PyPI (PEP 740) (#198)
+    Contributed by Hugo van Kemenade
+
+## [2024.6](https://github.com/python/python-docs-theme/releases/tag/2024.6)
+
+- Add backgrounds and borders to admonitions (#190)
+    Contributed by Hugo van Kemenade
+- Use different colour for 'Return value: Borrowed reference' (#188)
+    Contributed by Hugo van Kemenade
+
+## [2024.4](https://github.com/python/python-docs-theme/releases/tag/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](https://github.com/python/python-docs-theme/releases/tag/2024.3)
+
+- Modernise font: use system font stack to improve text readability and webpage performance (#174)
+    Contributed by Hugo van Kemenade
+- Remove incorrect CSS property (#178)
+    Contributed by Kerim Kabirov
+
+## [2024.2](https://github.com/python/python-docs-theme/releases/tag/2024.2)
+
+- Do not underline navigation links (#169)
+   Contributed by Hugo van Kemenade
+- Only apply underline offset to code formatting for underline visibility (#171)
+   Contributed by Hugo van Kemenade
+
+## [2024.1](https://github.com/python/python-docs-theme/releases/tag/2024.1)
+
+- Underline links for readability and a11y (#160, #166)
+   Contributed by Hugo van Kemenade
+- Add `hosted_on` variable for a link in the footer (#165)
+   Contributed by Hugo van Kemenade
+- Consistently reference `theme_root_icon` (#163)
+   Contributed by Marko Budiselic
+- Dark mode: fix contrast of footer highlight (#162)
+   Contributed by Hugo van Kemenade
+
+## [2023.9](https://github.com/python/python-docs-theme/releases/tag/2023.9)
+
+- Focus search box when pressing slash (#153)
+   Contributed by Hugo van Kemenade
+
+## [2023.8](https://github.com/python/python-docs-theme/releases/tag/2023.8)
+
+- Add Python 3.12 and 3.13 classifiers (#147)
+   Contributed by Hugo van Kemenade
+- Dark mode: Also give aside.topic a dark background (#150)
+   Contributed by Hugo van Kemenade
+- Restore the menu on mobile devices (inadvertently broken in 2023.7) (#146)
+   Contributed by Hugo van Kemenade
+
+## [2023.7](https://github.com/python/python-docs-theme/releases/tag/2023.7)
+
+- Fix compatibility with Sphinx 7.1 (#137)
+   Contributed by Pradyun Gedam
+- Enable the slash keypress to focus the search field (#141)
+   Contributed by Mike Fiedler
+- Sphinx 6.2 fix: add `nav.contents` where `div.topic` is used (#138)
+   Contributed by Hugo van Kemenade
+- Dark mode: fix contrast for C++ specific styling (#133)
+   Contributed by Hugo van Kemenade
+- Don't let long code literals extend beyond the right side of the screen (#139)
+   Contributed by Hugo van Kemenade
+- Test with Python 3.12 (#140)
+   Contributed by Hugo van Kemenade
+
+## [2023.5](https://github.com/python/python-docs-theme/releases/tag/2023.5)
+
+- Add a dark theme. (#44)
+   Contributed by Nils K
+- Fix: Remove searchbox id from form. (fixes #117)
+   Contributed by Nils K
+- Update `python-docs-theme` to work with Sphinx 5 & 6. (#99 & #127)
+   Contributed by Adam Turner
+- Override font for `.sig` for consistency with other code blocks. (#121)
+   Contributed by Chris Warrick
+- Dark mode: add class to invert image brightness. (#128)
+   Contributed by Hugo van Kemenade
+
+
+## [2023.3.1](https://github.com/python/python-docs-theme/releases/tag/2023.3.1)
+
+- Skip cache-busting for old Sphinx #113
+
+
+## [2023.3](https://github.com/python/python-docs-theme/releases/tag/2023.3)
+
+- Fix problem with monospace rendering in Vivaldi #104
+- Fix mobile nav obstructing content #96
+- Reduce footer margin only for desktop #106
+- Append a hash ?digest to CSS files for cache-busting #108
+
+
+## [2022.1](https://github.com/python/python-docs-theme/releases/tag/2022.1)
+
+- Add a configuration for license URL. (#90)
+- Exclude the floating navbar from CHM help. (#84)
+- Make sidebar scrollable and sticky (on modern browsers) (#91)
+
+
+## [2021.11.1](https://github.com/python/python-docs-theme/releases/tag/2021.11.1)
+
+- Fix monospace again, on buggy Google Chrome (#87)
+   Contributed by Tushar Sadhwani
+
+
+## [2021.11](https://github.com/python/python-docs-theme/releases/tag/2021.11)
+
+- Fix monospace on buggy Google Chrome (#85)
+   Contributed by Tushar Sadhwani
+
+
+## [2021.8](https://github.com/python/python-docs-theme/releases/tag/2021.8)
+
+- Add the copyright_url variable in the theme (#67)
+   Contributed by jablonskidev
+- Improve readability (#79)
+   Contributed by Olga Bulat
+- Remove #searchbox on mobile to fix a layout bug (#76)
+   Contributed by Olga Bulat
+- Fix the appearance of version/language selects (#74)
+   Contributed by Olga Bulat
+
+
+## [2021.5](https://github.com/python/python-docs-theme/releases/tag/2021.5)
+
+- Make the theme responsive (#46)
+   Contributed by Olga Bulat.
+- Use Python 3.8 for the Github Actions (#71)
+   Contributed by Stéphane Wirtel.
+- Use default pygments theme (#68)
+   Contributed by Aaron Carlisle.
+- Test Github action to validate the theme against docsbuild scripts. (#69)
+   Contributed by Julien Palard.
+- Add the copy button to pycon3 highlighted code blocks. (#64)
+   Contributed by Julien Palard.
+
+
+## [2020.12](https://github.com/python/python-docs-theme/releases/tag/v2020.12)
+
+- Updated the readme, to remind user to install the package in a virtual environment. (#41)
+   Contributed by Mariatta.
+- Updated the package url, using the GitHub repository instead of docs.python.org (#49)
+   Contributed by Pradyun Gedam.
+- Added license information to the footer of the doc (#36)
+   Contributed by Todd.
+- Fixed typo in the footer (#52)
+   Contributed by Dominic Davis-Foster.
+- Added information on how to use the package (#32)
+   Contributed by Tapasweni Pathak.
+- Fixed code formatting (#53).
+   Contributed by Hugo van Kemenade.
+- Fixed code bgcolor and codetextcolor for Sphinx 3.1.0+ (#57)
+   Contributed by Zhiming Wang.
+
+## 2018.7
+Corresponds to [44a8f30](https://github.com/python/python-docs-theme/commit/44a8f306db9ec86d277a8a687538d5d51e415130)
+
+
+## [2018.2](https://github.com/python/python-docs-theme/releases/tag/2018.2)
+
+Initial release.

python_docs_theme-2026.7/CONTRIBUTING.md

@@ -0,0 +1,27 @@
+# How to release
+
+- Update `CHANGELOG.md`
+- Bump version (YYYY.MM) in `python_docs_theme/__init__.py`
+- Commit
+- Push to check tests pass on
+  [GitHub Actions](https://github.com/python/python-docs-theme/actions)
+- Go to https://github.com/python/python-docs-theme/releases
+- Click "Draft a new release"
+- Click "Tag: Select tag"
+- Type the next YYYY.MM version (no leading zero) and
+  select "Create new tag"
+- Click "Create" for "YYYY.MM will be created on publish"
+- Leave the "Release title" blank (it will be autofilled)
+- Click "Generate release notes" and amend as required
+- Click "Publish release"
+- Check the tagged [GitHub Actions build](https://github.com/python/python-docs-theme/actions/workflows/pypi-package.yml)
+  has deployed to [PyPI](https://pypi.org/project/python-docs-theme/#history)
+
+# Makefile usage
+
+This project includes a simple Makefile for syncing changes to the theme with
+the main CPython repository. Run `make help` for details on available rules.
+
+There is one configurable variable, `CPYTHON_PATH`, which should be the path
+to the CPython repository on your machine. By default, it points to
+`../cpython`.

python_docs_theme-2026.7/Makefile

@@ -0,0 +1,30 @@
+# You can set these variables from the command line.
+CPYTHON_PATH = ../cpython
+PYTHON       = python3
+SPHINXOPTS   =
+
+
+.PHONY: help
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  venv       to create a venv with necessary tools at $(CPYTHON_PATH)/Doc/venv"
+	@echo "  html       to make standalone CPython HTML files"
+	@echo "  htmlview   to open the index page built by the html target in your browser"
+
+.PHONY: venv
+venv:
+	$(PYTHON) -m pip install build
+	rm -rf dist/
+	$(PYTHON) -m build
+	cd $(CPYTHON_PATH)/Doc \
+		&& make venv \
+		&& ./venv/bin/pip install $(CURDIR)/dist/python_docs_theme-*.tar.gz
+
+.PHONY: html
+html: venv
+	cd $(CPYTHON_PATH)/Doc && \
+		make SPHINXOPTS="$(SPHINXOPTS)" html
+
+.PHONY: htmlview
+htmlview: html
+	$(PYTHON) -c "import os, webbrowser; webbrowser.open('file://' + os.path.realpath('$(CPYTHON_PATH)/Doc/build/html/index.html'))"

{python_docs_theme-2026.4 → python_docs_theme-2026.7}/PKG-INFO

@@ -1,11 +1,14 @@
 Metadata-Version: 2.4
 Name: python-docs-theme
-Version: 2026.4
+Version: 2026.7
 Summary: The Sphinx theme for the CPython docs and related projects
+Project-URL: Issue tracker, https://github.com/python/python-docs-theme/issues
+Project-URL: Code, https://github.com/python/python-docs-theme
+Project-URL: Download, https://pypi.org/project/python-docs-theme/
+Project-URL: Homepage, https://github.com/python/python-docs-theme/
 Author: Python Docs Sphinx Theme maintainers
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
 License-Expression: PSF-2.0
+License-File: LICENSE
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Framework :: Sphinx :: Theme
 Classifier: Intended Audience :: Developers
@@ -18,12 +21,9 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Documentation
 Classifier: Topic :: Software Development :: Documentation
-License-File: LICENSE
+Requires-Python: >=3.12
 Requires-Dist: sphinx>=7.3
-Project-URL: Code, https://github.com/python/python-docs-theme
-Project-URL: Download, https://pypi.org/project/python-docs-theme/
-Project-URL: Homepage, https://github.com/python/python-docs-theme/
-Project-URL: Issue tracker, https://github.com/python/python-docs-theme/issues
+Description-Content-Type: text/markdown
 
 # Python Docs Sphinx Theme
 
@@ -65,4 +65,3 @@ See a demo of the CPython docs using this theme:
 The kitchen sink is a showcase of every Sphinx feature:
 
 - https://sphinx-themes.org/sample-sites/python-docs-theme/kitchen-sink/
-

python_docs_theme-2026.7/babel_runner.py

@@ -0,0 +1,146 @@
+"""Script for handling translations with Babel"""
+
+from __future__ import annotations
+
+import argparse
+import ast
+import subprocess
+import tomllib
+from pathlib import Path
+
+from hatchling.builders.hooks.plugin.interface import BuildHookInterface
+
+# Global variables used by pybabel below (paths relative to PROJECT_DIR)
+DOMAIN = "python-docs-theme"
+COPYRIGHT_HOLDER = "Python Software Foundation"
+SOURCE_DIR = "python_docs_theme"
+MAPPING_FILE = ".babel.cfg"
+
+PROJECT_DIR = Path(__file__).resolve().parent
+PYPROJECT_TOML = Path(PROJECT_DIR, "pyproject.toml")
+INIT_PY = PROJECT_DIR / SOURCE_DIR / "__init__.py"
+LOCALES_DIR = Path(f"{SOURCE_DIR}", "locale")
+POT_FILE = Path(LOCALES_DIR, f"{DOMAIN}.pot")
+
+
+def get_project_info() -> dict:
+    """Retrieve project's info to populate the message catalog template"""
+    pyproject_text = PYPROJECT_TOML.read_text(encoding="utf-8")
+    project_data = tomllib.loads(pyproject_text)["project"]
+
+    # read __version__ from __init__.py
+    for child in ast.parse(INIT_PY.read_bytes()).body:
+        if not isinstance(child, ast.Assign):
+            continue
+        target = child.targets[0]
+        if not isinstance(target, ast.Name) or target.id != "__version__":
+            continue
+        version_node = child.value
+        if not isinstance(version_node, ast.Constant):
+            continue
+        project_data["version"] = version_node.value
+        break
+
+    return project_data
+
+
+def extract_messages() -> None:
+    """Extract messages from all source files into message catalog template"""
+    Path(PROJECT_DIR, LOCALES_DIR).mkdir(parents=True, exist_ok=True)
+    project_data = get_project_info()
+    subprocess.run(
+        [
+            "pybabel",
+            "extract",
+            "-F",
+            MAPPING_FILE,
+            "--copyright-holder",
+            COPYRIGHT_HOLDER,
+            "--project",
+            project_data["name"],
+            "--version",
+            project_data["version"],
+            "--msgid-bugs-address",
+            project_data["urls"]["Issue tracker"],
+            "-o",
+            POT_FILE,
+            SOURCE_DIR,
+        ],
+        cwd=PROJECT_DIR,
+        check=True,
+    )
+
+
+def init_locale(locale: str) -> None:
+    """Initialize a new locale based on existing message catalog template"""
+    pofile = PROJECT_DIR / LOCALES_DIR / locale / "LC_MESSAGES" / f"{DOMAIN}.po"
+    if pofile.exists():
+        print(f"There is already a message catalog for locale {locale}, skipping.")
+        return
+    cmd = [
+        "pybabel",
+        "init",
+        "-i",
+        POT_FILE,
+        "-d",
+        LOCALES_DIR,
+        "-D",
+        DOMAIN,
+        "-l",
+        locale,
+    ]
+    subprocess.run(cmd, cwd=PROJECT_DIR, check=True)
+
+
+def update_catalogs(locale: str) -> None:
+    """Update translations from existing message catalogs"""
+    cmd = ["pybabel", "update", "-i", POT_FILE, "-d", LOCALES_DIR, "-D", DOMAIN]
+    if locale:
+        cmd.extend(["-l", locale])
+    subprocess.run(cmd, cwd=PROJECT_DIR, check=True)
+
+
+def compile_catalogs(locale: str) -> None:
+    """Compile existing message catalogs"""
+    cmd = ["pybabel", "compile", "-d", LOCALES_DIR, "-D", DOMAIN]
+    if locale:
+        cmd.extend(["-l", locale])
+    subprocess.run(cmd, cwd=PROJECT_DIR, check=True)
+
+
+class CustomBuildHook(BuildHookInterface):
+    def initialize(self, version: str, build_data: dict[str, object]) -> None:
+        compile_catalogs("")
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument(
+        "command",
+        choices=["extract", "init", "update", "compile"],
+        help="command to be executed",
+    )
+    parser.add_argument(
+        "-l",
+        "--locale",
+        default="",
+        help="language code (needed for init, optional for update and compile)",
+    )
+
+    args = parser.parse_args()
+    locale = args.locale
+
+    if args.command == "extract":
+        extract_messages()
+    elif args.command == "init":
+        if not locale:
+            parser.error("init requires passing the --locale option")
+        init_locale(locale)
+    elif args.command == "update":
+        update_catalogs(locale)
+    elif args.command == "compile":
+        compile_catalogs(locale)
+
+
+if __name__ == "__main__":
+    main()

{python_docs_theme-2026.4 → python_docs_theme-2026.7}/pyproject.toml

@@ -1,7 +1,8 @@
 [build-system]
-build-backend = "flit_core.buildapi"
+build-backend = "hatchling.build"
 requires = [
-  "flit-core>=3.7",
+  "babel",
+  "hatchling",
 ]
 
 [project]
@@ -36,9 +37,12 @@ urls.Download = "https://pypi.org/project/python-docs-theme/"
 urls.Homepage = "https://github.com/python/python-docs-theme/"
 entry-points."sphinx.html_themes".python_docs_theme = "python_docs_theme"
 
-[tool.flit]
-module.name = "python_docs_theme"
-sdist.include = [ "python_docs_theme/" ]
+[tool.hatch]
+version.path = "python_docs_theme/__init__.py"
+build.artifacts = [ "python_docs_theme/locale/**/*.mo" ]
+build.hooks.custom.path = "babel_runner.py"
+build.targets.wheel.packages = [ "python_docs_theme" ]
+build.targets.wheel.exclude = [ "python_docs_theme/locale/**/*.po" ]
 
 [tool.ruff]
 fix = true

{python_docs_theme-2026.4 → python_docs_theme-2026.7}/python_docs_theme/__init__.py

@@ -11,7 +11,7 @@ if TYPE_CHECKING:
     from sphinx.application import Sphinx
     from sphinx.util.typing import ExtensionMetadata
 
-__version__ = "2026.4"
+__version__ = "2026.7"
 
 THEME_PATH = Path(__file__).resolve().parent
 LOCALE_DIR = THEME_PATH / "locale"

{python_docs_theme-2026.4 → python_docs_theme-2026.7}/python_docs_theme/locale/de/LC_MESSAGES/python-docs-theme.po

@@ -7,7 +7,6 @@
 # Translators:
 # Cristián Maureira-Fredes, 2025
 #
-#, fuzzy
 msgid ""
 msgstr ""
 "Project-Id-Version: python-docs-theme 2025.5\n"

python_docs_theme-2026.7/python_docs_theme/locale/vi/LC_MESSAGES/python-docs-theme.po

@@ -0,0 +1,129 @@
+# Translations template for python-docs-theme.
+# Copyright (C) 2026 Python Software Foundation
+# This file is distributed under the same license as the python-docs-theme
+# project.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2026.
+#
+# Translators:
+# Nguyen Duc Tam, 2026
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: python-docs-theme 2026.4\n"
+"Report-Msgid-Bugs-To: https://github.com/python/python-docs-theme/issues\n"
+"POT-Creation-Date: 2026-04-27 03:20+0000\n"
+"PO-Revision-Date: 2025-09-06 07:41+0000\n"
+"Last-Translator: Nguyen Duc Tam, 2026\n"
+"Language-Team: Vietnamese (https://app.transifex.com/python-doc/teams/5390/vi/)\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.18.0\n"
+"Language: vi\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+
+#: python_docs_theme/footerdonate.html:1
+msgid "The Python Software Foundation is a non-profit corporation."
+msgstr "Python Software Foundation là một tổ chức phi lợi nhuận."
+
+#: python_docs_theme/footerdonate.html:2
+msgid "Please donate."
+msgstr "Vui lòng quyên góp."
+
+#: python_docs_theme/layout.html:6
+msgid "Navigation"
+msgstr "Điều hướng"
+
+#: python_docs_theme/layout.html:51 python_docs_theme/layout.html:111
+msgid "Quick search"
+msgstr "Tìm kiếm nhanh"
+
+#: python_docs_theme/layout.html:52 python_docs_theme/layout.html:112
+msgid "Go"
+msgstr "Đi tiếp"
+
+#: python_docs_theme/layout.html:60
+msgid "Theme"
+msgstr "Theme"
+
+#: python_docs_theme/layout.html:62
+msgid "Auto"
+msgstr "Tự động"
+
+#: python_docs_theme/layout.html:63
+msgid "Light"
+msgstr "Sáng"
+
+#: python_docs_theme/layout.html:64
+msgid "Dark"
+msgstr " Tối"
+
+#: python_docs_theme/layout.html:96
+msgid "Menu"
+msgstr "Menu"
+
+#: python_docs_theme/layout.html:142
+msgid "Copyright"
+msgstr "Bản quyền"
+
+#: python_docs_theme/layout.html:147
+msgid ""
+"This page is licensed under the Python Software Foundation License Version "
+"2."
+msgstr ""
+"Trang này được cấp phép theo Giấy phép của Tổ chức Phần mềm Python Phiên bản"
+" 2."
+
+#: python_docs_theme/layout.html:149
+msgid ""
+"Examples, recipes, and other code in the documentation are additionally "
+"licensed under the Zero Clause BSD License."
+msgstr ""
+"Các ví dụ, hướng dẫn và mã nguồn khác trong tài liệu này còn được cấp phép "
+"bổ sung theo Giấy phép BSD Không Điều khoản."
+
+#: python_docs_theme/layout.html:152
+#, python-format
+msgid ""
+"See <a href=\"%(license_file)s\">History and License</a> for more "
+"information."
+msgstr ""
+"Xem <a href=\"%(license_file)s\">Lịch sử và Giấy phép</a> để biết thêm thông"
+" tin."
+
+#: python_docs_theme/layout.html:155
+#, python-format
+msgid "Hosted on %(hosted_on)s."
+msgstr "Được lưu trữ trên %(hosted_on)s."
+
+#: python_docs_theme/layout.html:163
+#, python-format
+msgid "Last updated on %(last_updated)s."
+msgstr "Cập nhật lần cuối vào %(last_updated)s."
+
+#: python_docs_theme/layout.html:166
+#, python-format
+msgid "<a href=\"%(theme_issues_url)s\">Found a bug</a>?"
+msgstr "<a href=\"%(theme_issues_url)s\">Tìm thấy lỗi</a>?"
+
+#: python_docs_theme/layout.html:170
+#, python-format
+msgid ""
+"Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
+"%(sphinx_version)s."
+msgstr ""
+"Được tạo bằng <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> "
+"%(sphinx_version)s. "
+
+#: python_docs_theme/static/copybutton.js:30
+#: python_docs_theme/static/copybutton.js:55
+msgid "Copy"
+msgstr "Sao chép"
+
+#: python_docs_theme/static/copybutton.js:31
+msgid "Copy to clipboard"
+msgstr "Sao chép vào clipboard"
+
+#: python_docs_theme/static/copybutton.js:53
+msgid "Copied!"
+msgstr "Đã sao chép!"

python_docs_theme-2026.7/requirements.txt

@@ -0,0 +1,4 @@
+# for babel_runner.py
+Babel
+hatchling
+Jinja2