如何在 Python-sphinx 中插入元数据（文档工具）答案

【问题标题】：How to insert metadata in Sphinx?如何在 Python-sphinx 中插入元数据（文档工具）
【发布时间】：2012-12-24 12:09:14
【问题描述】：

我想在 Sphinx 创建的网页中插入一些元数据（即关键字、描述、作者）。

我找到了

:fieldname: Field content

在 Sphinx 的文档中，但我不知道如何使用它。

请帮忙！非常感谢！

【问题讨论】：

我已经想通了。有一个指令叫做“meta”，完全符合我的愿望。你可以在这里找到它：docutils.sourceforge.net/docs/ref/rst/directives.html#meta

【解决方案1】：

我已经想通了。有一个指令叫做“meta”，完全符合我的愿望。

【讨论】：

你在哪里插入了元指令？我尝试在页面标题的上方和下方插入它，但 Sphinx HTML 输出不会将指令转换为 HTML 元标记。例如：.. meta:: :description: 有用的主题 :keywords: 纯文本，标记语言 ******************************* ************************************************* 页标题 ************************************************* ******************************* .. meta:: :description: 有用的主题 :keywords: 纯文本，标记语言跨度>
@Mark 我在页面标题下方插入了meta：raw.githubusercontent.com/xxks-kkk/old_web/… 但是，自 2012 年以来，我并没有经常使用meta。如果上面的例子不起作用，你可以尝试破解 jinja 模板并直接将元信息添加到您的模板中。希望这会有所帮助。
谢谢@zack！进一步的研究表明，我们团队中的某个人在过去某个时候从我们的 layout.html 文件中删除了 {{ metatags }} 变量。恢复它恢复了对 .. 元指令的支持。
@Mark 很高兴听到这个消息:)