Doxygen中HIDE_COMPOUND_REFERENCE对Namespace页面不生效问题问询

问题说明 #

• 设置HIDE_COMPOUND_REFERENCE = YES时，类页面标题末尾的“Class Reference”会被隐藏，但命名空间页面的“Namespace Reference”不受影响
• 开启OPTIMIZE_OUTPUT_JAVA = YES后，命名空间会以“包”的形式展示，但对应页面标题仍显示“Namespace Reference”，存在明显误导性
• 测试环境：Doxygen 1.13.2、Windows 11

两种解决路径 #

路径1：修改Doxygen源码（适合能自行编译的用户） #

1. 找到Doxygen源码中负责生成命名空间页面标题的文件，比如namespace.cpp或htmlgenerator.cpp
2. 定位到输出标题的代码段，添加对HIDE_COMPOUND_REFERENCE配置的判断：

   // 原代码可能为：htmlTitle += " Namespace Reference";
   // 修改为如下逻辑：
   if (!Config_getBool(HIDE_COMPOUND_REFERENCE))
   {
     htmlTitle += " Namespace Reference";
   }
   

3. 重新编译Doxygen并替换原安装文件即可

路径2：用脚本批量修改生成的HTML（无需编译源码） #

编写简单的Python脚本，遍历生成的HTML文件，自动移除标题中的“Namespace Reference”：

import os
import re

# 替换为你的Doxygen生成HTML文件夹路径
target_dir = "./html"

# 匹配标题内的"Namespace Reference"文本
pattern = re.compile(r"(<h1.*?>.*?)Namespace Reference</h1>", re.IGNORECASE)

for root, _, files in os.walk(target_dir):
    for file in files:
        if file.endswith(".html"):
            file_path = os.path.join(root, file)
            with open(file_path, "r", encoding="utf-8") as f:
                content = f.read()
            new_content = pattern.sub(r"\1</h1>", content)
            if new_content != content:
                with open(file_path, "w", encoding="utf-8") as f:
                    f.write(new_content)

确保已安装Python，执行脚本即可完成所有相关页面的标题修正

补充说明 #

这是Doxygen 1.13.2版本的配置覆盖遗漏问题，后续官方版本大概率会修复该bug，不想折腾的用户也可以等待官方更新。

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