sphinx icon indicating copy to clipboard operation
sphinx copied to clipboard

The Sphinx documentation generator

Results 596 sphinx issues
Sort by recently updated
recently updated
newest added

Closes #11995. @user27182 Could you check if this patch works? I added a test but since I refactored autodoc for that, I want to be sure that I didn't forget...

extensions:autodoc

**Is your feature request related to a problem? Please describe.** From https://github.com/pradyunsg/furo/discussions/557: For one of my projects, the right nav for the API reference has become unusable: it lists sections...

I’m guessing this section was copied over from the previous one and these bits got forgotten when updating. I’m also wondering whether there is a missing “at an” before “earlier...

type:docs

Add the documentation for #12018. I'll keep both in sync if the implementation changes. So for now, I'll keep it as a draft. EDIT: will sync afterwards

DO NOT MERGE

**Is your feature request related to a problem? Please describe.** *Goal* I would like to add a toc entry to each ``.. autofunction:`` Suppose: ```rst .. automodule:: foo.bar .. rubric::...

Currently, when autodoc renders a class of the form `class Foo(Generic[T])`, the resulting HTML just shows "class modulename.Foo", which omits information, as the type parameter is not shown. The only...

type:enhancement
extensions:autodoc
domains:py
expert

Unzip [Sphinx_projects.zip](https://github.com/sphinx-doc/sphinx/files/6123862/Sphinx_projects.zip), then: ``` cd two make html cd ../one make html ``` This illustrates the following problems: From `one/index.rst` ================= ![image](https://user-images.githubusercontent.com/2125584/110806459-b40d6e00-8247-11eb-8e28-792a4aea57c3.png) From `two/index.rst` =================== ![image](https://user-images.githubusercontent.com/2125584/110806285-888a8380-8247-11eb-9b72-ac5f3436023f.png) Bugs observed =============== 1....

type:bug
extensions:intersphinx

If `index.rst` does not appear in the pattern of a custom `{include,exclude}_patterns`, the error message is less than helpful. Instead, we should check that the master doc appears in the...

help wanted
good first issue
easy

fixes #11446 as described in the issue, the link checker incorrectly processes URLs that have a `#` that is part of the directory path, rather than designating the anchor. This...

awaiting:decision

Fix #11353. I'm not sure that everything is covered so feel free to argue.

extensions:autodoc