grubby：用 Ruby 编写的、面向 Git 仓库的静态站点生成器

# grubby 来源：https://git.btxx.org/grubby/ 用 Ruby 编写的、面向 Git 仓库的静态站点生成器。 fork 自并深受 RepoRat（https://www.ratfactor.com/repos/reporat/）启发。 ## 环境要求 - Git - Ruby 3.0+ - Kramdown ## 配置 Grubby 开箱即用，自带较强的设计立场。它旨在原样使用，无需太多调校。默认使用 Kramdown 作为 Markdown 解析器，你可以自由替换，但我无法保证替换后一切都能没有 bug！另外默认假定你所有的裸 git 仓库以 `.git` 扩展名结尾。核心仓库索引功能在缺少这一后缀时无法正常工作！ 你*唯一*应该修改的文件是 `_config.yml`，用于设置核心域名和路径。 如果你想更换 CSS、导航链接或页脚内容，可以相应地编辑 `style.css`、`_header.html` 和 `_footer.html`。欢迎尝试！ 默认情况下，核心的"仓库索引"会创建在主目录根部，文件名为 `index.html`。这个输出文件名也可以在 `_config.yml` 中修改。 ## 使用方法 本指南假设你使用的是某种"共享主机"（这里是 **NearlyFreeSpeech.NET**）。虽然在自己的 VPS 上运行过程也会非常类似。 以下内容基于你的裸 git 仓库位于 `/home/public/git.sitename.org` 这一前提。 1. 将本项目克隆到你的私有目录（即 `/home/private/`） 2. 进入 `/home/public` 下的某个仓库（即 `cd coolrepo.git`） 3. 在 hooks 下创建一个新文件：`touch /hooks/post-update` 4. 给该文件赋予执行权限：`chmod +x /hooks/post-update` 5. 将以下代码添加到该文件中： ```sh #!/bin/sh unset GIT_DIR # Needed for cloning over plain HTTP git update-server-info # Rebuild the static site from a temporary checkout repo_name=$(basename "$PWD" .git) temporary_dir=$(mktemp -d) git clone --quiet "$PWD" "$temporary_dir/$repo_name" cp "$PWD/description" "$temporary_dir/$repo_name/.git/description" (cd "$temporary_dir/$repo_name" && ruby /home/private/grubby/grubby.rb) rm -rf "$temporary_dir" ``` 现在你可以试用一下了！只需运行： ```sh ./hooks/post-update ``` 各个仓库的网站将生成在 `/home/public/git.sitename.org/coolrepo`，同时更新后的仓库索引（默认为 `index.html`）会生成在根目录 `/home/public/git.sitename.org/` 下。 你可以在此基础上扩展，例如改为在 `hooks/post-receive` 文件中调用，甚至使用全局的 `post-update`，以避免为每个项目重复包含这段脚本。 ## 注意事项 - **不会**为单个 commit 变更、分支等生成页面。