如何在文档注释中使用自定义 link 文本创建代码引用？

Question

我正在将应用程序库从 Java 移植到 C#。在 Java 文档中，有些地方 link 使用自定义文本引用特定代码。例如：

Suffix --> {@link DataOutput#writeString String}

我在 XML 文档评论中尝试使用类似的方法...

Suffix --&gt; <see cref="DataOutput.WriteString(string)">String</see>

...但是当我以这种方式尝试时，整个 link 从 Intellisense 和生成的文档中消失了。问题是，如何在 C# 中使用 .NET XML 文档注释构造带有自定义文本的类似代码 link？如果没有办法，建议的解决方法是什么？

如果重要，我们正在尝试使用 DocFx 代码生成器。

Answer 1

您可以使用 DocFX 的交叉引用语法：[String](xref:DataOutput.WriteString(System.String)).

参见：http://dotnet.github.io/docfx/tutorial/links_and_cross_references.html#different-syntax-of-cross-reference