Markdown 尝试将多个README.md文件合并到Doxygen转储中_Markdown_Documentation_Doxygen_Readme

Markdown 尝试将多个README.md文件合并到Doxygen转储中

markdown documentation doxygen

Markdown 尝试将多个README.md文件合并到Doxygen转储中,markdown,documentation,doxygen,readme,Markdown,Documentation,Doxygen,Readme,我看不到上述问题的答案，所以我的问题是：我有一套项目。它们表示为嵌套的Git子模块，如下所示： MAIN-PROJECT LIBRARY-1 LIBRARY-2 ETC. 每个子模块都有一个README.md文件和CHANGELOG.md文件（标准GitHub型号）：我想做的是，使用“根”自述文件作为转储中的主页，但仍然呈现内部自述文件，因为每个自述文件都有很好的信息我不想单独构建每个Doxygen转储。我希望有一个从“根”开始的单一、整体

我看不到上述问题的答案，所以我的问题是：

我有一套项目。它们表示为嵌套的Git子模块，如下所示：

MAIN-PROJECT
    LIBRARY-1
        LIBRARY-2
            ETC.

每个子模块都有一个README.md文件和CHANGELOG.md文件（标准GitHub型号）：

我想做的是，使用“根”自述文件作为转储中的主页，但仍然呈现内部自述文件，因为每个自述文件都有很好的信息

我不想单独构建每个Doxygen转储。我希望有一个从“根”开始的单一、整体的转储。这是因为我希望类和其他东西链接起来

有办法做到这一点吗？我尝试显式指定“Root”自述文件，但看起来您只能给出文件名，而不能给出路径。这意味着每一个自述文件都会被考虑到，而获胜的是“最深”的自述文件。

要能够使用多个“README.md”文件，需要考虑以下几点：

使用
```
USE\u MDFILE\u AS\u MAINPAGE
```
时，使用相对路径指定mair README.md
或者使用母版“README.md”中的
```
\mainpage
```
在另一个“README.md”中使用
```
\page
```
，以便区分不同的文件

另请注意

\subpage

和

\ref

引用其他页面的可能性

您是否在较低级别的自述文件中放置了

\page

命令？您是否尝试使用完整路径（./README.md）指定自述文件？谢谢。我确实尝试了完整路径，但没有成功（看起来它只需要文件名，并且查看了您包含的内容）。让我看看\page命令。我写的是完整路径，但我指的是相对路径（sen the./README.md）。也可能是路径的混合和\page命令的使用。你使用的是哪个版本的doxygen（可能是必需的）我在Mac上使用的是最新的（有点旧的）1.8.14。我本可以用这个路径名。我现在正在重温一切。我取消了\page命令，我有一种感觉，我可以将它与\mainpage结合起来，以满足我的需要。如果是的话，我建议你用这个短语作为答案，这样我可以给你一张漂亮的绿支票。我差不多有了。我很高兴给你一张漂亮的绿色支票，如果你把你的评论改成回答的话。我现在遇到的问题是，内部自述文件在列表中显示为自述文件（不显示任何内容）和按标题显示的页面（显示呈现的标记）。我相信我会弄明白的。谢谢

MAIN-PROJECT
    README.md
    CHANGELOG.md
    LIBRARY-1
        README.md
        CHANGELOG.md
        LIBRARY-2
            README.md
            CHANGELOG.md
            ETC.