Clash 是一个由 Netlify 提供的静态网站生成工具,可以用来快速构建和部署静态网站。以下是 Clash 的基本配置示例,假设你想从一个源目录生成一个静态网站

创建配置文件 (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 构建和部署

  1. 创建一个 clash.toml 文件,填写上述配置。
  2. 在终端中运行以下命令:
    clash build
  3. 生成的文件会出现在你指定的输出目录(dist)。
  4. 使用 clash deploy 命令部署到 Netlify 或其他静态托管服务。

常见配置参数

  • output:指定输出目录。
  • clean:是否清理输出目录。
  • parallel:是否启用并行构建,提升构建速度。
  • strict:是否启用严格模式,防止错误。
  • incremental:是否启用增量构建,只更新已修改的文件。
  • templates:指定模板文件,支持多个模板。
  • markdown:支持 Markdown 文件的处理。
  • alias:为模板和 Markdown 文件创建别名。

Clash 是一个非常强大的工具,支持许多高级功能,如模板、Markdown 支持、多页面应用、代码拆分等,通过合理配置,可以将静态网站构建和部署变得非常高效。

Clash 是一个由 Netlify 提供的静态网站生成工具,可以用来快速构建和部署静态网站。以下是 Clash 的基本配置示例,假设你想从一个源目录生成一个静态网站

扫码添加AstrillVPN官网微信

扫码添加AstrillVPN官网微信

029-8826-4715
扫码添加AstrillVPN官网微信

扫码添加AstrillVPN官网微信

网站地图