我正在研究这个项目:https://sbl.inria.fr/doc ,其中文档是使用 doxygen 完成的。
我们习惯用符号“-”来定义我们的节的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(这样就不需要指定我的 header 的路径):
doxygen -g; doxygen
输出html上的主页包含“Abstract”,但不包含该部分,并且doxygen日志中有警告:
test.hpp:6: warning: Invalid section id `home'; ignoring section
[编辑2]
它适用于 doxygen 1.8.14。我从 git 存储库克隆了该项目,因此我拥有最新版本。使用1.8.14的标签版本,工作正常。我改了标题。
最佳答案
我找到了问题的原因,它是回归:
错误 740046 - -Foo::Bar 中的负号会破坏生成输出中的超链接
导致该问题的 github 问题是 https://github.com/doxygen/doxygen/pull/5677和拉取请求 https://github.com/doxygen/doxygen/pull/704 .
该问题已在建议的补丁中修复:https://github.com/doxygen/doxygen/pull/6388
关于Doxygen : Section id only alphanumerical since 1. 8.15-git,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/51259115/