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"文件的自定义页面 .