-
[lessons-packaging-3files]: http://github-pages.ucl.ac.uk/rsd-engineeringcourse/ch04packaging/03Packaging.html#Write-a-readme-file
[lessons-documentation-sphinx]: http://github-pages.ucl.ac.uk/rsd…
-
the higher level overview of this task is to migrate the existing landing page and relevant content of Water module off the original Quarto pages to Sphinx.
**Note:** only the non-lessons pages shoul…
-
Currently oveload docstrings are simply ignored.
Possible solutions (TBC):
* https://sphinx-immaterial.readthedocs.io/en/latest/apidoc/python/apigen.html
* https://sphinx-toolbox.readthedocs.io/e…
-
### Describe the bug
doctest is ignoring the +SKIP directive in my rst testcode:: samples.
### How to Reproduce
The docs at https://www.sphinx-doc.org/en/master/usage/extensions/doctest.h…
-
### Describe the bug
I want to document `TypeAlias` variables which are typically guarded by `if TYPE_CHECKING` or they might be defined in a stub file. The issue is that these members are not automa…
-
Sorry for the late report but, with Sphinx 8.1.3 and PST 0.16.0, strings are not all translated. At least:
- “On this page”
- “Built with the PyData Sphinx Theme 0.16.0.”
are still in English.
…
-
Currently all link-checker runs are failing at run time with
```
Extension error:
Could not import extension sphinx.builders.epub3 (exception: No module named 'imghdr')
Traceback (most recent call…
-
Docs have been broken for some time without us realising.
Have seen a number of bugs when trying to fix and the files are very dated now so probably best to start from scratch.
Suggested pathway…
-
### Describe the bug
For our [project](https://github.com/SUSE/osc-tiny), we have both the `autodoc` and `viewcode` extensions enabled, and the project makes heavy use of `lxml`.
When building t…
-
### Describe the bug
We can not execute ``make clean`` anymore on current Sphinx HEAD
```
$ make html && make clean
Sphinx v8.2.0+/de24fd0b7 en cours d'exécution
chargement des traductions [e…