我可以抑制真空'；更多…'；Doxygen类参考页上的链接？

Doxygen类参考页主要由类成员列表组成，每个列表后面都有其简要说明（如果存在）。成员本身是指向该成员详细信息页面的链接。简短的描述后面总是有一个“更多…”链接。此链接的内容与成员本身的内容相同。这个“更多…”链接表明——至少对我来说——在该链接的另一端有一个更扩展的描述。当成员只有简短的描述时，这会产生误导。在这种情况下，链接指向一个页面，该页面简单地重复该简要描述，然后声明“文件abcxyz.ext的第NN行的定义”

有没有办法让Doxygen来抑制这些令人沮丧的空洞的“更多…”链接？

（暂时的回答，因为这个特殊情况不是我需要做的事情。）

如果您希望删除所有详细描述（因此，可能还有指向它的链接），则可以修改“布局”文件，使该部分不可见

参考：

或者

---

根据您的描述，它听起来像是

REPEAT\u-BRIEF

被设置为on。如果在第一个句号之后确实没有任何描述，那么您可能会发现关闭REPEAT_BRIEF将删除链接，因为那里的文本确实是空白的。

可能有点晚了，但我遇到了同样的问题，并通过以下doxyfile配置轻松解决了它：

ALWAYS_DETAILED_SEC = NO
BRIEF_MEMBER_DESC = YES
REPEAT_BRIEF = NO
EXTRACT_ALL = NO
# Since EXTRACT_ALL is NO, configure the following as you wish. In my case
EXTRACT_PRIVATE = YES
EXTRACT_STATIC = YES
EXTRACT_LOCAL_CLASSES = YES
EXTRACT_LOCAL_METHODS = YES

---

我希望这能有所帮助。

doxygen 1.8.10的实验补丁，它允许您通过在Doxyfile中使用“USE\u More\u LINK=NO”删除“More…”链接

<!-- language: diff -->
=== modified file 'src/classdef.cpp'
--- src/classdef.cpp    2015-07-06 11:29:12 +0000
+++ src/classdef.cpp    2015-07-06 11:37:57 +0000
@@ -1802,12 +1802,14 @@

   // HTML only
   ol.pushGeneratorState();
-  ol.disableAllBut(OutputGenerator::Html);
-  ol.docify(" ");
-  ol.startTextLink(getOutputFileBase(),
-      anchor.isEmpty() ? QCString("details") : anchor);
-  ol.parseText(theTranslator->trMore());
-  ol.endTextLink();
+  if (Config_getBool("USE_MORE_LINK")) {
+    ol.disableAllBut(OutputGenerator::Html);
+    ol.docify(" ");
+    ol.startTextLink(getOutputFileBase(),
+        anchor.isEmpty() ? QCString("details") : anchor);
+    ol.parseText(theTranslator->trMore());
+    ol.endTextLink();
+  }
   ol.popGeneratorState();

   if (!anchor.isEmpty())

=== modified file 'src/config.xml'
--- src/config.xml  2015-07-06 11:29:12 +0000
+++ src/config.xml  2015-07-06 11:57:09 +0000
@@ -366,6 +366,13 @@
 ]]>
       </docs>
     </option>
+    <option type='bool' id='USE_MORE_LINK' defval='1'>
+      <docs>
+<![CDATA[
+ Experimental parameter, which allows you to remove the "More..." links by using USE_MORE_LINK = NO.
+]]>
+      </docs>
+    </option>
     <option type='list' id='ABBREVIATE_BRIEF' format='string'>
       <docs>
 <![CDATA[

=== modified file 'src/filedef.cpp'
--- src/filedef.cpp 2015-07-06 11:29:12 +0000
+++ src/filedef.cpp 2015-07-06 11:31:41 +0000
@@ -373,8 +373,8 @@
       ol.writeString(" \n");
       ol.enable(OutputGenerator::RTF);

-      if (Config_getBool("REPEAT_BRIEF") ||
-          !documentation().isEmpty()
+      if ( (Config_getBool("REPEAT_BRIEF") || !documentation().isEmpty() ) &&
+          Config_getBool("USE_MORE_LINK")
          )
       {
         ol.disableAllBut(OutputGenerator::Html);

=== modified file 'src/memberdef.cpp'
--- src/memberdef.cpp   2015-07-06 11:29:12 +0000
+++ src/memberdef.cpp   2015-07-06 11:37:48 +0000
@@ -1805,22 +1805,24 @@
       {
         static bool separateMemberPages = Config_getBool("SEPARATE_MEMBER_PAGES");
         ol.pushGeneratorState();
-        ol.disableAllBut(OutputGenerator::Html);
-        //ol.endEmphasis();
-        ol.docify(" ");
-        if (separateMemberPages ||
-            (m_impl->group!=0 && gd==0) ||
-            (m_impl->nspace!=0 && nd==0)
-           ) // forward link to the page or group or namespace
-        {
-          ol.startTextLink(getOutputFileBase(),anchor());
-        }
-        else // local link
-        {
-          ol.startTextLink(0,anchor());
-        }
-        ol.parseText(theTranslator->trMore());
-        ol.endTextLink();
+        if (Config_getBool("USE_MORE_LINK")) {
+          ol.disableAllBut(OutputGenerator::Html);
+          //ol.endEmphasis();
+          ol.docify(" ");
+          if (separateMemberPages ||
+              (m_impl->group!=0 && gd==0) ||
+              (m_impl->nspace!=0 && nd==0)
+             ) // forward link to the page or group or namespace
+          {
+            ol.startTextLink(getOutputFileBase(),anchor());
+          }
+          else // local link
+          {
+            ol.startTextLink(0,anchor());
+          }
+          ol.parseText(theTranslator->trMore());
+          ol.endTextLink();
+        }
         //ol.startEmphasis();
         ol.popGeneratorState();
       }

==修改的文件“src/classdef.cpp”
---src/classdef.cpp 2015-07-06 11:29:12+0000
+++src/classdef.cpp 2015-07-06 11:37:57+0000
@@ -1802,12 +1802,14 @@
//仅限HTML
ol.pushGeneratorState（）；
-ol.disableAllBut（OutputGenerator:：Html）；
-ol.文件化（“”）；
-ol.startTextLink（getOutputFileBase（），
-isEmpty（）？QCString（“详细信息”）：anchor）；
-解析文本（Translator->trMore（））；
-ol.endTextLink（）；
+if（Config_getBool（“使用更多链接”））{
+ol.disableAllBut（OutputGenerator:：Html）；
+ol.文件化（“”）；
+ol.startTextLink（getOutputFileBase（），
+isEmpty（）？QCString（“详细信息”）：anchor）；
+解析文本（Translator->trMore（））；
+ol.endTextLink（）；
+  }
ol.popGeneratorState（）；
如果（！anchor.isEmpty（））
==修改的文件“src/config.xml”
---src/config.xml 2015-07-06 11:29:12+0000
+++src/config.xml 2015-07-06 11:57:09+0000
@@ -366,6 +366,13 @@
]]>
+    
+      
+
+      
+    
组=0&&gd==0）||
-（m_impl->nspace！=0&&nd==0）
-）//转发到页面、组或命名空间的链接
-        {
-ol.startTextLink（getOutputFileBase（），anchor（））；
-        }
-else//本地链接
-        {
-ol.startTextLink（0，anchor（））；
-        }
-解析文本（Translator->trMore（））；
-ol.endTextLink（）；
+if（Config_getBool（“使用更多链接”））{
+ol.disableAllBut（OutputGenerator:：Html）；
+//ol.endEmphasis（）；
+ol.文件化（“”）；
+如果（分隔的成员页）||
+（m_impl->group！=0&&gd==0）||
+（m_impl->nspace！=0&&nd==0）
+）//转发到页面、组或命名空间的链接
+          {
+ol.startTextLink（getOutputFileBase（），anchor（））；
+          }
+else//本地链接
+          {
+ol.startTextLink（0，anchor（））；
+          }
+解析文本（Translator->trMore（））；
+ol.endTextLink（）；
+        }
//ol.startEmphasis（）；
ol.popGeneratorState（）；
}

这显然不是我所希望的语义。我努力为每个符号写一个简短的定义。有时我会提供额外的材料。它是作为简要描述的精化而写的。因此，我指定REPEAT_BRIEF=YES，我想要的是让doxygen确定一个符号是否有任何超出简要描述的文档。当没有的时候，我想要“更多…”被抑制，因为它错误地暗示实际上有更多的东西要读。相比之下，当有一个详细说明时，我希望“更多…”引出一个以简要描述开头的段落。我可以尝试实现设置的想法：根据我的原始问题的标题使用\u More\u LINK=NO，我想抑制更多的空洞。。。链接。我想要更多。。。当除了简要说明之外还有其他文档时，请链接。当它是空的，没有任何文档或者只有一个简短的描述时，我希望它被抑制。我认为这不需要新的Doxyfile标记。我认为这是所有用户都会欣赏的行为。至少，如果有一个新的标记，那么上面的行为应该是默认的，并且标记应该允许恢复今天的不幸行为。