From 20d3e32d91f2ddec02a68df76e41447f7aff175d Mon Sep 17 00:00:00 2001 From: Dennis den Ouden-van der Horst Date: Fri, 16 Jan 2026 10:40:18 +0100 Subject: [PATCH 1/3] Release v1.1.0 with advanced section numbering Update version to 1.1.0 and changelog to document the new advanced section numbering customization feature. Minor cleanup in README to reflect recent changes. --- CHANGELOG.md | 8 ++++++++ README.md | 2 -- sphinx_external_toc/__init__.py | 2 +- 3 files changed, 9 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 74880e1..18c1dce 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,13 @@ # Change Log +## v1.1.0 - 2025-01-16 + +([full changelog](https://github.com/executablebooks/sphinx-external-toc/compare/v1.0.1...v1.1.0)) + +### Added + +- NEW: Advanced section numbering customization by @douden in https://github.com/executablebooks/sphinx-external-toc/pull/112 + ## v1.0.1 - 2023-12-12 ([full changelog](https://github.com/executablebooks/sphinx-external-toc/compare/v1.0.0...21adcf94ca0e09e7fbce21bf87734435520169f2)) diff --git a/README.md b/README.md index d0b4e52..2cdca4e 100644 --- a/README.md +++ b/README.md @@ -450,13 +450,11 @@ meta: {} Questions / TODOs: -- ~~Add additional top-level keys, e.g. `appendices` (see https://github.com/sphinx-doc/sphinx/issues/2502) and `bibliography`.~~ Can be replaced by setting the numbering style and (possibly) restarting the numbering. - Using `external_toc_exclude_missing` to exclude a certain file suffix: currently if you had files `doc.md` and `doc.rst`, and put `doc.md` in your ToC, it will add `doc.rst` to the excluded patterns but then, when looking for `doc.md`, will still select `doc.rst` (since it is first in `source_suffix`). Maybe open an issue on sphinx, that `doc2path` should respect exclude patterns. -- ~~Integrate https://github.com/executablebooks/sphinx-multitoc-numbering into this extension? (or upstream PR).~~ Included and enforced in this fork. - document suppressing warnings - test against orphan file - https://github.com/executablebooks/sphinx-book-theme/pull/304 diff --git a/sphinx_external_toc/__init__.py b/sphinx_external_toc/__init__.py index 417abcd..1f73abc 100644 --- a/sphinx_external_toc/__init__.py +++ b/sphinx_external_toc/__init__.py @@ -5,7 +5,7 @@ if TYPE_CHECKING: from sphinx.application import Sphinx -__version__ = "1.1.0-dev" +__version__ = "1.1.0" def setup(app: "Sphinx") -> dict: From 2e89ef77d71cf75672d46a39b7a58dca17276966 Mon Sep 17 00:00:00 2001 From: Dennis den Ouden-van der Horst Date: Fri, 16 Jan 2026 11:57:15 +0100 Subject: [PATCH 2/3] Add Codecov token to test workflow Sets the CODECOV_TOKEN secret in the Codecov upload step to ensure proper authentication during coverage reporting. --- .github/workflows/tests.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 7616bb6..7858876 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -48,6 +48,7 @@ jobs: flags: pytests file: ./coverage.xml fail_ci_if_error: false # uploading coverage should not fail the tests + token: ${{ secrets.CODECOV_TOKEN }} publish: From 75b6710c3ec3df887d1db6c664248bd3f0025ffe Mon Sep 17 00:00:00 2001 From: Dennis den Ouden-van der Horst Date: Fri, 16 Jan 2026 11:59:49 +0100 Subject: [PATCH 3/3] Revert Codecov action to v3 in CI workflow Changed the Codecov GitHub Action from v4 to v3 in the test workflow for Python 3.14. This may address compatibility or stability issues with the newer version. --- .github/workflows/tests.yml | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 7858876..a6aec63 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -42,13 +42,12 @@ jobs: pytest --cov=sphinx_external_toc --cov-report=xml --cov-report=term-missing - name: Upload to Codecov if: matrix.python-version == '3.14' - uses: codecov/codecov-action@v4 + uses: codecov/codecov-action@v3 with: name: pytests-py3.14 flags: pytests file: ./coverage.xml fail_ci_if_error: false # uploading coverage should not fail the tests - token: ${{ secrets.CODECOV_TOKEN }} publish: