私が達成したいこと:
Doxygen で生成しているドキュメントに特定のものをリストしたいと思います (todo私の例では恣意的であると考えてください)。Summonsカスタム項目 ( \summon)を使用Summonsして、ファイルに文書化されたすべてのリストを表示したり、システム全体のそれらすべてをファイルごとに分割してリストしたページを生成したりしたいと考えています。
(ここでは、ラテックスではなく、HTML ドキュメントの生成にのみ関心があります。)
次に例を示します。
Foo.c のドキュメント (たとえばfoo_c.htmlなど):
召喚：
- アンゴラ山羊を召喚する
- ボーアヤギを召喚する
Bar.c のドキュメント:
召喚：
- 殺意の象を召喚する
文書化されたすべての召喚状の他の文書ページ (たとえばsummons_global_list.c、ナビゲーション タブなどからアクセス可能):
Foo.c:
- アンゴラ山羊を召喚する
- ボーアヤギを召喚する
Bar.c:
- 殺意の象を召喚する
これまでにできることとできないこと：
/xrefitem エイリアス ( ALIASES += "summon=\xrefitem req \"Summon\" \"Summons\" ")を使用して、todoスタイル リストを取得できます。それはいいです。
でも...
/*!
* ...other things go here..
*
* \summon an Angora goat
*/
...code here...
/*
* \summon a Boer goat
*/
リストヘッダーが2回表示されます。たとえば、次のようになります。
召喚：
- アンゴラ山羊を召喚する
召喚：
- ボーアヤギを召喚する
どうすればそれを回避できますか？
また、ファイルごとにすべての「召喚」を一覧表示するカスタム ページを取得する方法についてもかなり困惑しています。