Jellyfish Site
Jellyfish 官网与文档站基于 Hugo + Hextra 构建。
本地开发要求
- Hugo extended
>= 0.146.0 - Go
>= 1.22
安装主题模块
cd site
hugo mod tidy
本地预览
cd site
hugo server --buildDrafts --disableFastRender
本地开发默认访问：
http://localhost:1313/
构建
cd site
hugo --minify
GitHub Pages 发布时会在 CI 中显式传入生产环境的 baseURL。
当前仓库不保存 Hextra 主题源码，开发和 CI 都通过 Hugo Modules 即时拉取主题。
模块依赖约定
- 本地更新或新增主题模块时，使用
hugo mod tidy - GitHub CI 中只执行模块下载与校验，不在发布时重写依赖锁文件
go.mod与go.sum需要随模块变更一并提交
目录说明
content/：官网与文档内容layouts/：首页等自定义模板data/：首页文案块等结构化数据static/：logo、截图等静态资源
SEO 与分享图
- 默认分享图：
static/images/og-default.svg - 站点级元信息：
hugo.yaml - 自定义 head 补充：
layouts/_partials/custom/head-end.html