如何修改Doxygen生成的HTML文件的标题格式？

我之前也碰到过类似的需求，要把Doxygen生成的Matlab文件参考页标题从「fooBar.m File Reference」改成「fooBar Reference」，有几个实用的办法可以实现：

方法一：通过Doxygen配置过滤文件名后缀 #

先去掉文件名里的.m后缀，修改你的Doxygen配置文件（Doxyfile）：

• 找到FILE_NAME_FILTER配置项，把它设置为：

  FILE_NAME_FILTER = \.m$
  

  这个正则表达式会匹配文件名末尾的.m并将其移除，生成的标题会变成「fooBar File Reference」。

如果还想去掉标题里的「File」字样，那就需要结合下面的模板修改方法。

方法二：自定义HTML模板彻底修改标题格式 #

这个方法能完全控制标题的显示内容，步骤如下：

1. 先导出Doxygen默认的HTML模板文件，在命令行运行：

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

2. 打开生成的header.html文件，找到页面标题相关的代码块。通常会有类似<h1 class="title">$title</h1>的标签，以及<title>$title</title>的内容。
3. 添加一段简单的JavaScript来替换标题内容，比如在</head>标签前或者标题标签后面加入：

   <script>
     // 修改浏览器标签页标题
     let docTitle = document.title;
     document.title = docTitle.replace('.m File Reference', ' Reference');
     // 修改页面内的主标题
     let pageMainTitle = document.querySelector('h1.title');
     if (pageMainTitle) {
       pageMainTitle.textContent = pageMainTitle.textContent.replace('.m File Reference', ' Reference');
     }
   </script>
   

4. 回到Doxyfile，设置HTML_HEADER = header.html，指定使用我们修改后的模板。
5. 重新运行Doxygen生成文档，标题就会变成你想要的「fooBar Reference」了。

方法三：利用Matlab文件内的@title标签（版本依赖） #

部分较新的Doxygen版本支持在Matlab注释里用@title标签直接指定页面标题，你可以在你的fooBar.m开头添加：

%> @file fooBar.m
%> @ingroup KEK
%> @brief Documentation file example
%> @title fooBar Reference

然后确保Doxyfile里ENABLE_PREPROCESSING = YES，重新生成文档试试。不过这个方法可能受Doxygen版本限制，建议先测试一下。

内容的提问来源于stack exchange，提问作者armoken