python-sphinx - 用語集の用語としてギリシャ文字を Sphinx ドキュメントに追加できますか?

Question

スフィンクス文書の用語集にギリシャ文字として定義されている変数を追加したいと考えています。例えば：

.. glossary::

    :math:`{\alpha}`
        Definition for alpha

目標は、これらの変数をドキュメントのインデックスに表示することです。誰でもこれを経験したことがありますか？

Answer 1

用語集の用語は自動的に索引に追加されます。しかし、それは質問の用語集エントリでは機能しません。Sphinx は次の警告を発します: WARNING: invalid single index entry ''(少なくとも私にはそうです)。これはバグのように感じます。

以下に 2 つの回避策を示します。

1. 代用品を使う

   |alpha|
      Description of alpha
   
   .. |alpha| replace:: :math:`{\alpha}`
   

   欠点は、インデックスに「α」ではなく「アルファ」と表示されることです。

2. 実際のアルファベットを使用

   α
      Description of alpha
   

   ここで、α は「シンボル」という見出しの下のインデックスのエントリになります。