能否让Doxygen将链接展开为嵌入内容以生成独立Page？

核心问题：能否将链接内容嵌入到引用位置？ #

Doxygen 原生不支持直接将链接目标的完整内容嵌入到引用位置——它的链接机制本质是页面跳转，而非内容合并。不过可以通过以下两种方法实现类似效果：

• 使用@copydoc指令：这是最直接的方式，针对单个实体（枚举、宏、函数等），在你的独立Page中添加@copydoc 目标实体名，就能把该实体的文档注释和代码定义完整复制到当前位置。如果需要嵌入多个实体，只需逐个添加对应的@copydoc指令即可。
• 批量预处理脚本：如果要嵌入整个分组的内容，可编写简单脚本遍历目标分组下的所有实体，自动在你的Page文档中生成所有实体的@copydoc指令，避免手动重复操作。

局部自定义Group布局的解决办法 #

Doxygen 的全局DoxygenLayout.xml会应用于所有页面，无法直接指定仅对单个Group生效。你可以通过以下两种思路处理：

• 手动构建独立Page结构：放弃用Group页面，改用@page创建独立页面，通过@section、@subsection手动组织内容，只包含你需要的代码段和说明，完全不需要修改全局布局文件。
• 多配置分阶段生成：维护两套Doxygen配置文件，一套用默认布局生成全量文档，另一套用自定义DoxygenLayout.xml专门生成该Group的文档，之后单独提取这个Group的输出结果使用。这种方法适合必须保留Group页面结构的场景。

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