python - 狮身人面像“未找到参考目标”警告

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。

对报告类似问题的问题的回答建议进行编辑docs/conf.py；但是在这种情况下，这不是一个选项，因为效果是编辑docs/conf.py整个 Django 项目。

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

Answer 1

Tim Graham通过 github回复了这些说明：

省略“.testcases”——文档参考使用 SimpleTestCase 的便捷导入路径。

这就是问题所在。