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）来完成这项任务。

那我该如何实现呢？

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

编辑：我启用了降价支持，文件出现在引用的页面中。

score 144 · Accepted Answer

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

INPUT                  = README.md other_sources
USE_MDFILE_AS_MAINPAGE = README.md

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

score 14 · Accepted Answer

请尝试以下方法将标题标记为 1 级标题：

Main Page {#mainpage}
=========

使用 doxygen 1.8.2，这使页面成为index.html我的页面。

doxygen 文档确实声明以单个开头的行#声明了 1 级标题，但它似乎也不适用于我。

2 回答 2