Stagit

Stagit 是一个用于 git 的静态页面生成器，专注于极简的设计与实现方式。

特性

• 显示从 HEAD 开始的所有提交记录。
• 每个提交的提交日志和 diffstat。
• 展示可点击行号的文件树。
• 显示引用信息：本地分支和标签。
• 从 HEAD 检测 README 和 LICENSE 文件，并作为网页链接展示。
• 从 HEAD 检测子模块（.gitmodules 文件），并作为网页链接展示。
• 提交日志的 Atom 订阅源（atom.xml）。
• 标签/引用的 Atom 订阅源（tags.xml）。
• 使用 stagit-index 为多个仓库生成首页。
• 页面生成后（相对较慢），但服务文件非常快速、简单且资源占用极少（因为内容是静态的），仅需一个 HTTP 文件服务器即可。

安全性：所有页面均为静态。界面不运行任何 CGI 或动态代码。配合如 OpenBSD httpd 等安全 HTTP 服务器使用时，具备权限分离、chroot(2) 和 pledge(2) 保护。

配置简单：内容生成与服务完全分离，只需复制几个目录和脚本即可完成配置。

兼容文本浏览器，如 dillo、links、lynx 和 w3m。

缺点

• 不适合大型仓库（2000+ 提交），因为 diffstat 操作开销较大；在某些情况下可通过缓存（-c 标志）或限制（-l maxlimit）缓解。
• 不适合包含大量文件的仓库，因为每次执行 stagit 都会重写所有文件。这是因为 stagit 会显示文本文件的行内容，而文件元数据无缓存机制（增加缓存会提高代码复杂度）。
• 不适合分支众多的仓库，假设历史为相对线性的（从 HEAD 出发）。