Markdown 如何使用降价页面和强氧组?
我正在用Doxygen和Markdown写一本技术手册。为了生成HTML和Doxygen的简单性而降价,这是因为多年来使用它编写代码的经验,并且知道如何使用Markdown 如何使用降价页面和强氧组?,markdown,doxygen,Markdown,Doxygen,我正在用Doxygen和Markdown写一本技术手册。为了生成HTML和Doxygen的简单性而降价,这是因为多年来使用它编写代码的经验,并且知道如何使用\ingroup工具生成良好的交叉文档 我无法让后者在Doxygen处理降价时正常工作 我想要实现的是编写一份完整的描述性培训文档,但能够标记重要的部分,并让Doxygen将这些部分拉到单独的“提示”页面(例如)中,以便稍后快速参考 这些片段说明了这个问题。所有文件都是.md,我有一个单独的mainpage.md,它工作正常。在doxyfil
\ingroup
工具生成良好的交叉文档
我无法让后者在Doxygen处理降价时正常工作
我想要实现的是编写一份完整的描述性培训文档,但能够标记重要的部分,并让Doxygen将这些部分拉到单独的“提示”页面(例如)中,以便稍后快速参考
这些片段说明了这个问题。所有文件都是.md
,我有一个单独的mainpage.md,它工作正常。在doxyfile中,相关的标记选项设置为“是”。这些组是在.h
文件中使用/***/定义的,因为我无法在.md文件中可靠地运行(这可能与此问题有关)
“组1”文本块
@ingroup group_01
# Group 01 MD heading
Text 1 for Group 1. Mirum est notare quam littera gothica.
第2组的文本有一个
@ingroup group_02
# Group 02 MD Heading
Text 1 for group 2. Lorem banana dolor sit amet elit.
还有一个包含我想要的第一组信息和第二组其他部分信息的文件
@ingroup group_01
@{
# Text 2 group 1
Text 2 for group 1. Duis autem vel eum iriure dolor.
@}
@ingroup group_02
@{
# T2G2 THIS NEVER APPEARS
Text 2 for group 2. Nibble liber tempor cum soluta nobis.
@}
我所期望的是“模块”部分包含两个组的两个条目(确实如此),并且组1/2页面包含由@ingroup标记的文本
我得到的是,第一次看到的@ingroup
正按照我的预期进行处理,而Doxygen正在将各种组条目正确地整理到一个页面上。超出该范围的文本根本不会显示在输出中。如果交换最后一个文件中文本块的顺序,则会出现另一个块,而以前可见的块将消失
如果我不使用@{}
支撑,只使用@ingroup\u 01
和@ingroup\u 02
,我会遇到类似的输出失败。FWIW,@ingroup(group\u 01 group\u 02)
似乎根本不适用于标记文件
我做错了什么
有人对如何实现我的目标有其他建议吗
我使用的是最新发布的Doxygen 1.8.5。Doxygen手册对此没有任何有用的说明
这个问题与一个问题有些相似,但这是从代码的角度来看问题。看来我没有做错什么,对于一个相关问题,显示Doxygen 1.8.5不支持此功能用于标记页面,但Doxygen手册中的“”或“”页面中未(尚未)标记此非功能