创建配置文件 (clash.toml)
Clash 的配置文件通常是 clash.toml,以下是一个基本的配置示例:
[project] name = "我的项目" description = "一个简单的静态网站" [module] path = "src" # 你的源文件目录 main = "index.html" # 主页文件 [options] output = "dist" # 输出目录 clean = true # 是否清理输出目录 parallel = true # 是否启用并行构建 strict = true # 是否启用严格模式 incremental = true # 是否启用增量构建 [templates] main_template = "templates/base.html" # 主模板文件 [markdown] enabled = true # 是否启用 Markdown 支持 frontmatter = true # 是否支持前置内容(Front Matter) markdown_path = "content" # Markdown 文件目录
简单的 HTML 模板
如果你的模板是简单的 HTML 文件,可以在 templates/base.html 中使用以下内容:
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.">$(title)</title>
</head>
<body>
<h1>$(title)</h1>
<p>这是一个简单的静态网站</p>
</body>
</html>
高级配置示例
以下是一个更复杂的配置示例,包含多个模板和 Markdown 支持:
[project] name = "静态网站" description = "一个支持 Markdown 的静态网站" [module] path = "src" main = "index.html" [options] output = "dist" clean = true parallel = true strict = true incremental = true [templates] main_template = "templates/base.html" page_template = "templates/page.html" [markdown] enabled = true frontmatter = true markdown_path = "content" [alias] ["pages": "page.html"] ["posts": "post.html"]
使用 Clash 构建和部署
- 创建一个
clash.toml文件,填写上述配置。 - 在终端中运行以下命令:
clash build
- 生成的文件会出现在你指定的输出目录(
dist)。 - 使用
clash deploy命令部署到 Netlify 或其他静态托管服务。
常见配置参数
output:指定输出目录。clean:是否清理输出目录。parallel:是否启用并行构建,提升构建速度。strict:是否启用严格模式,防止错误。incremental:是否启用增量构建,只更新已修改的文件。templates:指定模板文件,支持多个模板。markdown:支持 Markdown 文件的处理。alias:为模板和 Markdown 文件创建别名。
Clash 是一个非常强大的工具,支持许多高级功能,如模板、Markdown 支持、多页面应用、代码拆分等,通过合理配置,可以将静态网站构建和部署变得非常高效。









