literate-git for Mac 版
将分层的 Git 仓库渲染为 HTML
literate-git 是什么
literate-git 是一个把分层式 Git 提交历史渲染成 HTML 文档的工具,思路来自文学化编程。它和 git-dendrify 项目配套:后者负责在线性历史与树状分层历史之间转换,前者则把这种分层结构直观地呈现出来。我们写论文时不会把所有内容堆成一大段,而是分成章节和小节;这个项目想探索的是,软件的发展过程是否也能用同样的方式展示——用带合并提交的 Git 仓库来表达层级结构。
渲染出的 HTML 文档包含提交信息(按 Markdown 解析,支持一定格式)和源码 diff。每个顶层提交对应文档中的一个“章节”,可以展开查看其下的子提交。这样,即使历史大量使用“章节”式结构、部分工具处理起来不顺手,也能通过这份文档清楚地看到代码演进的层次。
它适合希望以更结构化、更易读的方式回顾项目开发过程的人,比如教学场景或需要向他人讲解代码演进的场合。README 中附带了一个 Tamagotchi 风格 Web 应用的示例,可以翻页浏览章节、点击展开子步骤,并通过 RESULT 和 SOURCE 链接查看对应提交时的应用状态与源码树。
渲染出的 HTML 文档包含提交信息(按 Markdown 解析,支持一定格式)和源码 diff。每个顶层提交对应文档中的一个“章节”,可以展开查看其下的子提交。这样,即使历史大量使用“章节”式结构、部分工具处理起来不顺手,也能通过这份文档清楚地看到代码演进的层次。
它适合希望以更结构化、更易读的方式回顾项目开发过程的人,比如教学场景或需要向他人讲解代码演进的场合。README 中附带了一个 Tamagotchi 风格 Web 应用的示例,可以翻页浏览章节、点击展开子步骤,并通过 RESULT 和 SOURCE 链接查看对应提交时的应用状态与源码树。
如何安装 literate-git
- 打开 终端(按 ⌘ + 空格,输入“终端”)。
- 如果还没安装 Homebrew,先运行下面这条安装命令。
- 运行下面这条命令:
最近 10 个版本记录
该项目暂未在 GitHub 发布 Release。
二进制包支持平台
Homebrew 官方提供的预编译包(bottle)覆盖:
- Apple 芯片 · 最新 macOS
- Apple 芯片 · macOS 26 Tahoe
- Apple 芯片 · macOS 15 Sequoia
- Linux · ARM64
- Linux · x86_64
⚠️ 未提供 Intel Mac 的预编译包,Intel 机型需要通过 brew install --build-from-source 从源码编译。
与同类应用对比
只对比公开元数据,不做主观推荐;需要逐项对比时见对比页。
| 应用 | 版本 | 许可证 | 架构 | 近 30 天安装 |
|---|---|---|---|---|
| literate-git | 0.5.5 | GPL-3.0-or-later | 命令行 | 7 |
| mu-repo | 1.9.0 | GPL-3.0-only | 命令行 | 8 |
| g2 | 1.1 | MIT | 命令行 | 10 |
| dstask | v1.0.1 | MIT | 命令行 | 9 |