-
http://sphinx-doc.org/ is ideal for this sort of thing - it takes reStructuredText input and converts it into many different formats, including multi-page HTML or single-document PDF.
rst is better t…
-
The Problem:
This issue arose in https://github.com/astropy/astropy/pull/15852, where it was discovered that adding type hints to files can result in Sphinx erroneously believing the private source…
-
### Describe the bug
**context**
When I try to build sphinx docs with myst-nb...
**expectation**
I expected the docs to build.
**bug**
But instead the following error is:
```console
$ ju…
-
### Describe the bug
**context/problem**
Launching sphinx-autobuild from `tox` (in conjunction with `tox-conda`) results in the server continuously relaunching. Specifying
`--no-initial` results…
-
Recently, we've marked up some functions and methods using parameter lists[^1]. When a parameter can take multiple types, we've used `|` to separate the types, instead of using `or`, as recommended by…
-
https://github.com/pysal/tobler/actions/runs/9519677622/job/26243393334
-
### Describe the bug
malformed table errors are reported as ERROR when running sphinx-build
source\a\a.rst:14: ERROR: Error parsing content block for the "list-table" directive: uniform two-level …
-
- Use `sphinx_rtd_theme`
- Add necessary packages in requirements-test.txt
- Reference: https://github.com/openwisp/netjsonconfig/blob/master/docs/source/conf.py
-
Unfortunately the sphinx doc "search engine" is very basic: it only searches individually indexed words, there's no way to search for patterns or phrases. This means searching for any multi-word phras…
-