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

问题描述 投票:1回答:1

如果我定义了一个glossary和一个叫做foobar的术语,那么我可以使用文本中的那个术语作为

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

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

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

以下字符将不作为紧接在后的勾号后面的字符而工作,以致使它完全混乱,因此根本无法将其识别为术语链接。

I have many :term:`foobar`s

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

python-sphinx restructuredtext glossary
1个回答
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

© www.soinside.com 2019 - 2024. All rights reserved.