如何引用单数形式定义但复数形式的词汇表术语?

时间:2019-01-11 12:21:20

标签: python-sphinx restructuredtext

如果我定义了glossary和一个叫做foobar的术语,则可以将文本中的该术语用作

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

这将使foobar成为可点击的参考,带我进入词汇表。

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

以下字符将不能用作紧随其后的勾号将其弄乱,因此根本无法将其识别为术语链接。

I have many :term:`foobar`s

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

1 个答案:

答案 0 :(得分:3)

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

  

您可以链接到词汇表中的术语,同时在   通过在尖括号中包含该术语来实现主题。例如:

:term:`reStructuredText<RST>`
     

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

在您的情况下:

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

如果您不喜欢重复,请参见Writing terms in plural without the redundancy