让XCode的文档命令跨越多个单词？

Question

许多关于XCode的新文档命令已经在这里讨论，但即使在那里解释了命令，我似乎找不到一种方法来跨越多个单词。例如，现在有一个输入：“Hi，I am for @a cosmetic purposes only.”，输出为“Hi，I am for cosmetic purposes only.”。如果我想要使单词purposes也变成斜体，就会出问题，因为空格似乎都被修剪掉了。您知道如何解决这个问题吗？

- Gerald Eersteling

Answer 1

我不确定你是否已经知道，但以下内容适用于XCode 6：

斜体：

Hi, I am for <em>cosmetic purposes</em> only.

粗体：

Hi I am for <b>cosmetic purposes</b> only.

我目前正在寻找一个解决方案来处理 @c，但还没有找到。

编辑：好吧，<code>...</code> 可以处理 @c。

- mostruash

---

顺便说一下，试试HTML标签，大部分都能用！你可能会对<li>、<pre>等标签感到惊讶。 - mostruash

是的，我刚刚尝试了很多HTML...真的很惊讶它是如此有效。这使得记录您的代码变得更加出色！ - Gerald Eersteling

<a></a> 的作用是将其下划线和颜色设置为链接的样式，但它并不会打开URL :(. 或许有人可以对其进行调整以使其正常工作，甚至更好的方法是像苹果自己的文档一样重定向到另一个方法。 - Iulian Onofrei

我猜你可以使用href属性使其工作，但你需要生成一个文档集才能像在苹果的文档中一样跟随链接。 - mostruash

Answer 2

您可以按以下方式添加空格：

/*! Sample @a italic ​ @a comment  */

只需在两个标记之间放置空格代码

- Mehul Thakkar

---

这仍然不能使代码跨越多个单词，但是这是一个不错的解决方法。在有真正解决它的方法之前，我会使用它。 - Gerald Eersteling

你可以尝试使用其他特殊字符代码：http://www.sagehill.net/docbookxsl/SpecialChars.html，其中许多可能适用于你。 - Mehul Thakkar

谢谢，我已经了解了文档中字符代码的用法。但是我希望能够找到一种在文档中创建一个真正的<span>标签（即HTML中的<span>标签）的方法。 - Gerald Eersteling

我不认为有这样的文档可用，但仍不确定。 - Mehul Thakkar

嗯。自从Xcode6和Swift出现以来，我一直在暗自希望它们也能添加新的文档命令。然而，可惜至今仍未有所改变。 目前正在扫描Apple-docs，看看它们是否使用了跨度或其他什么东西。 - Gerald Eersteling

如果我有任何消息，我会告诉你。 - Mehul Thakkar