xcode - Xcode 注释中的超链接

Question

我正在为我的代码添加一个超链接以供将来引用。通过从 Safari 复制 url 然后将其粘贴到 Xcode 来添加超链接。

问题是我无法控制超链接，因为它已粘贴到我的代码中，并且在添加其他文本时正在修改它。

Example URL: https://link.to.resource/DID/
How I want the link to be displayed:  Device ID (listed in https://link.to.resource/DID/.)

如何在不修改链接位置的情况下添加附加文本？当我在末尾添加 ./ 时，它成为链接的一部分并且该地址不再有效。

Answer 1

最简单的解决方案是在链接末尾包含一个空格或右括号。

您还可以使用注释标记添加指向 Xcode 的快速帮助文档的链接。

/// Device ID (listed [here](https://link.to.resource/DID/))

这将创建如下所示的快速帮助说明:

如果您确实在链接末尾设置了句点，则可以将其添加到链接文本末尾的 [] 中。这就是 Apple 在其链接标记示例之一中所做的。这会在末尾添加句点，但句点的样式会作为链接文本的一部分。

/*:
  For more information, see [The Swift Programming Language.](http://developer.apple.com/library/ios/documentation/Swift/Conceptual/Swift_Programming_Language/)
 */

Apple 的链接标记文档:https://developer.apple.com/library/content/documentation/Xcode/Reference/xcode_markup_formatting_ref/Links.html#//apple_ref/doc/uid/TP40016497-CH18-SW1