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.

这创建了一个到班级部门的正确链接。

如何在不使用“apps.business.models”前缀的情况下将HTML输出更改为只有一个类名？

so it reads Class Department in HTML?

Answer 1

在~有standard cross-referencing syntax（代字号）。

如果在内容前加上〜，则链接文本将只是目标的最后一个组件。例如，

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

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

还有指令.. currentmodule::与some documentation和example in another SO answer。