1

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

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

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

我知道如果我使用 epytext 可以做到这一点，但我们想坚持使用 reStructuredText，以便我们以后可以根据需要切换文档生成器。

4

1 回答 1

1

我自己不熟悉 epydoc，但正常的 reStructuredText 方式是这样的：

`manufacturer <Product.manufacturer>`_

或者，与狮身人面像，

:attribute:`manufacturer <Product.manufacturer>`

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

:todo: Figure out the `manufacturer <Product.manufacturer>` relationship in `Product`.
于 2010-11-30T01:42:16.097 回答