在 doxygen 布局中添加新用户选项卡

我是使用 doxygen 1.8.7 的新手。我正在尝试将架构图添加为使用 doxygen 为我的 C# 项目生成的 API 文档的一部分。我生成了默认的 doxygen 布局文件 (DoxygenLayout.xml) 并通过添加以下更改来编辑它 -

<navindex>
    <tab type="mainpage" visible="yes" title="">
        <tab type="mainpage" visible="yes" title="Audience" />
        <tab type="user" url="@ref Architecture" title="My Page" />
    </tab>
    <tab type="pages" visible="yes" title="" intro=""/>
    <tab type="modules" visible="yes" title="" intro=""/>
    <tab type="namespaces" visible="yes" title="">
      <tab type="namespacelist" visible="yes" title="" intro=""/>
      <tab type="namespacemembers" visible="yes" title="" intro=""/>
    </tab>
    <tab type="classes" visible="yes" title="">
      <tab type="classlist" visible="yes" title="" intro=""/>
      <tab type="classindex" visible="$ALPHABETICAL_INDEX" title=""/> 
      <tab type="hierarchy" visible="yes" title="" intro=""/>
      <tab type="classmembers" visible="yes" title="" intro=""/>
    </tab>
    <tab type="files" visible="yes" title="">
      <tab type="filelist" visible="yes" title="" intro=""/>
      <tab type="globals" visible="yes" title="" intro=""/>
    </tab>
    <tab type="examples" visible="yes" title="" intro=""/>  

  </navindex>

架构图是一个外部文档，不是通过运行 doxygen 生成的。 所以我的问题是 - 我该把这个架构文档放在哪里？或者它应该是项目解决方案的一部分。

这很容易实现。通过生成自定义，您已经完成了最困难的部分DoxygenLayout.xml文件。现在，您只需添加一个自定义选项卡即可：

<tab type="user" url="architecture.html" title="Architecture"/>

你可以把它放在你想要的任何地方<navindex>标签。出于测试目的，您可以将其扔到组的最后。

The title属性可以是您想要的任何文本字符串。

The url属性可以是您想要的任何文件的 URL。当然，它不一定是 HTML 文件。它可以是 PDF、Word DOC 或其他任何形式。您还可以使用"@ref mypage"链接到名为的 doxygen 页面mypage (详细信息请参阅文档).