Sphinx＆＃34;未找到参考目标＆＃34;警告

Question

在针对Django项目创建PR后，Sphinx在运行时会发出以下警告：

make html

本地：

/path-to-project-dir/django/docs/releases/1.10.txt:304: WARNING: py:meth reference target not found: django.test.testcases.SimpleTestCase.assertFormValid
/path-to-project-dir/django/docs/releases/1.10.txt:304: WARNING: py:meth reference target not found: django.test.testcases.SimpleTestCase.assertFormNotValid

基本上Sphinx报告它缺少参考文献。

构建文档时发生错误（实际上是警告）：http://djangoci.com/job/docs/7444/console。

question reporting a similar issue 的答案建议修改docs/conf.py;但是在这种情况下，这不是一个选项，因为效果是为整个Django项目编辑docs/conf.py。

此问题的任何解决方案都不涉及更改docs/conf.py？

Answer 1

Tim Graham回复了via github这些说明：

  

省略“.testcases” - 文档引用使用方便   导入SimpleTestCase的路径。

这就是问题所在。