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

Question

我有一个project，我正在为其创建CI工作中的doxygen文档，publishing using github-pages。

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

据我所知，这是因为Jekyll忽略了任何以下划线开头的文件，这也是doxygen所使用的输出模式（据我所知）无法更改它。您似乎要解决这个问题，需要告诉Jekyll包括这些文件，但是到目前为止，这对我来说还行不通。

我尝试过

• Adding a _config.yml file to the master branch to include _*.html files
• Modifying that file to include _
• Swapping that file for a .nojekyll file
• Creating a .nojekyll file as part of the build
• 在gh-pages分支中创建_config.yml文件（该链接没有链接，因为travis会完全覆盖它：P）

我在master分支上创建的所有文件似乎都在gh-pages分支中被忽略，而我在gh-pages分支上创建的任何东西（可能）都被travis覆盖。

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

Answer 1

Doxygen默认根据所使用的操作系统来决定如何创建输出文件名。结果结果在不区分大小写的系统上，总会有唯一的名称（例如，通过用下划线替换大写字符，再用相应的小写字符替换（用双下划线替换下划线））。 为此，可以使用配置参数CASE_SENSE_NAMES。

从文档（1.8.15）：

  

CASE_SENSE_NAMES如果CASE_SENSE_NAMES标签设置为“否”，则放氧   只会生成小写字母的文件名。如果设置为是，   还允许使用大写字母。如果您有的话这很有用   名称或大小写不同的类或文件，如果您的文件   系统支持区分大小写的文件名。

     

建议Windows和Mac用户将此选项设置为“否”。

     

默认值为：与系统有关。