命令行

Snow 提供 initserverbuildhooks 四个常用命令。

init

创建一个新站点:

1snow init myblog

如果不传目录名,Snow 会在当前目录初始化:

1snow init

初始化过程会询问站点标题、作者、URL 前缀,以及是否创建第一篇文章。

server

启动开发服务器:

1snow server

常用参数:

1snow server --listen 127.0.0.1:8088
2snow server --autoload
3snow server --root-dir myblog
4snow server --config other.yaml
5snow server --debug
6snow server --mode publish
7snow server --include-drafts

短参数:

1snow server -l 127.0.0.1:8088
2snow server -R
3snow server -r myblog
4snow server -c other.yaml
5snow server -D
6snow server -m publish

--autoload 会监听内容、模板、静态文件等变化,并触发重新构建与浏览器刷新。

build

构建站点:

1snow build

常用参数:

1snow build --clean
2snow build --root-dir myblog
3snow build --output-dir dist
4snow build --config other.yaml
5snow build --dry-run
6snow build --debug
7snow build --mode publish
8snow build --include-drafts

短参数:

1snow build -C
2snow build -r myblog
3snow build -o dist
4snow build -c other.yaml
5snow build -D
6snow build -m publish

--dry-run 会执行构建流程,但不会写入输出文件。--clean 会在构建前清理输出目录中非隐藏文件。

hooks

查看已注册 Hook:

1snow hooks

输出会标记当前配置中启用的 Hook,例如:

1mount, snakecase, assets(enabled), pelican, rewrite, filter, encrypt(enabled), links(enabled), shortcode(enabled), minify, alias

共享参数

serverbuild 都支持:

参数 短参数 说明
--config -c 指定配置文件
--debug -D 启用调试模式
--root-dir -r 指定站点根目录
--mode -m 使用配置中的指定 mode
--include-drafts - 包含草稿内容

build 额外支持:

参数 短参数 说明
--output-dir -o 覆盖输出目录
--clean -C 构建前清理输出目录
--dry-run - 只执行构建流程,不写入文件

server 额外支持:

参数 短参数 说明
--listen -l 指定监听地址
--autoload -R 监听文件变化并自动刷新

root-dir

--root-dir 会在执行命令前切换到指定目录,因此配置文件、内容目录、模板目录、静态目录等相对路径都会以该目录为根。

1snow build --root-dir myblog
2snow server --root-dir myblog --autoload

©2026 · 红枫文档