我想要达到的目标:
我想在使用 Doxygen 生成的文档中列出某些内容(想想todo
,在我的示例中它们是任意Summons
的)。我想使用自定义项 ( \summon
),这样我就可以列出Summons
文件中记录的所有内容,还可以生成一个页面,列出整个系统中的所有内容,按文件拆分。
(我只关心在这里生成 HTML 文档,而不是乳胶。)
这是一个例子:
在 Foo.c 的文档中(例如foo_c.html
,或其他):
传票:
- 召唤一只安哥拉山羊
- 召唤一只布尔山羊
在 Bar.c 的文档中:
传票:
- 召唤一头凶残的大象
在所有记录的召唤的其他文档页面中(例如summons_global_list.c
,可从导航选项卡或类似选项卡访问):
Foo.c:
- 召唤一只安哥拉山羊
- 召唤一只布尔山羊
酒吧.c:
- 召唤一头凶残的大象
到目前为止我能做什么和不能做什么:
使用 /xrefitem 别名 ( ALIASES += "summon=\xrefitem req \"Summon\" \"Summons\" "
),我可以获得todo
样式列表。没关系。
然而...
/*!
* ...other things go here..
*
* \summon an Angora goat
*/
...code here...
/*
* \summon a Boer goat
*/
给了我两次列表标题,例如:
传票:
- 召唤一只安哥拉山羊
传票:
- 召唤一只布尔山羊
我怎样才能解决这个问题?
我也很困惑如何获得一个按文件列出所有“召唤”的自定义页面。