-
Notifications
You must be signed in to change notification settings - Fork 1.4k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
3.12.0: sphinx warnings reference target not found
#1941
Comments
I would merge a PR with the patch from above :-) |
About the warnings: I would need to look into that ... it's a bit weird that this doesn't / didn't have an effect. Or did I miss something? |
Those warnings are affecting .html, .pdf and .qch outputs by only peruce higlists without links in rendered documents. |
Most of these warnings are about the Skimming through, I could observe some real issues, for example:
Here the reference inside the text seems to be wrong as it points to Line 1112 in 54a30cb
|
This fixes #1941 by cleaning up wrong references and adding new docs. Some notes about this: * Building the docs now works without prior package installation. * The intersphinx mapping will now always use the objects of the Python version used for the docs build. * The intersphinx mapping for *Pillow* has been added. * Links to private methods in the developer docs have been replaced by inline code as they are not part of the Sphinx docs. * Some broken/outdated/strange docstrings have been fixed. * New classes have been added to the docs. Module-specific classes have been added to the modules where they are being used directly, some generic classes/modules have been put into new files/pages. * We have to exclude some members to avoid duplicate definitions.
First of all currently it is not possible to use straight
sphinx-build
command to build documentation out of source tree onlyThis can be fixed by patch like below:
Than .. on building my packages I'm using
sphinx-build
command with-n
switch which shows warmings about missing references. These are not critical issues.Here is the output with warnings:
You can peak on fixes that kind of issues in other projects
RDFLib/rdflib-sqlalchemy#95
RDFLib/rdflib#2036
click-contrib/sphinx-click@abc31069
frostming/unearth#14
jaraco/cssutils#21
latchset/jwcrypto#289
latchset/jwcrypto#289
pypa/distlib@98b9b89f
pywbem/pywbem#2895
sissaschool/elementpath@bf869d9e
sissaschool/xmlschema@42ea98f2
sqlalchemy/sqlalchemy@5e88e6e8
The text was updated successfully, but these errors were encountered: