我想用这样的方法做一个表格。
+-----------+------+-----+------+
| method | prop | ref | note |
+-----------+------+-----+------+
| :meth:`m` | x | | sad |
+-----------+------+-----+------+
| :func:`f` | x | x | |
+-----------+------+-----+------+
但是,对于我的真实姓名,表格会变得很长,特别是因为我想用:meth:'name <fully.qualified.name>
缩短完全限定的名字。我想通过使用替换来缩短表定义,但我还没有找到使其工作的方法。请注意,我正在替换反引号以避免在帖子的早期结束代码块。我的代码中确实有它们。以下是一些尝试。
- 使用
|m|
.. |m| :meth:'m'
:引用未定义的替换'm'
- 使用
|m|_
.. _m: :meth:'m'
:引用未定义的替换'm'
- 使用
|m|
.. |m| replace:: :meth:'m'
:生成的文本正确,但没有链接
如何缩短参考?还是不可能?
使用replace::
确实是答案。但是,在我的情况下,狮身人面像缓存了一些阻止生成链接的信息。删除整个构建文件夹后,链接工作正常。
.. |m| replace:: :meth:`m`
This is |m|.