Lib.rs

基于Git仓库提交的简单静态网站生成器。

如何使用

程序期望在Git仓库中运行。如果是这样，它将遍历提交历史，并选择标题以“POST:”为前缀的提交。对于找到的每个“文章”，将在索引页中添加一个条目，并使用提交的标题（如果存在）和正文生成一个简单的HTML页面。

所有生成的文件都将存储在当前工作目录中的“public”文件夹中。

命令行界面

吉莱斯泰提供了一些选项

-r, --repository <REPOSITORY>  Repository to use, default to current working dir, must be a valid path to a directory containing a .git
-o, --output-dir <OUTPUT_DIR>  Output directory, default to `public`
-p, --prefix <PREFIX>          Prefix to filter posts from normal commits, detault to `POST: `
-n, --no-prefix                If present, every commit will be used, prefix option is ignored

工作流程示例

1. 创建“文章”提交

# Inside a git repository
git commit --allow-empty -m "POST: Title" -m "Body of the post"

2. 生成网站

glessite

3. 通过在浏览器中打开生成的网页查看结果，例如

firefox public/index.html
# or
python -m http.server --directory public

如何构建和安装

1. 安装Rust，此文档假设您有访问 cargo 命令的权限

通过 crates.io

2. 安装软件包

cargo install glessite

手动

2. 下载仓库并编译

git clone https://github.com/Lozul/glessite
cd glessite
cargo build --release

3. 安装软件包

cargo install --path .

如何卸载

cargo uninstall glessite

许可协议

本项目采用MIT许可协议。

标志使用的是在SIL Open Font License 1.1下发布的字体 Source Code Pro。

名字的由来

吉莱斯泰是一种天然树脂，可以在这个页面上找到。这个名字以“G”开头，像Git，以“site”结尾，适合作为一个网站生成器。