Swift是否支持文档生成?

许多语言都支持文档注释，以允许生成器(如javadoc或doxygen)通过解析相同的代码来生成代码文档。

Swift有类似的文档注释功能吗?

当前回答

Jazzy可以帮助生成漂亮的苹果风格的文档。下面是一个示例应用程序，详细介绍了如何快速使用和配置。

https://github.com/SumitKr88/SwiftDocumentationUsingJazzy

其他回答

我可以确认ShakenManChild已经为人们提供了解决方案

只要确保在描述下面有一个空行!

如果你只使用Swift，那么Jazzy值得一看。

https://github.com/realm/jazzy

从Xcode 5.0开始，支持Doxygen和HeaderDoc结构化注释。

源

在Xcode 8中，你可以这样选择一个方法

func foo(bar: Int) -> String { ... }

然后按command + option + /或在Xcode的“编辑器”菜单中选择“结构”-“添加文档”，它会为你生成如下注释模板:

/// <#Description#>
///
/// - parameter bar: <#bar description#>
///
/// - returns: <#return value description#>

也许关注一下AppleDoc或苹果自己的HeaderDoc是个好主意，它不太被认可。我仍然可以在10.9 Mavericks终端中找到一些HeaderDoc提示(headerdoc2html)

我推荐阅读最新的“Xcode的新功能”*(不确定它是否仍处于保密协议之下) *链接指向Xcode 5.1版本，其中也包含有关HeaderDoc的信息。

推荐文章