如何配置Doxygen生成自定义格式的URL？

要把Doxygen生成的冗长URL改成html/page2这种简洁格式，核心是利用Doxygen的页面定义指令和配置项，步骤如下：

• 修改文档源文件
  如果你的页面是从Markdown文件生成的，在文件最开头添加Doxygen的@page指令，指定自定义的页面标识符：

  /// @page page2 文档页面2
  这里填写你的文档内容...
  

  这一步会让Doxygen将该文件生成名为page2.html的输出文件（默认带.html后缀），放在html/目录下。

• 调整Doxygen配置文件（Doxyfile）
  如果需要去掉.html后缀，直接生成html/page2，在Doxyfile里添加或修改以下配置：

  HTML_FILE_EXTENSION = ""
  

  同时确保GENERATE_HTML = YES、HTML_OUTPUT = html（这两项默认就是启用的）。

• 重新生成文档
  运行Doxygen重新构建文档，就能得到你想要的简洁URL路径了。

注意：Doxygen Awesome只是美化文档样式，这种URL自定义是Doxygen原生支持的功能，和CSS无关。

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