markdown - 使用 README.md 文件作为 Doxygen 中的主页

Question

Doxygen 的文档指出，我可以在 Markdown 文件中使用 PHP Markdown Extra 标题标签，但两者都没有

# Main Page # {#mainpage}

也不

# Main Page # {#index}

有效，但标签也不以纯文本形式出现在输出中。顺便说一句，这是第一行。

此外，我无法使用上述标签或文件名来引用该页面。

我还有一个 main.dox 文件，其中包含 \mainpage 特殊命令，但我也尝试了上述所有操作，删除了它们前面的一个斜杠(以使其只有两个)。

我使用 Doxygen 1.8.2(已下载)和 1.8.1.1(来自 MacPorts)来执行该任务。

那我怎样才能实现这个目标呢？

另外，如何将 Markdown 文件标记为特定语言的一部分？

编辑:我启用了 Markdown 支持，并且该文件出现在引用的页面中。

Answer 1

在 doxygen 的下一个版本(1.8.3)中，我计划引入一个新的配置选项USE_MDFILE_AS_MAINPAGE，它可用于指定要用作主页的 Markdown 页面。然后你可以如下配置doxygen:

INPUT                  = README.md other_sources
USE_MDFILE_AS_MAINPAGE = README.md

无论页面标题如何，它都会起作用。