python intertools_python – 如何链接到intersphinx中的根页面

您已满足以下要求.这是最后一个令人沮丧的常见问题.

>配置项目以使用intersphinx.

>远程文档使用Sphinx,实际上有一个名为objects.inv的清单文件.运行sphinx-build时,日志条目应该是这样的：

loading intersphinx inventory from https://docs.python.org/3/objects.inv...

loading intersphinx inventory from https://pythonhosted.org/pyserial/objects.inv...

>使用intersphinx的Python项目的语法如下,就像任何cross-referencing link一样：

:role_name:`title `

所以在你的情况下：

:ref:`pyserial `

python -m sphinx.ext.intersphinx 'https://pythonhosted.org/pyserial/objects.inv'

出现所有API对象,这就是您可以链接到这些对象的原因,但只存在有限数量的其他对象：

std:label

examples Examples : examples.html#examples

genindex Index : genindex.html#

miniterm serial.tools.miniterm : tools.html#miniterm

modindex Module Index : py-modindex.html#

search Search Page : search.html#

urls URL Handlers : url_handlers.html#urls

缺乏任意标签是作者常见的烦恼.

你也可以check the project’s reST source for targets,在这种情况下,没有像… _my-reference-label：这样的参考标签.

要解决此问题,您可以使用以下任意一个目标：

:ref:`pyserial `

…或者更好的是向项目提交拉取请求,在该项目中,您至少为索引页面提供标签,等待其接受,然后将其用于intersphinx链接.其他作者会很感激.