可以将希腊字母作为词汇表术语添加到 Sphinx 文档中吗?

Can Greek letters be added to Sphinx documents as glossary terms?

我想在 sphinx 文档中将定义为希腊字母的变量添加到我的词汇表中。例如:

.. glossary::

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

目标是让这些变量出现在文档的索引中。有人有这方面的经验吗?

词汇表术语会自动添加到索引中。但这不适用于问题中的词汇表条目。 Sphinx 发出此警告:WARNING: invalid single index entry ''(至少对我来说是这样)。这感觉像是一个错误。

这里有两个解决方法:

  1. 使用替换

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

    缺点是它会在索引中说"alpha"而不是“α”。

  2. 使用实际字母

    α
       Description of alpha
    

    此处 α 将是标题 "Symbols" 下索引中的一个条目。