在文档字符串中用 MathJax 替换宏 URL 锚点

Question

我有一个带有

math

指令的文档字符串，该指令有一个很长的锚点指向同一页面：

class MyClass:
    r"""Intro text.

    .. math::

        \href{#the_very_long_anchor}{the URL text}
    """

这有效！但是为了满足通常的 80 个字符文档字符串限制（在示例中它被缩短并且没有嵌套），我需要对锚点进行换行。我尝试了使用常用的 Python 字符串技术，但它们都不起作用，因为如果我这样做，显然 Sphinx/MathJax 不会正确地将字符串连接到锚点中。我不想将指令移至

.rst

，因此 使用 reST 进行换行不是一个选项。

所以我想直接在

math

指令块中添加一个Latex宏来替代

the_very_long_anchor

。怎么办？

Answer 1

你可以通过 URL 缩短器放置锚点吗？