将 Doxygen "Generated On" 时间戳替换为文件的时间戳
Replace Doxygen "Generated On" timestamp with timestamp of file
问题
我想用显示文件时间戳的 JavaScript(或其他一些动态方式)替换嵌入在 Doxygen 生成的 html 文件中的硬编码时间戳。
我只需要在HTML支持这个。
这看起来是可行的,因为 Doxygen 在配置文件中提供了一个 HTML_FOOTER 选项。大概我会用它来将 JavaScript 添加到文件中。
我想这样做有两个原因:
我每次生成文件时都没有更改,所以我不会在文件的更改历史记录中生成混乱。
关于上次更改的时间,请将日期设置为实际有用的日期。
我目前的方案是在提交源代码时随时生成文档。生成的 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" -->
"
问题
我想用显示文件时间戳的 JavaScript(或其他一些动态方式)替换嵌入在 Doxygen 生成的 html 文件中的硬编码时间戳。
我只需要在HTML支持这个。
这看起来是可行的,因为 Doxygen 在配置文件中提供了一个 HTML_FOOTER 选项。大概我会用它来将 JavaScript 添加到文件中。
我想这样做有两个原因:
我每次生成文件时都没有更改,所以我不会在文件的更改历史记录中生成混乱。
关于上次更改的时间,请将日期设置为实际有用的日期。
我目前的方案是在提交源代码时随时生成文档。生成的 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" -->
"