我正在做这个项目:
https://sbl.inria.fr/doc
,其中文档是用
强力根
.
我们用符号“—”来定义各部分的ID,以分隔单词,例如:
\section sec-intro Introduction
但是,看起来自doxygen 1.8.15-git以来,约定已经改变了,只接受字母数字字符,几乎破坏了文档中的所有页面。
不幸的是,我们有大量的页面,在审阅整个文档之前,我想知道是否有我遗漏的内容,比如打开/关闭Doxygen选项。
[编辑]
下面是一个对我不起作用的最小示例,使用doxygen 1.8.15-git:
/**
\mainpage My Main Page
Abstract
\section home-intro Introduction
Intro
*/
//! Documented class test
class test{
};
我只是创建配置文件,然后在包含.hpp文件的目录上运行doxygen(这样就不需要指定头文件的路径):
doxygen -g; doxygen
输出HTML的主页面包含“abstract”,但不包含该部分,并且在doxygen日志中有一条警告:
test.hpp:6: warning: Invalid section id `home'; ignoring section
[编辑2]
它与多西根1.8.14一起工作。我从Git存储库克隆了这个项目,所以我得到了最新的版本。使用1.8.14的标签版本,它工作正常。我改了标题。