Fatal编程技术网
  • documentation/
  • Documentation 在Doxygen中，节名称是否必须是全局唯一的？

Documentation 在Doxygen中，节名称是否必须是全局唯一的？

documentation doxygen

Documentation 在Doxygen中，节名称是否必须是全局唯一的？,documentation,doxygen,Documentation,Doxygen,我正在写一些应用程序中模块的概述文档。我主要使用\page，\subpage，\section和\subsection标记 \page和\subpage标记允许我为文档提供一个很好的层次结构，它清晰地显示在网页的标题中，或者在使用QHelpGenerator转换为Qt帮助时用于构建目录。因此，我理解页面应该有唯一的名称 当我在我的页面中为我的部分命名时，比如“概述”、“简介”、“部分1”、“部分2”等等，当我构建文档的子集时，它似乎工作正常。看起来分区名称不必是唯一的 但是，当我构建一组更大的文

我正在写一些应用程序中模块的概述文档。我主要使用
\page
，
\subpage
，
\section
和
\subsection
标记

\page
和
\subpage
标记允许我为文档提供一个很好的层次结构，它清晰地显示在网页的标题中，或者在使用QHelpGenerator转换为Qt帮助时用于构建目录。因此，我理解页面应该有唯一的名称

当我在我的页面中为我的部分命名时，比如“概述”、“简介”、“部分1”、“部分2”等等，当我构建文档的子集时，它似乎工作正常。看起来分区名称不必是唯一的

但是，当我构建一组更大的文档文件时，有些页面不再正确创建。这可能是由于节名称不是全局唯一的吗

我试图找到有关节名称全局唯一性的信息，但找不到任何关于节名称唯一性的声明。它们必须是全球唯一的吗

编辑：
我现在注意到，如果一个文件有一个id为X和标题a的节，而另一个文件有一个id为X和标题B的节，那么这两个文件在生成的文档（a或B）中都会获得相同的标题。因此，这似乎表明id应该是全局唯一的。有没有办法避免这种情况？

doxygen中的节名称是全局唯一的。这允许从文档的任何部分引用节（
\ref
）

如果您只查找一个节标题（其中id未使用/不重要），则可以使用其他机制之一指定Doxygen提供的标题，例如：

  • 对标题使用HTML标记：

    <h1>Header 1</h1>
<h2>Header 2</h2>
<h3>Header 3</h3>
    或

自1.8.0以来，Doxygen支持降价 
Header 1
========

Header 2
--------

# Header 1
## Header 2
### Header 3