standardese for Mac 版
面向 C 的下一代文档生成器
standardese 是什么
Standardese 是一个面向 C++ 的下一代文档生成工具,定位是替代 Doxygen。它由两部分组成:一个库和一个命令行工具。库基于 libclang 解析 C++ 代码并提供访问接口,目标是成为易于扩展和定制的文档前端;命令行工具则调用这个库,为用户指定的文件生成文档,支持 Markdown、HTML 以及实验性的 LaTeX 和 Man page 等输出格式。
它的特色在于文档风格贴近 C++ 标准:提供 `effects`、`requires`、`returns`、`throws` 等命令,用来在文档中引入 C++ 标准所定义的各种规范段落,这也是名字的由来。它解决的是 C++ 项目文档生成需求,尤其是希望文档结构接近标准文本风格的场景。适合需要为 C++ 代码库生成文档、又对 Doxygen 的扩展性和输出样式不够满意的开发者。
它的特色在于文档风格贴近 C++ 标准:提供 `effects`、`requires`、`returns`、`throws` 等命令,用来在文档中引入 C++ 标准所定义的各种规范段落,这也是名字的由来。它解决的是 C++ 项目文档生成需求,尤其是希望文档结构接近标准文本风格的场景。适合需要为 C++ 代码库生成文档、又对 Doxygen 的扩展性和输出样式不够满意的开发者。
如何安装 standardese
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
最近一次更新为 2021-04-29,当前版本 0.5.2,共记录最近 10 个版本。
| 版本 | 发布日期 | 类型 | 大小 | macOS | Windows | Linux |
|---|---|---|---|---|---|---|
| 0.5.2 | 2021-04-29 | 稳定版 | 1.2 MB | 下载 | — | — |
| 0.5.1 | 2021-04-15 | 稳定版 | 1.3 MB | — | — | — |
| 0.5.0 | 2021-03-17 | 稳定版 | 1.3 MB | — | — | — |
| 0.4.1 | 2020-11-01 | 稳定版 | 730 KB | — | — | — |
| v0.4.0 | 2020-01-25 | 稳定版 | 744 KB | — | — | — |
| v0.4.0-rc2 | 2020-01-24 | 预发布 | 744 KB | — | — | — |
| v0.4.0-rc1 | 2019-10-17 | 预发布 | 723 KB | — | — | — |
| v0.4.0-rc0 | 2019-10-04 | 预发布 | — | — | — | — |
| v0.3-4 | 2017-01-04 | 预发布 | 592 KB | 下载 | 下载 | 下载 |
| v0.3-3 | 2017-01-02 | 预发布 | 590 KB | 下载 | 下载 | 下载 |
数据来自 GitHub Releases,稳定版优先,同类按发布时间排序。
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| standardese | 0.5.2 | MIT | 命令行 | 0 |
| naturaldocs | 2.3.1 | AGPL-3.0-only | 命令行 | 0 |
| packcc | v3.1.0 | MIT | 命令行 | 1 |
| goyacc | 1.0.3 | BSD-3-Clause | 命令行 | 0 |
命令行工具中的类似应用
naturaldocs
Natural Docs 是一款面向开发者的文档生成工具,核心思路是让代码注释自然融入文档,而不是要求你额外维护一套文档格式。packcc
PackCC 是一个面向 C 语言的解析器生成器,用 PEG(解析表达式文法)描述语法,再自动生成对应的 C 解析器。goyacc
goyacc 是面向 Go 语言的解析器生成工具,源自经典的 yacc 思路,用语法规则文件自动生成 Go 代码形式的解析器。invoice
Invoice 是一个用命令行生成发票的工具。你只需在终端执行命令,它就会输出一份 PDF 格式的发票,默认保存为 invoice.pdf,也可以用 --o…wordplay
Wordplay 是一款字谜生成工具,以命令行方式运行,适合喜欢玩文字游戏、需要快速找出单词字母重排组合的用户。gostatic
gostatic 是一个静态网站生成器,编译时会跟踪文件变化,因此速度相当快。它提供类似 Make 的配置框架,容易理解,也方便编写自定义配置。所属分类:命令行工具