代码之家  ›  专栏  ›  技术社区  ›  redantlabs

doxygen:段ID自1.8.15-git以来仅为字母数字

  •  2
  • redantlabs  · 技术社区  · 7 年前

    我正在做这个项目: 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的标签版本,它工作正常。我改了标题。

    1 回复  |  直到 7 年前
        1
  •  2
  •   albert    7 年前