Doxygen(三) - 如何自定义chm目录、布局

一般SDK用doxygen生成chm文件时使用的是默认目录结构(MainPage\Related Pages\Modules\Data Structures)，不一定是你想要的，下面介绍下如何自定义。

第一步：生成DoxygenLayout.xml

run command 执行doxygen -l，生成DoxygenLayout.xml文件，如果没生成的话（估计和C盘管理员权限有关），把Doxygen安装好的文件夹复制到D盘，run cmd切换到复制后的路径再执行doxygen -l。

第二步：编辑DoxygenLayout.xml

在<navindex>修改可以默认目录名字、添加用户自定义页面page。

2.1 修改默认目录名字

比如默认目录名Modules，修改为API Manual

<tab type="modules" visible="yes" title="" intro=""/>

修改为

<tab type="modules" visible="yes" title="API Manual" intro=""/>

2.2 添加用户自定义page

在<navindex>插入如下内容，插入位置决定了显示位置

<tab type="user" url="@ref customer_page" title="customer page"/>

相应的用户定义文件内容参考

第三步：配置doxywizard工具

第四步：点击Run doxygen就生效了。