SuperAPI AI 工具集

hugo

前端与建站

查看项目

更新于 10-15 22:39

技能介绍

用途:指导使用 Hugo 静态网站生成器搭建博客、文档站、落地页和作品集,覆盖从安装到部署的完整流程。

主要能力:资料给出 7 步设置流程——安装并验证 Hugo Extended、用 hugo new site 创建站点、以 Git 子模块安装主题(如 PaperMod、Book、Academic、Ananke)、编写 hugo.yaml 配置、用 hugo new content 创建内容、用 hugo server 本地预览、用 hugo --minify 构建并部署到 Cloudflare Workers。同时列出 9 类常见问题及预防方法,如版本不匹配、baseURL 错误、TOML 与 YAML 混用、主题未找到、日期问题、public 目录冲突和模块缓存问题。

必要用法:安装推荐 brew install hugo,或下载 hugo_extended 的 .deb 包;创建站点用 hugo new site my-blog --format yaml;添加主题用 git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod;本地预览用 hugo server;生产构建用 hugo --minify;部署用 npx wrangler deploy。克隆含子模块的项目需加 --recursive。

适用场景:需要快速构建静态站点并部署到 Cloudflare Workers 的个人博客、文档站、作品集等。

限制:资料强调必须安装 Extended 版以支持 SCSS/Sass,配置建议统一用 YAML,public/ 不应提交,CI/CD 中应固定 Hugo 版本。其他未提及的功能、收费或平台支持暂未提供。