在 Doxygen 中，如何使用 .md“启动页面”生成组文档？

编程问答 2022-05-27

问题描述

与How to use Markdown pages and Doxygen groups?有些相关：

我想使用 Doxygen 的降价处理器使用 .md 文件编写高级子系统描述。直观地说，这个文件似乎应该有 @defgroup ，而 .hpp 文件在关键类、函数等中应该有 @ingroup 。

但这似乎不适用于纯 .md 文件。如果我在 .md 文件的开头执行此操作：

# My Subsystem {#Subsystem}
[TOC]
# First Real Header

然后我会得到一个@page Subsystem，但是我不能向那个组添加代码结构（@ingroup Subsystem 没有效果）。

如果我在 .md 文件的开头执行此操作：

@defgroup Subsystem My Subsystem
[TOC]
# First Real Header

它有点工作，但没有生成目录，页面布局如下：

Files
-----
...
Classes
-------
...
Detailed Description
--------------------

First Real Header
----------------
...

理想情况下，我会喜欢文件/类/函数等之前的详细描述，但也许我要求太多了。此外，缺少的 [TOC] 似乎很奇怪，但也许我将分组行为误用于了它不适合的用途。

如果有人成功地完成了这种类型的事情（子系统 .md 页面 + 合并的源内容），请告诉我。

解决方法

暂无找到可以解决该程序问题的有效方法，小编努力寻找整理中！

如果你已经找到好的解决方法，欢迎将解决方案带上本链接一起发送给小编。

小编邮箱:dio#foxmail.com (将#修改为@）

doxygen