在狮身人面像中，“_glossary”和“_contents”指令是做什么的？

Question

在许多包的文档中，包括Sphinx本身，我在表单的某些文件开始时看到了一个指令。

.. _<filename>:

例如，许多术语表从

.. _glossary:

这些指令是做什么的，它们在哪里被记录下来？

注意，我忽略了这一点，例如，我的“术语表. that”，然后是:ref:glossary链接到python.org的Python术语表，而不是我的词汇表，所以指令做了一些重要的事情。

Answer 1

像.. _glossary:这样的指令是标识文档中某个点(链接目标)的标签。

指向该点的链接是使用以下标记：:ref:`glossary`创建的。详情请参见http://sphinx-doc.org/markup/inline.html#ref-role。

是的，如果您使用狮身狮身扩展(配置如下：intersphinx_mapping = {'python': ('http://docs.python.org/2.7', None)})并使用上面的链接而没有定义您自己的.. _glossary:标签，那么输出中的结果链接实际上将指向http://docs.python.org/2.7/glossary.html#glossary。