Travis-CI 不发布 doxygen 文件级文档

Travis-CI does not publish doxygen file-level documentation

我有一个project for which I'm building the doxygen documentation in a CI job and publishing using github-pages.

但是,我 运行 遇到文件文档(即使用 doxygen's @file command ) does not get uploaded - the links exist and the files exist in the gh-pages branch but clicking on any link leads to a 404 error. For example this should lead to this 文件生成但 link 已失效的问题。

据我所知,这是因为 Jekyll 忽略了任何名称以下划线开头的文件,这是 doxygen 使用的输出模式(据我所知)没有办法改变它.看起来要解决此问题,您需要告诉 Jekyll 包含这些文件,但到目前为止这对我不起作用。

我试过了

我在 master 分支上创建的任何这些文件在 gh-pages 分支中似乎都被忽略了,而且我在 gh-pages 分支上创建的任何文件都(可以预见地)被 travis 覆盖。

如何将这些文件发布到网页上?

Doxygen 默认决定如何根据使用的 OS 创建输出文件名。结果 a.o。在某种程度上,在不区分大小写的系统上总是有唯一的名称(例如,通过用下划线替换大写字符,然后是相应的小写字符(下划线被双下划线替换)。 为了控制这个,可以使用配置参数 CASE_SENSE_NAMES

来自文档 (1.8.15):

CASE_SENSE_NAMES If the CASE_SENSE_NAMES tag is set to NO then doxygen will only generate file names in lower-case letters. If set to YES, upper-case letters are also allowed. This is useful if you have classes or files whose names only differ in case and if your file system supports case sensitive file names.

Windows and Mac users are advised to set this option to NO.

The default value is: system dependent.