MAML equivalent of "<see cref="T:Foo.Bar">link text</see>"?

Topics: Developer Forum, User Forum
Mar 12, 2014 at 10:29 AM
As far as I can tell there is none - <see> is more or less equivalent to <codeEntityReference>, but the latter does not provide a means of explicitly specifying the link text.

Would it be possible/acceptable to support a linkText attribute on <codeEntityReference>?

That would also provide a convenient means of referencing the API documentation via something like
See the <codeEntityReference linkText="Foo library reference">R:Project_Foo</codeEntityReference> for details on the API.
Coordinator
Mar 12, 2014 at 8:44 PM
There isn't an inner text equivalent but the linkText attribute is easily added. Locate the ddue:codeEntityReference template in the utilities_dduexml.xml transformation file in the presentation style you are using and add this just inside the closing referenceLink end tag:
<xsl:if test="normalize-space(@linkText)">
  <xsl:value-of select="normalize-space(@linkText)"/>
</xsl:if>

I'll add it for the next release and in the schema too.

Eric