nef for Mac 版
Xcode Playgrounds 的类固醇
nef 是什么
nef 是一个帮助开发者用 Xcode Playground 编写文档的工具集,名字取自 Nefertiti。它受 Kotlin 的 ΛNK 和 Scala 的 tut 启发,目标是把 Playground 里可运行的示例代码变成可发布、可验证的文档。
它的核心能力围绕 Playground 展开:支持引入第三方库来创建 Xcode Playground,并能从命令行编译这些 Playground;可以把 nef Playground 导出为 Markdown,生成的 Markdown 文件能被 Jekyll 直接消费,用来搭建文档微站点;还能为指定的 nef Playground 导出 Carbon 代码片段。此外,它支持根据 Swift Package 中定义的外部依赖构建 iPad 上的 Playground Book。
nef 解决的是文档示例代码容易过时、难以验证的问题——它在编译期对文档进行校验,确保示例真实可运行。它适合需要为 Swift 项目编写高质量文档的开发者,尤其是希望用 Playground 做示例、再发布成网站或教学材料的团队。除了命令行,nef 也提供 Xcode 编辑器扩展和 iPad 上的 nef Playgrounds 应用,还可以作为库集成到 macOS 项目中,方便在其之上构建新工具。
它的核心能力围绕 Playground 展开:支持引入第三方库来创建 Xcode Playground,并能从命令行编译这些 Playground;可以把 nef Playground 导出为 Markdown,生成的 Markdown 文件能被 Jekyll 直接消费,用来搭建文档微站点;还能为指定的 nef Playground 导出 Carbon 代码片段。此外,它支持根据 Swift Package 中定义的外部依赖构建 iPad 上的 Playground Book。
nef 解决的是文档示例代码容易过时、难以验证的问题——它在编译期对文档进行校验,确保示例真实可运行。它适合需要为 Swift 项目编写高质量文档的开发者,尤其是希望用 Playground 做示例、再发布成网站或教学材料的团队。除了命令行,nef 也提供 Xcode 编辑器扩展和 iPad 上的 nef Playgrounds 应用,还可以作为库集成到 macOS 项目中,方便在其之上构建新工具。
如何安装 nef
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2022-01-19,当前版本 0.7.1,共记录最近 10 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| 0.7.1 | 2022-01-19 | 稳定版 | — | — | — | — |
| 0.7.0 | 2021-11-02 | 稳定版 | — | — | — | — |
| 0.6.2 | 2020-07-24 | 稳定版 | — | — | — | — |
| 0.6.1 | 2020-04-30 | 稳定版 | — | — | — | — |
| 0.6.0 | 2020-03-19 | 稳定版 | — | — | — | — |
| 0.5.2 | 2020-01-09 | 稳定版 | — | — | — | — |
| 0.4.0 | 2019-11-25 | 稳定版 | — | — | — | — |
| 0.3.2 | 2019-10-02 | 稳定版 | — | — | — | — |
| 0.3.1 | 2019-07-15 | 稳定版 | — | — | — | — |
| 0.3.0 | 2019-07-09 | 稳定版 | — | — | — | — |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| nef | 0.7.1 | Apache-2.0 | 命令行 | 0 |
| xcenv | v1.2.0 | MIT | 命令行 | 6 |
| BuildSettingExtractor | v1.4.8 | — | 通用二进制 | 1 |
| X-SwiftFormat | 2.1 | — | 通用二进制 | 1 |