Adding new user Tab in the doxygen Layout

Question

I am new to using doxygen 1.8.7. I am trying to add the Architecture diagram to be the part of the API documentation generated for my C# project using doxygen. I generated the default doxygen Layout file (DoxygenLayout.xml) and edited it by adding the below changes -

<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>

The Architecture diagram is an external document and is not generated by running doxygen. So my question is - Where do I put this Architecture Document?? Or should it be a part of the project solution.

Answer 1

This is very simple to accomplish. You've already done the hard part by generating the custom DoxygenLayout.xml file. Now, you just need to add a custom tab to it:

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

You can put that wherever you want under the <navindex> tag. For testing purposes, you can just toss it in at the very end of the group.

The title attribute can be any text string that you want.

The url attribute can be a URL to any file you want. It doesn't have to be an HTML file, of course. It can be a PDF, Word DOC, or whatever. You can also use "@ref mypage" to link to a doxygen page named mypage (see the documentation for details).