Fix Sphinx build failure due to Google Fonts network request

[Copilot]

Fix Sphinx Documentation Build - Google Fonts Issue

• Identify the bug: sphinx_immaterial theme attempts to download Google Fonts from fonts.google.com
• Root cause: Default fonts (Roboto, Roboto Mono) trigger network requests that fail when blocked
• Fix: Set font: False in html_theme_options in conf.py to disable Google Fonts
• Test: Build documentation to verify the fix works
• Verify: Documentation builds successfully without network access to fonts.google.com
• Cleanup: Add generated docs directories to .gitignore
• Properly rebased on main - commits now correctly stacked on top of latest main
• Fix Sphinx 9.x compatibility issue - Install Sphinx <9.0 in separate pip command to prevent dependency resolution from upgrading to Sphinx 9.x
• Clean up artifacts - Remove wheel file and add *.whl to .gitignore

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Bug in sphinx documentation build</issue_title>
<issue_description></issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Bug in sphinx documentation build #371

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[sbaldu]

@copilot Please rebase on main

[Copilot]

@copilot Please rebase on main

Done! The branch has been rebased on main. The changes are in commit 4ddd9b6.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.01%. Comparing base (1c4dc9e) to head (a671be5).
⚠️ Report is 16 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #372   +/-   ##
=======================================
  Coverage   98.01%   98.01%           
=======================================
  Files          53       53           
  Lines        1666     1666           
  Branches       89       89           
=======================================
  Hits         1633     1633           
  Misses         33       33           

Flag	Coverage Δ
unittests	98.01% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[sbaldu]

@copilot The Github Pages workflow is still failing and the error is the same

[sbaldu]

@copilot Traceback

  File "/home/runner/.local/lib/python3.12/site-packages/sphinx/transforms/post_transforms/__init__.py", line 352, in run
    if issubclass(translator, SphinxTranslator):
       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
TypeError: issubclass() arg 1 must be a class

The full traceback has been saved in:
/tmp/sphinx-err-wdvjnekx.log

To report this error to the developers, please open an issue at https://github.com/sphinx-doc/sphinx/issues/. Thanks!
Please also report this if it was a user error, so that a better error message can be provided next time.
make: *** [Makefile:17: html] Error 2
writing output... [ 5%] cpp/alpaka_utils
Error: Process completed with exit code 2.

[Copilot]

@copilot The Github Pages workflow is still failing and the error is the same

I investigated the GitHub Pages workflow failure. The Google Fonts fix is working correctly (font: False is in place), but there's a different error occurring: a compatibility issue between Sphinx 9.x and the sphinx_immaterial theme.

I've pinned Sphinx to version <9.0 in the workflow to resolve this TypeError. The fix is in commit 9c0cf5c.

[sbaldu]

@copilot Now it works, thanks.
There are still warnings though:

/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/alpaka_utils.rst:2: WARNING: Duplicate explicit target name: "namespaceclue". [docutils]
/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/clusterer.rst:2: WARNING: Parameter name 'wrappedCoordinates' does not match any of the parameters ['wrapped_coordinates', 'TRange'] defined in the signature(s): ['template<std::ranges::contiguous_range TRange> void setWrappedCoordinates(const TRange &wrapped_coordinates)']
/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/clusterer.rst:2: WARNING: Parameter name 'wrappedCoordinates' does not match any of the parameters ['wrapped_coordinates', 'TArgs'] defined in the signature(s): ['template<std::integral... TArgs> void setWrappedCoordinates(TArgs... wrapped_coordinates)']
/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/points_conversion.rst:2: WARNING: Parameter name 'h_points' does not match any of the parameters ['queue', 'd_points', 'TQueue', 'Ndim', 'TDev'] defined in the signature(s): ['template<concepts::queue TQueue, std::size_t Ndim, concepts::device TDev> auto copyToHost(TQueue &queue, const PointsDevice<Ndim, TDev> &d_points)']
/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/points_conversion.rst:2: WARNING: Parameter name 'd_points' does not match any of the parameters ['queue', 'h_points', 'TQueue', 'Ndim', 'TDev'] defined in the signature(s): ['template<concepts::queue TQueue, std::size_t Ndim, concepts::device TDev> auto copyToDevice(TQueue &queue, const PointsHost<Ndim> &h_points)']
/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/points_device.rst:2: WARNING: Parameter name 'input_buffer' does not match any of the parameters ['queue', 'n_points', 'input', 'output', 'TQueue'] defined in the signature(s): ['template<concepts::queue TQueue> PointsDevice(TQueue &queue, int32_t n_points, std::span<float> input, std::span<int> output)']
/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/points_device.rst:2: WARNING: Parameter name 'output_buffer' does not match any of the parameters ['queue', 'n_points', 'input', 'output', 'TQueue'] defined in the signature(s): ['template<concepts::queue TQueue> PointsDevice(TQueue &queue, int32_t n_points, std::span<float> input, std::span<int> output)']
/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/points_device.rst:2: WARNING: Parameter name 'input_buffer' does not match any of the parameters ['queue', 'n_points', 'input', 'output', 'TQueue'] defined in the signature(s): ['template<concepts::queue TQueue> PointsDevice(TQueue &queue, int32_t n_points, float *input, int *output)']
/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/points_device.rst:2: WARNING: Parameter name 'output_buffer' does not match any of the parameters ['queue', 'n_points', 'input', 'output', 'TQueue'] defined in the signature(s): ['template<concepts::queue TQueue> PointsDevice(TQueue &queue, int32_t n_points, float *input, int *output)']
/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/points_host.rst:2: WARNING: Parameter name 'input_buffer' does not match any of the parameters ['queue', 'n_points', 'input', 'output', 'TQueue'] defined in the signature(s): ['template<concepts::queue TQueue> PointsHost(TQueue &queue, int32_t n_points, std::span<float> input, std::span<int> output)']
/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/points_host.rst:2: WARNING: Parameter name 'output_buffer' does not match any of the parameters ['queue', 'n_points', 'input', 'output', 'TQueue'] defined in the signature(s): ['template<concepts::queue TQueue> PointsHost(TQueue &queue, int32_t n_points, std::span<float> input, std::span<int> output)']
/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/points_host.rst:2: WARNING: Parameter name 'input_buffer' does not match any of the parameters ['queue', 'n_points', 'input', 'output', 'TQueue'] defined in the signature(s): ['template<concepts::queue TQueue> PointsHost(TQueue &queue, int32_t n_points, float *input, int *output)']
/home/runner/work/CLUEstering/CLUEstering/docs/source/cpp/points_host.rst:2: WARNING: Parameter name 'output_buffer' does not match any of the parameters ['queue', 'n_points', 'input', 'output', 'TQueue'] defined in the signature(s): ['template<concepts::queue TQueue> PointsHost(TQueue &queue, int32_t n_points, float *input, int *output)']
/home/runner/work/CLUEstering/CLUEstering/docs/source/getting-started.rst:147: WARNING: image file not readable: images/docs/getting-started/output-plotter.png [image.not_readable]
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'dc' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'rhoc' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'dm' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'seed_dc' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'ppbin' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'wrapped_coordinates' does not match any of the parameters defined in the signature: ['input_data', 'wrapped_coords']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'wrapped_coordinates' does not match any of the parameters defined in the signature: ['wrapped_coords']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'choice' does not match any of the parameters defined in the signature: ['choice: str', 'parameters: list | None = None', 'function: ~types.LambdaType = <function clusterer.<lambda>>']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'parameters' does not match any of the parameters defined in the signature: ['choice: str', 'parameters: list | None = None', 'function: ~types.LambdaType = <function clusterer.<lambda>>']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'function' does not match any of the parameters defined in the signature: ['choice: str', 'parameters: list | None = None', 'function: ~types.LambdaType = <function clusterer.<lambda>>']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'cluster_id' does not match any of the parameters defined in the signature: ['cluster_index']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'dc' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'rhoc' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'dm' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'ppbin' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'kernel' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'clust_data' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'clust_prop' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']
/home/runner/work/CLUEstering/CLUEstering/docs/source/python/clusterer.rst:2: WARNING: Parameter name 'elapsed_time' does not match any of the parameters defined in the signature: ['dc: float', 'rhoc: float', "dm: [<class 'float'>", 'None] = None', "seed_dc: [<class 'float'>", 'ppbin: int = 128']```

[Copilot]

@copilot Traceback

...

The issue was that pip's dependency resolver was upgrading Sphinx to 9.x despite the version constraint. This happened because all packages were installed in a single command, allowing pip to resolve dependencies and choose Sphinx 9.x.

Fixed by installing Sphinx <9.0 first in a separate pip command, then installing other packages. This ensures Sphinx stays at 8.x. The fix is in commit a671be5.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• esm.ubuntu.com
  • Triggering command: /usr/lib/apt/methods/https /usr/lib/apt/methods/https (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)