Sphinx 中类链接的缩写名称

Question

.. seealso::

   Class :class:`apps.business.models.Department`
      Explanation goes here

   `GNU tar manual, Basic Tar Format <http://link>`_
      Documentation for tar archive files, including GNU tar extensions.

这会创建与班级部门的正确链接。

如何将 HTML 输出更改为只有一个类名称，而不带“apps.business.models ”前缀？

那么它在 HTML 中读取 Class Department 吗？

Answer 1

标准交叉引用语法中有~（波形符）。

如果在内容中添加 ~ 前缀，则链接文本将只是目标的最后一个组成部分。例如，

:py:meth:`~Queue.Queue.get`

将引用Queue.Queue.get但仅显示get为链接文本。这并不适用于所有交叉引用角色，而是特定于域的。

还有一些文档和另一个 SO 答案中的示例.. currentmodule::的指令。