SuperAPI AI 工具集

creating-zola-static-sites

通用与其它

查看项目

更新于 10-16 05:44

技能介绍

本技能用于使用 Zola 这一 Rust 单二进制静态站点生成器构建静态网站,涵盖项目初始化、config.toml 配置、Tera 模板、Markdown 内容,并内置 Sass、图片处理与 Tera 模板能力。

用途:从零创建并维护 Zola 站点,包括目录初始化、内容组织、模板编写、taxonomies 配置、多语言内容以及生产部署。

主要能力与用法:初始化用 zola init my-site && cd my-site,随后在 config.toml 设置 base_url;本地预览用 zola serve(默认 http://127.0.0.1:1111);构建用 zola build,输出到 public/;用 zola check 校验链接,慢时可加 --skip-external-links。内容区分 section 与 page:_ 前缀文件(如 _index.md)表示 section(列表页),无前缀(如 about.md、post.md)表示 page(内容页)。页面 frontmatter 中日期须写成 date = 2024-01-15(不加引号,否则排序失效),taxonomies 用 [taxonomies] tags = ["rust"] 形式声明,并在 config.toml 中配置 taxonomies = [{name = "tags", feed = true}]。内部链接使用 @/ 前缀,如 About,以获得构建期校验。

适用场景:博客、文档站点及一般静态内容站的搭建、列表分页、标签与分类、feed 生成、主题或自备模板、以及 Netlify、Cloudflare、GitHub Actions、Vercel、Firebase 等部署流程;也涉及 Zola 与 Astro、Firebase 导出等混合场景,以及从技能 assets/ 复制 base.html、section.html、page.html、404.html、shortcodes 和 config-templates 预设。

限制:不适用于 Hugo、Jekyll、Eleventy 等其他 SSG 的语法问题,也不适用于无 Zola 上下文的通用 Markdown 问题或纯 Astro 项目;部分细节如具体价格、性能数据暂未提供。调试可用 {{ __tera_context }} 或 RUST_LOG=zola=info zola build。