窑

一个用Rust编写的静态站点生成器 hakula.xyz，具有cjk友好的Markdown创作和可定制的主题。

突出了

• cjk友好的Markdown技术写作，与数学，图表和语法高亮显示
• 通过嵌套自定义内容组件 ::: 指令和主题模板
• 将文字、图像和页面特定样式保持在一起的页面包
• 全文检索 Pagefind，提供查找和跟踪帖子的存档和提要
• IgnIt 主题响应式布局和黑暗模式，可通过网站覆盖自定义
• 本地预览与实时加载，加上优化的样式表和图像加载占位符发布

文档

安装

通过npm

安装Node.js 20或更新版本，例如 等于是，然后选择一种窑型：

fnm install --latest --use
npm install -g @kiln-ssg/kiln@latest

选择 @kiln-ssg/kiln-extended@latest 用于avf加载占位符。它有相同的 dav1d需求 作为扩展的存档。两个变体都安装 kiln，因此在切换之前卸载当前的变体。

预发布版本使用 next npm标签。支持的平台为Linux x86_64 （glibc）、Apple Silicon和Windows x86_64。

当站点需要时，在相同的安装命令中添加可选工具：

npm install -g @kiln-ssg/kiln@latest @kiln-ssg/[email protected] [email protected]

• @kiln-ssg/tailwindcss：当网站或主题编译顺风CSS时需要。
• pagefind：启用搜索时必选。

预先构建的二进制

为您的平台下载最新版本 释放：

# Linux x86_64
curl -fsSL https://github.com/hakula139/kiln/releases/latest/download/kiln-x86_64-unknown-linux-gnu.tar.gz | tar -xz
sudo mv kiln /usr/local/bin/

# macOS aarch64 (Apple Silicon)
curl -fsSL https://github.com/hakula139/kiln/releases/latest/download/kiln-aarch64-apple-darwin.tar.gz | tar -xz
sudo mv kiln /usr/local/bin/

# Windows x86_64 (Git Bash / MSYS / WSL)
curl -fsSLO https://github.com/hakula139/kiln/releases/latest/download/kiln-x86_64-pc-windows-msvc.zip
unzip kiln-x86_64-pc-windows-msvc.zip

kiln --version

选择默认值 kiln-<target> 归档文件或 kiln-extended-<target> 用于avf加载占位符。只有扩展的二进制文件才需要dav1d：

从源

cargo install --git https://github.com/hakula139/kiln --locked

要为AVIF图像生成加载占位符，请安装 本地依赖关系 并启用该功能：

cargo install --git https://github.com/hakula139/kiln --locked --features avif

通过无

nix run github:hakula139/kiln -- build     # one-shot
nix profile install github:hakula139/kiln  # install to user profile

雪花提供了 hakula 预构建包的缓存。Nix以交互方式提示信任。对于非交互式使用，请在传递之前验证缓存密钥 --accept-flake-config.

要从另一个薄片中使用此缓存，请在该薄片或您的Nix安装中配置它。

要在另一个薄片中使用窑炉，请添加以下输入：

inputs.kiln.url = "github:hakula139/kiln";
# Outputs: packages.${system}.{default,kiln}

Nix包将Tailwind编译器和Pagefind放在kiln的编译器上 PATH，因此样式表编译和搜索无需单独安装即可工作。

第一个网站

创建一个站点 IgnIt，使用符合主题的窑版 min_kiln_version． 点火需要 顺风处理器，它包含在kiln的Nix包中。

git init my-site
cd my-site
git submodule add https://github.com/hakula139/IgnIt.git themes/IgnIt
mkdir -p content/posts/hello

cat > config.toml <<'CONFIG'
base_url = "https://example.com"
title = "My Site"
theme = "IgnIt"
CONFIG

cat > content/posts/hello/index.md <<'POST'
+++
title = "Hello"
+++

Welcome to my site.
POST

kiln serve --open

运行 kiln build --minify 生成 public/ 为部署。看到 网站配置 查看引擎设置和 内容 用于组织页面。

使用

kiln build --root /path/to/site --minify
kiln build --base-url https://preview.example.com
kiln serve --port 3000 --open
kiln init-theme my-theme
kiln convert --source /path/to/hugo --dest /path/to/kiln

build， serve 和 init-theme 使用当前目录作为站点根目录，除非 --root 供应。 KILN_BASE_URL 时提供构建URL重写 --base-url 不在。

看到 雨果迁移 为转换器的支持范围和手动跟踪。

搜索

默认禁用搜索功能。要启用它，请安装 Pagefind 并设置 [search] enabled = true 在 config.toml：

[search]
enabled = true
# binary = "/path/to/pagefind"  # optional, if not on $PATH

kiln build 和 kiln serve 当启用搜索时，在生成HTML后运行Pagefind。

从源头构建

需要 生锈 1.89或更新版本和C工具链。

cargo build --release  # Binary at target/release/kiln

AVIF占位符

图像发布和尺寸检测在任何一个构建中都可以工作。要添加AVIF加载占位符，请安装dav1d≥1.3和 pkg-config：

然后启用该特性：

cargo build --release --features avif

在macOS和Linux上，生成的二进制文件在运行时需要dav1d，就像 延长档案.

可复制的开发shell （Nix）

Nix包默认启用AVIF支持。它的开发shell提供了构建依赖和预提交钩子：

nix develop      # interactive shell
nix flake check  # run the pre-commit hooks that don't use Node

direnv 自动激活外壳通过 .envrc.

许可证

版权所有2026 Hakula． 根据 MIT许可证.