Как я могу обратиться к термину глоссария, определенному в единственном числе, но выраженному во множественном числе?

Question

Если я определю glossary и термин под названием foobar, я могу использовать этот термин из текста как

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

Это затем превратит foobar в интерактивную ссылку, которая приведет меня к глоссарию.

Однако, что если я захочу сослаться на термин, но отобразить его по-разному, например, во множественном числе, например «У меня много foobars», где foobar распознается как термин и связан с глоссарием?

Следующее не будет работать, поскольку персонаж, следующий сразу после закрывающего тика, испортит его, так что он вообще не будет распознаваться как ссылка на термин.

I have many :term:`foobar`s

Добавление пробела до s, очевидно, выглядит плохо. Было бы хорошо, если бы можно было пометить все слово "foobars" как ссылку на термин foobar. Это возможно?

Answer 1

См. Например https://sublime -and-sphinx-guide.readthedocs.io / ен / последний / glossary.html

Вы можете ссылаться на термин в глоссарии, показывая другой текст в тема, включив термин в угловых скобках. Например:

:term:`reStructuredText<RST>`

Термин в угловых скобках должен точно соответствовать термину в глоссарии. Текст перед угловыми скобками - это то, что пользователи видят на странице.

В вашем случае:

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

Если вам не нравится повторение, см. Написание терминов во множественном числе без избыточности