同命名空间下Doxygen cref无需完整命名空间却无法生效问题
Doxygen v1.10.0同命名空间下C#类跨引用链接失效问题
我在使用Doxygen v1.10.0为C#代码生成文档时遇到了跨引用链接问题:只有使用完整命名空间限定目标类时,链接才能正常生效。对于同命名空间下的普通非泛型类,这种完整限定写法既冗余又降低了文档可读性。
我未找到针对该问题的相关资料,仅看到过关于泛型类cref的问题以及不同命名空间间链接的相关issue。
文档源码示例
GenerationSource.cs
namespace Runevision.LayerGen { /// <summary> /// Unity component that creates a <see cref="TopLayerDependency"/>. <br/> /// Unity component that creates a \ref TopLayerDependency. <br/> /// Unity component that creates a <see cref="Runevision.LayerGen.TopLayerDependency"/>. <br/> /// Unity component that creates a \ref Runevision.LayerGen.TopLayerDependency. /// </summary> public class GenerationSource : MonoBehaviour { } }
TopLayerDependency.cs
namespace Runevision.LayerGen { /// <summary> /// All generation starts with one or more top level dependencies at the root. /// </summary> public class TopLayerDependency { } }
输出情况
生成的文档侧边栏显示两个类处于同一命名空间,但只有使用完整命名空间限定的<see cref="Runevision.LayerGen.TopLayerDependency"/>和\ref Runevision.LayerGen.TopLayerDependency能生成有效链接,其余未加完整命名空间的写法均无法正常跳转。我尝试过切换Doxygen Awesome主题,但问题依然存在。
自定义Doxygen配置
以下是我修改过的Doxygen配置项(其余为默认设置):
PROJECT_NAME = LayerProcGen PROJECT_NUMBER = v0.1.0 PROJECT_BRIEF = "Layer-based infinite procedural generation" OUTPUT_DIRECTORY = Doxygen INLINE_INHERITED_MEMB = YES EXTRACT_STATIC = YES HIDE_SCOPE_NAMES = YES HIDE_COMPOUND_REFERENCE= YES SORT_BRIEF_DOCS = YES SHOW_NAMESPACES = NO FILE_PATTERNS = *.cs \ *.markdown \ *.md RECURSIVE = YES EXCLUDE = Unity/SaveState/FileBasedPlayerPrefs \ doxygen-awesome-css EXCLUDE_PATTERNS = */UnitTests/* USE_MDFILE_AS_MAINPAGE = README.md HTML_EXTRA_STYLESHEET = doxygen-awesome-css/doxygen-awesome.css \ doxygen-awesome-css/doxygen-awesome-sidebar-only.css HTML_COLORSTYLE = LIGHT GENERATE_TREEVIEW = YES GENERATE_LATEX = NO CLASS_GRAPH = TEXT
请问我遗漏了什么配置或设置?
内容的提问来源于stack exchange,提问作者runevision
相关产品推荐
相关产品推荐

