What I want to achieve:

我想在Doxygen生成的文档中列出某些内容(想想 todo ,在我的例子中,它们是任意的 Summons ) . 我想使用自定义项目( \summon ),因此我可以列出文件中记录的所有 Summons 列表,并生成一个页面,列出整个系统中的所有项目,按文件拆分 .

(我只关心在这里生成HTML文档,而不是乳胶 . )

这是一个例子:

在Foo.c的文档中(比如 foo_c.html ,或者其他):

传票:

  • 召唤一只安哥拉山羊

  • 召唤一只波尔山羊

在Bar.c的文档中:

传票:

  • 召唤一个杀气腾腾的大象

在所有记录的传票的一些其他文档页面中(例如 summons_global_list.c ,可从导航选项卡或类似文件访问):

foo.c的:

  • 召唤一只安哥拉山羊

  • 召唤一只波尔山羊

Bar.c:

  • 召唤一个杀气腾腾的大象

What I can and can't do so far:

使用/ xrefitem别名( ALIASES += "summon=\xrefitem req \"Summon\" \"Summons\" " ),我可以获得 todo 样式列表 . 没关系 .

然而...

/*!
 * ...other things go here..
 *
 * \summon an Angora goat
 */

 ...code here...

/*
 * \summon a Boer goat
 */

给我列表 Headers 两次,例如:

传票:

  • 召唤一只安哥拉山羊

传票:

  • 召唤一只波尔山羊

我怎么能绕过那个?

我也很难得到如何获得列出所有"Summons"文件的自定义页面 .