我在我的代码库中设置了Doxygen,并希望使用Markdown支持来制作一些不同的“如何”和#39;和'设计'在逻辑层次结构中键入页面,例如
index.md
design/
architecture.md
database.md
how-to/
build.md
restore-backups.md
...etc...
使用Markdown支持,我可以为每个页面添加标签,然后使用这些标签链接到其他页面并创建页面层次结构,例如
Design {#design}
======
This section contains design documentation.
@subpage architecture
@subpage database
我遇到的问题是,这意味着层次结构中的每个级别都需要定义哪些页面是其子页面。这会使文档中包含许多我不太需要的链接。当层次结构深度达到3级以上时,最终会出现大量虚拟页面,这些页面仅用于定义子页面。
我的问题是,是否可以在一个外部页面中定义整个导航层次结构,以便在添加新页面时只有一个地方可以定义和更新?类似的东西:
Navigation {#navigation}
=========
This page defines the navigation tree for the whole project.
@page design
@subpage architecture
@subpage database
@page how-to
@subpage build
... etc ...