複数の用語を冗長なしに書く

Question

用語を用語集にリンクしたいが、用語を複数にしたいという状況がよくあります。

だから、通常、あなたは、単数形でこのような何かを：

Some text before the term :term:`important words` then the stuff after the term 

これは解析されません：

Some text before the term :term:`important word`s then the stuff after the term 

Some text before the term :term:`important word` then the stuff after the term 

これは完全に別の用語と考えられていますそして、これは非常に冗長です（私の現在の知識で私が持っている唯一の選択肢です）：

Some text before the term :term:`important words<important word>` then the stuff after the term 

用語を複数記述する必要なく、複数の言葉を書く別の方法はありますか？

Answer 1

私は同じ問題に直面しています。私は専門家だが、ここで私は（部分的に、独自の調査結果をオーバーラップ）見つけたものです：

.. won't resolve to "foo" 
:term:`foos` 

.. reST doesn't parse the string 
:term:`foo`s 

.. ugly markup and gives different formatting for "foo" and "s" 
:term:`foo`\ s 

.. redundant and verbose, but most versatile 
:term:`foos<foo>` 

最後から二番目のパターンは動作しますが、ちょっと、最後の1は本当にあなたが望むものです。複数の "s"を他の単語と同じようにフォーマットするだけでなく、fooのようなものを与える:term:`foo`\ sとは異なりますが、複数形が単なる連結ではない場合にも機能します。例えば。ディレクトリ/ディレクトリ、またはデータム/データを検討してください。これらの場合、完全な書き換えメカニズムが最適です。

あなたはsubstitutionsを定義することによって、あなたの文書はそれほど冗長にすることができます。

.. |foos| replace:: :term:`foos<foo>` 

次にどこに複数の「FOOS」をしたい、あなたは置換参照（前のリンクを参照してください）|foos|、と書くことができます

：ドキュメントプロセッサは :term:`foos<foo>`

---

参照と同じように扱います

https://sourceforge.net/p/docutils/mailman/message/31536488/