2

如果我定义 aglossary和一个名为 的术语foobar,那么我可以将文本中的该术语用作

This is a ref to the :term:`foobar` term.

然后,这将foobar成为一个可点击的参考,将我带到词汇表。

但是,如果我想引用一个术语但以不同的方式显示它,例如,以复数形式显示,例如“我有很多 foobars”,其中 foobar 被识别为术语并链接到词汇表,该怎么办?

以下将不会作为紧跟在结束反勾号之后的字符将其弄乱,因此它根本不会被识别为术语链接。

I have many :term:`foobar`s

在 s 之前添加一个空格显然看起来很糟糕。如果可以将整个单词“foobars”标记为术语的链接,那就太好了foobar。这可能吗?

4

1 回答 1

7

参见例如https://sublime-and-sphinx-guide.readthedocs.io/en/latest/glossary.html

您可以链接到词汇表中的术语,同时在主题中显示不同的文本,方法是将术语包含在尖括号中。例如:

:term:`reStructuredText<RST>`

尖括号中的术语必须与词汇表中的术语完全匹配。尖括号之前的文本是用户在页面上看到的内容。

在你的情况下:

I have many :term:`foobars<foobar>`

如果您不喜欢重复,请参阅以复数形式编写术语而没有冗余

于 2019-01-11T12:24:15.180 回答