epydoc和reStructuredText更改链接名称

我正在将reStructuredText与epydoc一起使用。如何使内部链接的文本与链接的目标不同？我有：

:todo: Figure out the `Product.manufacturer` relationship in `Product`.

Product链接看起来很好，并且链接到Product对象。Product.manufacturer链接指向正确的成员变量，但是文本不是Product.manufacturer，我只想成为制造商

---

我知道如果我使用epytext可以做到这一点，但我们希望继续使用StructuredText，以便我们以后可以在需要时切换文档生成器。

我自己对epydoc不熟悉，但通常的StructuredText方法是：

`manufacturer <Product.manufacturer>`_

`制造商`_

或者，用狮身人面像

:attribute:`manufacturer <Product.manufacturer>`

：属性：`manufacturer`

考虑到epydoc似乎已经覆盖了提供链接的默认角色，它将被留给它。但是，这是最有可能起作用的：

:todo: Figure out the `manufacturer <Product.manufacturer>` relationship in `Product`.

：todo:找出“产品”中的“制造商”关系。

我自己对epydoc并不熟悉，但通常的重组方式是：

`manufacturer <Product.manufacturer>`_

`制造商`_

或者，用狮身人面像

:attribute:`manufacturer <Product.manufacturer>`

：属性：`manufacturer`

考虑到epydoc似乎已经覆盖了提供链接的默认角色，它将被留给它。但是，这是最有可能起作用的：

:todo: Figure out the `manufacturer <Product.manufacturer>` relationship in `Product`.

：todo:找出“产品”中的“制造商”关系。

不幸的是，这只是指向实际的URL../Product.manufacturer，而不是插入此页面的位置object@lost：您是以纯重组文本的形式（如

`manufacturer`.

（注意尾随的下划线）执行此操作，还是不使用下划线（从而使其成为epydoc的“默认角色”）执行此操作？前者将如你所描述的那样起作用，而后者听起来应该起作用。啊，我是用epydoc的u2;做的。然而，在epydoc中，写入

store（）

只会在输出中生成“store（）”（固定宽度字体）和“store（）baseplot.baseplot.store（）”的“失败的标识符交叉引用目标”警告。在“写入”之后，它会吃掉位的反勾号。我不知道。当我回答这个问题时，我只是说这就是StructuredText在其所有本地等价物中所做的（以及其他类似Sphinx的东西所做的）。我不知道它是否在epydoc中工作，因为我仍然没有使用过它。不幸的是，这只是指向实际的URL../Product.manufacturer，而不是插入此页面的位置object@lost：您是以纯重组文本的形式执行此操作，如

`manufacturer`

（注意尾随的下划线），还是不带下划线（从而使其成为epydoc的“默认角色”）？前者将如您所述工作，而后者听起来似乎应该工作。啊，我是用epydoc中的u2;完成的。但是在epydoc中，写入

store（）

只会在输出中生成“store（）”（固定宽度字体）和一个“失败的标识符交叉引用目标”警告“store（）baseplot.baseplot.store（）”gah它在“写”之后吃了一点回扣，我不知道。当我回答它时，我只是说这就是StructuredText在其所有本机等价物中所做的（以及其他类似Sphinx的东西所做的）。我不知道它在epydoc中工作，因为我仍然没有使用过它。