python - 狮身人面像指令到另一个页面

Question

我的目录中有 2 页。

在 page_1 我有以下

The link :py:class:`testtest`

在 page_2 我有

The link :py:class:`testtest`
.. autoclass:: testtest

在 page_2 上，该链接正在工作，因为该类已使用 autoclass 自动记录。

为什么 page_1 上的相同链接不起作用？如何在不包含 page_1 上的 autoclass 指令的情况下使其工作？

谢谢，

周杰伦

Answer 1

page_1不知道在哪里找到testtest-page_2找到它是因为当它不直接找到它时，它隐式地在节点的“范围”（可以这么说）中查找。正在做：

:py:class:`module.testtest`

inpage_1应该可以工作（如果您的路径设置正确），您还可以执行以下操作：

:py:class:`~module.testtest`

仅testtest作为链接文本。为了避免必须做模块前缀，您可以使用.. currentmodule:: modulename指令，但一次只能应用其中一个，因此如果您在多个模块中引用事物，并不能真正节省输入。

http://sphinx-doc.org/domains.html#directive-py:currentmodule
http://sphinx-doc.org/markup/inline.html#xref-syntax
http://sphinx-doc.org/domains。 html#cross-reference-python-objects