Gentoo 中文社区 官方网站，基于 Hugo 静态网站生成器与 Hextra 主题构建，部署在 Cloudflare Workers 上。
- Hugo 静态网站生成器 + Hextra 主题（经本站 gentoozh-theme 补丁包用 Hugo Modules 引入，见
go.mod，无需 Node 工具链） - 简体 / 正体中文 / 英文三语（zh-cn 在根路径
/，zh-tw 在/zh-tw/，en 在/en/） - 站内全文搜索（FlexSearch）、暗色模式、响应式布局
- 贡献者列表每月自动从 gentoo-zh overlay 抓取并更新
- RSS 订阅
需要 Hugo extended 版本；因为主题通过 Hugo Modules 引入，还需要 Go 工具链。
# Gentoo
emerge --ask www-apps/hugo dev-lang/go
# macOS
brew install hugo go启动开发服务器（模块会在首次构建时自动拉取，无需 git submodule）：
hugo server -D # 访问 http://localhost:1313构建网站（输出到 public/）：
hugo --gc --minify.
├── config/_default/ # Hugo 配置
│ ├── hugo.toml # 主配置（站点信息、分类法、Markdown 渲染、输出格式）
│ ├── languages.toml # 三语配置（[zh-cn] / [zh-tw] / [en]，含 contentDir）
│ ├── menus.zh-cn.toml # 简体导航菜单
│ ├── menus.zh-tw.toml # 正体导航菜单
│ ├── menus.en.toml # 英文导航菜单
│ └── params.toml # 主题参数
├── content/
│ ├── zh-cn/ # 简体中文内容
│ │ ├── about/ download/ faq/ mirrorlist/ overlay/
│ │ ├── posts/ # 文章（content/zh-cn/posts/<slug>/index.md）
│ │ ├── contributors/ # 贡献者页面（脚本自动生成，勿手动编辑）
│ │ ├── contributing/ # 投稿指南
│ │ └── changelog/ # 更新记录
│ ├── zh-tw/ # 正体中文内容（结构与 zh-cn 一致，由脚本转换生成）
│ └── en/ # 英文内容
├── i18n/ # 站点界面翻译（en.toml / zh-cn.toml / zh-tw.toml）
├── layouts/ # 站点侧模板覆盖（custom/ 钩子等；首页 bento、贡献者页等主体在主题）
├── static/ # 原样输出的静态文件（CNAME、favicon、图片）
├── scripts/ # 贡献者自动更新脚本（见 scripts/README.md）
├── sync_to_tw.sh # 简体 → 正体中文转换（OpenCC s2twp + 术语修正）
├── go.mod / go.sum # Hugo Module 依赖（直接依赖 gentoozh-theme，它再拉取 Hextra）
└── .github/workflows/ # CI/CD（hugo.yml 部署 + update-contributors.yml 贡献者更新）
以简体版为源，用脚本生成正体版（需先安装 OpenCC）：
./sync_to_tw.sh content/zh-cn/posts/<slug>/index.md content/zh-tw/posts/<slug>/index.md欢迎投稿与改进，详见站点的贡献指南（content/zh-cn/contributing/）。
主题通过 Hugo Module 引入，用 hugo mod 升级（不再操作 submodule）。站点直接依赖的是本站补丁包 gentoozh-theme（它再把 Hextra 作为间接依赖拉取）：
hugo mod get -u github.com/Gentoo-zh/gentoozh-theme
hugo mod tidy推送到 master 分支后，由 .github/workflows/hugo.yml 经 GitHub Actions 用 wrangler 构建并部署到 Cloudflare Workers（Worker 名 gentoozh-web，绑定 gentoozh.org）。