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

Question

我有一个项目，我在 CI 作业中构建 doxygen 文档并使用 github-pages 发布。

但是，我遇到了一个问题，文件的文档（即使用doxygen 的 @file 命令生成）没有上传 - 链接存在并且文件存在于 gh-pages 分支中，但单击任何链接会导致 404错误。例如，这应该导致该文件，但链接已失效。

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

我试过了

• 将 _config.yml 文件添加到 master 分支以包含_*.html文件
• 修改该文件以包含_
• 将该文件交换为.nojekyll文件
• 在构建过程中创建 .nojekyll 文件
• 在 gh-pages 分支中创建一个 _config.yml 文件（这个没有链接，因为 travis 完全覆盖了它：P）

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

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

标签： githubtravis-cidoxygengithub-pages

Answer 1

默认情况下，Doxygen 决定如何根据使用的操作系统创建输出文件名。这导致 ao 在不区分大小写的系统上始终存在唯一名称（例如，通过将大写字符替换为下划线后跟相应的小写字符（下划线替换为双下划线）。为了引导这一点，配置参数CASE_SENSE_NAMES可以是用过的。

从文档（1.8.15）：

CASE_SENSE_NAMES 如果 CASE_SENSE_NAMES 标签设置为 NO，那么 doxygen 将只生成小写字母的文件名。如果设置为 YES，也允许使用大写字母。如果您有名称仅大小写不同的类或文件，并且您的文件系统支持区分大小写的文件名，这将非常有用。

建议 Windows 和 Mac 用户将此选项设置为 NO。

默认值为：系统相关。