我刚刚升级到Xcode 6.3并且它支持Swift 1.2。作为description
协议的一部分,我在Printable
变量的swift文件中加载了快速文档。
我注意到文档有一个很好的内联代码块。我还不确定是否在之前版本的swift中存在这种情况,以及它是否是特殊的"或者他们为内联文档添加了更多功能支持。
任何人都知道如何为我自己的快速帮助做到这一点?
我相信Obj-c文档有更多"功能"也许因为这是Objc协议的一部分,这就是为什么文档是"幻想"
更新以下内容:
/**
Test Protocol Definition
Code Block
**BOLD**
*/
呈现为:
答案 0 :(得分:1)
经过一些"调查"我能找到最接近答案的地方是:https://developer.apple.com/swift/blog/?id=24
根据熟悉的Markdown语法,通过在评论中添加特殊标记,可以轻松地将样式化文本添加到游乐场。一些可用的样式是标题,粗体,斜体,列表,项目符号以及指向外部或捆绑资源的链接。
虽然博客文章专门讨论了新的 Playgrounds ,但似乎他们在Xcode中使用了相同的渲染器来生成quick-doc / quick-help(这很棒)。
我收集的内容是支持以下内容
以下似乎不起作用:
Playground markdown文档在这里:https://developer.apple.com/library/prerelease/ios/documentation/Swift/Reference/Playground_Ref/Chapters/MarkupReference.html但是如上所示,并非所有内容都适用于代码的内联文档