mount

Mount

mount 可以把站点外部的本地文件或目录接入构建流程。例如把另一个项目的文档放到 content/docs/project-name/ 下,或者把单个 CSS 文件放到 static/style.css

1hooks:
2  mount:
3    enabled: true
4    option:
5      - source: "/tmp/project-name/docs"
6        target: "content/docs/project-name"
7        strategy: "mount"
8      - source: "/tmp/project-name/static/style.css"
9        target: "static/style.css"
字段 说明
source 本地文件或目录路径,必填
target 在站点中的目标路径,必填
strategy 合并策略,可选,默认 mount

target 使用站点内路径,例如 content/docs/demostatic/style.csstemplates/partials/card.html。它不能写成绝对路径,也不能包含 ../.. 这类回退或自引用片段。

目录挂载后会把目录内容放到 target 下;文件挂载后会把该文件作为 target 使用。开发服务器不会监听外部 source,修改挂载源后需要重新构建或重启预览。

合并策略

strategy 说明
mount 默认行为。挂载内容与原目录合并,同名文件使用挂载内容
base 挂载内容与原目录合并,同名文件使用原目录内容
override 目标路径只读取挂载内容,不再读取原目录内容

如果目标目录原本已经有文件,mountbase 会合并两边的内容;override 会让该目标完全以挂载内容为准。

©2026 · 红枫文档