Python-Sphinx：自动包含文档建立的日期和时间

Question

对于Python-Sphinx文档生成器，是否存在一种标准方法来自动填充构建当前渲染的时间和日期？

在conf.py文件和docs for the RTD theme中，我没有列出此功能。

Answer 1

您的主题可能不支持该主题，在这种情况下，您将不得不覆盖适当的模板。

以Pyramid作为示例：

# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
# using the given strftime format.
html_last_updated_fmt = '%b %d, %Y'

在您的情况下：

html_last_updated_fmt = '%b %d, %Y, %X'

用datetime调味。

Answer 2

如果您只想在一页上的某个地方显示日期/时间，则可以使用the |today| substitution：

Last change: |today|

在我的机器上，结果如下：

Last change: 10.07.2019

（德语区域设置，因此日期为德语格式）

要更改日期格式，可以使用today_fmt in the configuration设置time.strftime()'s formatting directives。

例如，如果您希望日期/时间看起来类似于此处的堆栈溢出格式，请在配置文件中设置today_fmt，如下所示：

today_fmt = '%b %d %y at %H:%M'

...这会将|today|的输出更改为此：

Last change: Juli 10 19 at 23:34

注意：根据文档，%b应该是“月份作为语言环境的缩写名称”，因此我希望结果是Jul而不是Juli。 / em>不知道为什么我会在计算机上得到完整的德语月份名称。