如何解决在 Doxygen 中,如何使用 .md“启动页面”生成组文档?
与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 举报,一经查实,本站将立刻删除。