ronn-ng for Mac 版
从 Markdown 构建手册页
ronn-ng 是什么
Ronn-NG 是已停止维护的原始 Ronn 项目的一个新分支,目前仍在持续维护。它的用途是生成手册页:把简单易读的纯文本文件转换成供终端显示的 roff 格式,同时也能输出网页用的 HTML。源文件格式涵盖 Markdown 的全部语法,但结构更严格,并针对手册页常见需求做了语法扩展,比如定义列表、链接标记等,具体格式在 ronn-format(7) 手册页中有详细说明。man/ 目录下的 .ronn 文件展示了它的多种能力。如果你需要其他选择,pandoc 同样能把 Markdown 转成 roff 手册页。这个工具适合需要为命令行工具、库或格式编写文档的开发者——手册页结构固定、读者一看就熟,先给 SYNOPSIS 再展开细节,兼具速查和参考两种用途;而且它刻意只保留少量文本格式能力,避免文档层级过于复杂。
如何安装 ronn-ng
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2024-01-08,当前版本 v0.10.1,共记录最近 9 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| v0.10.1 | 2024-01-08 | 稳定版 | — | — | — | — |
| v0.9.1 | 2020-04-09 | 稳定版 | — | — | — | — |
| v0.9.0 | 2019-12-22 | 稳定版 | — | — | — | — |
| v0.8.2 | 2019-03-05 | 稳定版 | 65 KB | — | — | — |
| v0.8.1 | 2019-03-05 | 稳定版 | 65 KB | — | — | — |
| v0.8.0 | 2018-12-26 | 稳定版 | — | — | — | — |
| v0.10.1.pre6 | 2024-01-06 | 预发布 | — | — | — | — |
| v0.10.1.pre4 | 2024-01-04 | 预发布 | — | — | — | — |
| v0.8.1.beta.1 | 2019-02-17 | 预发布 | 65 KB | — | — | — |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- Apple 芯片 · 最新 macOS
- Apple 芯片 · macOS 26 Tahoe
- Apple 芯片 · macOS 15 Sequoia
- Apple 芯片 · macOS 14 Sonoma
- Intel · macOS 14 Sonoma
- Linux · ARM64
- Linux · x86_64
不能与以下软件包同时安装: ronn。
如需同时使用,请先 brew uninstall 冲突的包,或改用独立的环境安装。
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| ronn-ng | v0.10.1 | MIT | 命令行 | 8 |
| stdman | 2018.03.11 | MIT | 命令行 | 7 |
| jsrepo | 3.8.2 | MIT | 命令行 | 7 |
| imake | 1.0.11 | MIT | 命令行 | 7 |
命令行工具中的类似应用
stdman
stdman 是一个把 cppreference 归档 HTML 文件解析并转换成 groff 格式手册页的工具,面向 Unix 系统,目标是为 C++ 标…jsrepo
jsrepo 是一个面向现代开发者的命令行工具,核心用途是帮你构建并分发自己的代码。imake
imake 是一个面向 X11 环境的构建自动化工具,主要用来帮助开发者把源码编译、安装等重复性工作组织成可复用的规则。sourcedocs
SourceDocs 是一个命令行工具,用于从源码中的内联注释生成 Markdown 格式的文档。openssl@4
OpenSSL 是一套开源、商用级、功能完整的加密工具箱,主要服务于 TLS(早期称 SSL)、DTLS 和 QUIC 协议。xz
XZ Utils 是一个通用数据压缩库,同时附带命令行工具。它的原生格式是 .xz,也兼容旧的 .lzma 格式。所属分类:命令行工具