Python-Sphinx:自动包含文档生成的日期和时间

Question

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

查看conf.py文件和RTD主题的文档，我没有看到列出了这个特性。

Answer 1

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

以金字塔为例说明什么是可行的：

# 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'

让你的日期时间尝一尝。

Answer 2

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

Last change: |today|

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

Last change: 10.07.2019

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

若要更改日期的格式化方式，可以使用在配置中设置格式指令。

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

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

...which将将|today|的输出更改为：

Last change: Juli 10 19 at 23:34

注意:根据docs，%b应该是"Month as locale的缩写名称“，所以我希望结果是Jul，而不是Juli__。不知道为什么我的机器上有德国月的全名。