Python Sphinx:自动包含文档构建的日期和时间

Question

对于Python Sphinx文档生成器，是否有一种标准的方法可以自动填充当前渲染生成的时间和日期？

在conf.py文件和RTD主题的文档中，我没有看到列出这个功能。

Answer 1

如果您只想在一个页面上的某个位置显示日期/时间，可以使用|today|替换：

Last change: |today|

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

Last change: 10.07.2019

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

要更改日期的格式，可以使用time.strftime()的格式化指令在配置中设置today_fmt。

例如，如果您希望日期/时间看起来与Stack Overflow中使用的格式相似，请在配置文件中设置today_fmt，如下所示：

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

这将把|today|的输出更改为：

Last change: Juli 10 19 at 23:34

注意：根据文档，%b应该是"Month as locale的缩写名称"，所以我希望结果是Jul而不是Juli

Answer 2

您的主题可能不支持它，在这种情况下，您必须覆盖适当的模板。

使用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'

根据口味为约会时间调味。