将 Doxygen "Generated On" 时间戳替换为文件的时间戳

Replace Doxygen "Generated On" timestamp with timestamp of file

问题

我想用显示文件时间戳的 JavaScript(或其他一些动态方式)替换嵌入在 Doxygen 生成的 html 文件中的硬编码时间戳。

我只需要在HTML支持这个。

这看起来是可行的,因为 Doxygen 在配置文件中提供了一个 HTML_FOOTER 选项。大概我会用它来将 JavaScript 添加到文件中。

我想这样做有两个原因:

  1. 我每次生成文件时都没有更改,所以我不会在文件的更改历史记录中生成混乱。

  2. 关于上次更改的时间,请将日期设置为实际有用的日期。

我目前的方案是在提交源代码时随时生成文档。生成的 html 被 rsync 到服务器以供显示。 rsync 足够聪明,只移动已更改的代码,因此除非文件内容发生更改,否则服务器上文件的时间戳不会更改。现在内容每次都在变化,因为 Doxygen 生成的时间戳每次都在变化。

这是我尝试过的:

我使用以下 JavaScript 片段代替 Doxygen 生成的时间戳:

<script> document.write(new Date(document.lastModified)); </script>

以下是我用来将其放入代码中的步骤:

要求 Doxygen 使用此命令生成页眉和页脚模板:

doxygen -w html header.html footer.html extradoxygen.css

修改footer.html文件,将时间戳替换为上面的JavaScript。

编辑 Doxyfile 并输入修改此行:

HTML_FOOTER            = footer.html

生成Doxygen,注意时间戳对应文件的时间戳。

但这不起作用,因为每次刷新浏览器时时间戳都会改变。

将页脚中的 $date 替换为服务器端包含的修改日期。从: Apache SSI Includes

"Modification date of the file This document last modified <!--#flastmod file="index.html" -->"

Example Usage