From 9cbbdbce133316d11272545ae8bf8394fc17cbfe Mon Sep 17 00:00:00 2001 From: Clemens Brunner Date: Tue, 22 Jul 2025 13:40:55 +0200 Subject: [PATCH 1/9] Ignore linkcheck for ATLAS URL --- source/conf.py | 1 + 1 file changed, 1 insertion(+) diff --git a/source/conf.py b/source/conf.py index 7a05613ea..21cac0e9b 100644 --- a/source/conf.py +++ b/source/conf.py @@ -147,6 +147,7 @@ "https://anaconda.org", "https://www.cisa.gov/sbom", "https://developers.redhat.com/products/softwarecollections/overview", + "https://math-atlas.sourceforge.net/", ] linkcheck_retries = 5 # Ignore anchors for common targets when we know they likely won't be found From 7f675d8e701ce55924a0f8eb9f7dc995b92018e7 Mon Sep 17 00:00:00 2001 From: Clemens Brunner Date: Tue, 22 Jul 2025 13:53:44 +0200 Subject: [PATCH 2/9] Fix regex --- source/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/conf.py b/source/conf.py index 21cac0e9b..2995ce190 100644 --- a/source/conf.py +++ b/source/conf.py @@ -147,7 +147,7 @@ "https://anaconda.org", "https://www.cisa.gov/sbom", "https://developers.redhat.com/products/softwarecollections/overview", - "https://math-atlas.sourceforge.net/", + "https://math-atlas\\.sourceforge\\.net/?", ] linkcheck_retries = 5 # Ignore anchors for common targets when we know they likely won't be found From fa92ece30c88874efb4611e0e679a08ad7c174e1 Mon Sep 17 00:00:00 2001 From: Clemens Brunner Date: Tue, 22 Jul 2025 15:24:05 +0200 Subject: [PATCH 3/9] Quick sanity check --- source/guides/installing-scientific-packages.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/source/guides/installing-scientific-packages.rst b/source/guides/installing-scientific-packages.rst index a1aeae567..152a8350c 100644 --- a/source/guides/installing-scientific-packages.rst +++ b/source/guides/installing-scientific-packages.rst @@ -19,8 +19,7 @@ of different levels of vectorized instructions available in modern CPUs. Starting with version 1.10.4 of NumPy and version 1.0.0 of SciPy, pre-built 32-bit and 64-bit binaries in the ``wheel`` format are available for all major operating systems (Windows, macOS, and Linux) on PyPI. Note, however, that on -Windows, NumPy binaries are linked against the `ATLAS -`__ BLAS/LAPACK library, restricted to SSE2 +Windows, NumPy binaries are linked against the ATLAS BLAS/LAPACK library, restricted to SSE2 instructions, so they may not provide optimal linear algebra performance. There are a number of alternative options for obtaining scientific Python From 0fcbcccf4c1e6253cfa1221914e5da79e6a850f9 Mon Sep 17 00:00:00 2001 From: Clemens Brunner Date: Tue, 22 Jul 2025 15:30:48 +0200 Subject: [PATCH 4/9] Verbose --- noxfile.py | 1 + 1 file changed, 1 insertion(+) diff --git a/noxfile.py b/noxfile.py index 698e82f9d..de3106445 100644 --- a/noxfile.py +++ b/noxfile.py @@ -87,6 +87,7 @@ def linkcheck(session): "-n", "-W", "--keep-going", # be strict + "-vvv", "source", # where the rst files are located "build", # where to put the check output ) From 403e8ac53f06daf832dd35a5d6b1c994ca1b6964 Mon Sep 17 00:00:00 2001 From: Clemens Brunner Date: Tue, 22 Jul 2025 15:35:06 +0200 Subject: [PATCH 5/9] Revert "Quick sanity check" This reverts commit fa92ece30c88874efb4611e0e679a08ad7c174e1. --- noxfile.py | 1 - source/guides/installing-scientific-packages.rst | 3 ++- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/noxfile.py b/noxfile.py index de3106445..698e82f9d 100644 --- a/noxfile.py +++ b/noxfile.py @@ -87,7 +87,6 @@ def linkcheck(session): "-n", "-W", "--keep-going", # be strict - "-vvv", "source", # where the rst files are located "build", # where to put the check output ) diff --git a/source/guides/installing-scientific-packages.rst b/source/guides/installing-scientific-packages.rst index 152a8350c..a1aeae567 100644 --- a/source/guides/installing-scientific-packages.rst +++ b/source/guides/installing-scientific-packages.rst @@ -19,7 +19,8 @@ of different levels of vectorized instructions available in modern CPUs. Starting with version 1.10.4 of NumPy and version 1.0.0 of SciPy, pre-built 32-bit and 64-bit binaries in the ``wheel`` format are available for all major operating systems (Windows, macOS, and Linux) on PyPI. Note, however, that on -Windows, NumPy binaries are linked against the ATLAS BLAS/LAPACK library, restricted to SSE2 +Windows, NumPy binaries are linked against the `ATLAS +`__ BLAS/LAPACK library, restricted to SSE2 instructions, so they may not provide optimal linear algebra performance. There are a number of alternative options for obtaining scientific Python From b9bb306c0069088f5f7bc18839e94f64ab71daed Mon Sep 17 00:00:00 2001 From: Clemens Brunner Date: Tue, 22 Jul 2025 15:45:31 +0200 Subject: [PATCH 6/9] Fix ignores --- source/conf.py | 28 ++++++++++++++++------------ 1 file changed, 16 insertions(+), 12 deletions(-) diff --git a/source/conf.py b/source/conf.py index 2995ce190..5e79a80fe 100644 --- a/source/conf.py +++ b/source/conf.py @@ -132,28 +132,32 @@ # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-the-linkcheck-builder linkcheck_ignore = [ - "http://localhost:\\d+", - "https://packaging.python.org/en/latest/specifications/schemas/.*", - "https://test.pypi.org/project/example-package-YOUR-USERNAME-HERE", - "https://pypi.org/manage/*", - "https://test.pypi.org/manage/*", + r"http://localhost:\d+", + r"https://packaging.python.org/en/latest/specifications/schemas/.*", + r"https://test.pypi.org/project/example-package-YOUR-USERNAME-HERE", + r"https://pypi.org/manage/.*", + r"https://test.pypi.org/manage/.*", # Temporarily ignored. Ref: # https://github.com/pypa/packaging.python.org/pull/1308#issuecomment-1775347690 - "https://www.breezy-vcs.org/*", + r"https://www.breezy-vcs.org/.*", # Ignore while StackOverflow is blocking GitHub CI. Ref: # https://github.com/pypa/packaging.python.org/pull/1474 - "https://stackoverflow.com/*", - "https://pyscaffold.org/*", - "https://anaconda.org", - "https://www.cisa.gov/sbom", - "https://developers.redhat.com/products/softwarecollections/overview", - "https://math-atlas\\.sourceforge\\.net/?", + r"https://stackoverflow.com/.*", + r"https://pyscaffold.org/.*", + r"https://anaconda.org", + r"https://www.cisa.gov/sbom", + r"https://developers.redhat.com/products/softwarecollections/overview", + r"https://math-atlas\.sourceforge\.net/?", + # Self-signed certificate, fails in CI + r"https://click\.palletsprojects\.com/.*", + r"https://typer\.tiangolo\.com/.*", ] linkcheck_retries = 5 # Ignore anchors for common targets when we know they likely won't be found linkcheck_anchors_ignore_for_url = [ # GitHub synthesises anchors in JavaScript, so Sphinx can't find them in the HTML r"https://github\.com/", + r"https://docs\.github\.com/", # While PyPI has its botscraping defenses active, Sphinx can't resolve the anchors # https://github.com/pypa/packaging.python.org/issues/1744 r"https://pypi\.org/", From 403649c5f0892f0b74e291a3dcd3338cf8e1c022 Mon Sep 17 00:00:00 2001 From: Clemens Brunner Date: Tue, 22 Jul 2025 15:46:48 +0200 Subject: [PATCH 7/9] Fix regexes --- source/conf.py | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/source/conf.py b/source/conf.py index 5e79a80fe..5a7e43e91 100644 --- a/source/conf.py +++ b/source/conf.py @@ -133,20 +133,20 @@ linkcheck_ignore = [ r"http://localhost:\d+", - r"https://packaging.python.org/en/latest/specifications/schemas/.*", - r"https://test.pypi.org/project/example-package-YOUR-USERNAME-HERE", - r"https://pypi.org/manage/.*", - r"https://test.pypi.org/manage/.*", + r"https://packaging\.python\.org/en/latest/specifications/schemas/.*", + r"https://test\.pypi\.org/project/example-package-YOUR-USERNAME-HERE", + r"https://pypi\.org/manage/.*", + r"https://test\.pypi\.org/manage/.*", # Temporarily ignored. Ref: # https://github.com/pypa/packaging.python.org/pull/1308#issuecomment-1775347690 - r"https://www.breezy-vcs.org/.*", + r"https://www\.breezy-vcs\.org/.*", # Ignore while StackOverflow is blocking GitHub CI. Ref: # https://github.com/pypa/packaging.python.org/pull/1474 - r"https://stackoverflow.com/.*", - r"https://pyscaffold.org/.*", - r"https://anaconda.org", - r"https://www.cisa.gov/sbom", - r"https://developers.redhat.com/products/softwarecollections/overview", + r"https://stackoverflow\.com/.*", + r"https://pyscaffold\.org/.*", + r"https://anaconda\.org", + r"https://www\.cisa\.gov/sbom", + r"https://developers\.redhat\.com/products/softwarecollections/overview", r"https://math-atlas\.sourceforge\.net/?", # Self-signed certificate, fails in CI r"https://click\.palletsprojects\.com/.*", From 79f33bd76d31f4312faa5ab8464121651dc9c3e9 Mon Sep 17 00:00:00 2001 From: Clemens Brunner Date: Thu, 31 Jul 2025 10:11:17 +0200 Subject: [PATCH 8/9] Revert unrelated changes --- source/conf.py | 24 +++++++++++------------- 1 file changed, 11 insertions(+), 13 deletions(-) diff --git a/source/conf.py b/source/conf.py index 5a7e43e91..8b20a28b3 100644 --- a/source/conf.py +++ b/source/conf.py @@ -132,23 +132,22 @@ # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-the-linkcheck-builder linkcheck_ignore = [ - r"http://localhost:\d+", - r"https://packaging\.python\.org/en/latest/specifications/schemas/.*", - r"https://test\.pypi\.org/project/example-package-YOUR-USERNAME-HERE", - r"https://pypi\.org/manage/.*", - r"https://test\.pypi\.org/manage/.*", + "http://localhost:\\d+", + "https://packaging.python.org/en/latest/specifications/schemas/.*", + "https://test.pypi.org/project/example-package-YOUR-USERNAME-HERE", + "https://pypi.org/manage/*", + "https://test.pypi.org/manage/*", # Temporarily ignored. Ref: # https://github.com/pypa/packaging.python.org/pull/1308#issuecomment-1775347690 - r"https://www\.breezy-vcs\.org/.*", + "https://www.breezy-vcs.org/*", # Ignore while StackOverflow is blocking GitHub CI. Ref: # https://github.com/pypa/packaging.python.org/pull/1474 - r"https://stackoverflow\.com/.*", - r"https://pyscaffold\.org/.*", - r"https://anaconda\.org", - r"https://www\.cisa\.gov/sbom", - r"https://developers\.redhat\.com/products/softwarecollections/overview", + "https://stackoverflow.com/*", + "https://pyscaffold.org/*", + "https://anaconda.org", + "https://www.cisa.gov/sbom", + "https://developers.redhat.com/products/softwarecollections/overview", r"https://math-atlas\.sourceforge\.net/?", - # Self-signed certificate, fails in CI r"https://click\.palletsprojects\.com/.*", r"https://typer\.tiangolo\.com/.*", ] @@ -157,7 +156,6 @@ linkcheck_anchors_ignore_for_url = [ # GitHub synthesises anchors in JavaScript, so Sphinx can't find them in the HTML r"https://github\.com/", - r"https://docs\.github\.com/", # While PyPI has its botscraping defenses active, Sphinx can't resolve the anchors # https://github.com/pypa/packaging.python.org/issues/1744 r"https://pypi\.org/", From c44686e6759fa75cd377bae84693928fed5bb826 Mon Sep 17 00:00:00 2001 From: Clemens Brunner Date: Thu, 31 Jul 2025 10:18:15 +0200 Subject: [PATCH 9/9] Add docs.github.com --- source/conf.py | 1 + 1 file changed, 1 insertion(+) diff --git a/source/conf.py b/source/conf.py index 8b20a28b3..961e2e0a6 100644 --- a/source/conf.py +++ b/source/conf.py @@ -156,6 +156,7 @@ linkcheck_anchors_ignore_for_url = [ # GitHub synthesises anchors in JavaScript, so Sphinx can't find them in the HTML r"https://github\.com/", + r"https://docs\.github\.com/", # While PyPI has its botscraping defenses active, Sphinx can't resolve the anchors # https://github.com/pypa/packaging.python.org/issues/1744 r"https://pypi\.org/",