feat: ✨ Congoテーマ v2.14.0 へのアップデート#66
Conversation
📝 WalkthroughWalkthroughCongo テーマのサブモジュール参照をv2.14.0に更新し、言語設定キーを新形式に移行、不要なオーバーライド(warnings.html)を整理、タスク/ドキュメント/メタデータを合わせて更新。アップデート手順書を新規追加。 ChangesCongo テーマ v2.14.0 へのアップデート
🎯 3 (Moderate) | ⏱️ ~20 minutes Possibly related PRs:
Suggested labels:
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Warning There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure. 🔧 ESLint
ESLint skipped: no ESLint configuration detected in root package.json. To enable, add Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Code reviewNo issues found. Checked for bugs and CLAUDE.md compliance. |
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@themes/congo`:
- Line 1: themes/congo サブモジュールが参照しているコミット
00804fb8e9ddb442d541619b5529ee19b4378178 がリモートに存在しないため CI
が失敗しています。修正手順:サブモジュールパス themes/congo をチェックアウトしてリモートで存在する参照に更新(例: git fetch &&
git checkout v2.14.0 または適切なタグ/コミット
87dd58ce29e71f210d57dd356055b7b97f528ec3)し、その状態で上位リポジトリのサブモジュールポインタを更新してコミット(git
add themes/congo && git commit -m "Update themes/congo submodule to
v2.14.0")してプッシュしてください(必要なら .gitmodules の branch/tag 指定も合わせて修正)。
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Run ID: 01b72d56-c0ca-4f9c-a1f5-f73bbed9cbc7
⛔ Files ignored due to path filters (1)
CHANGELOG.mdis excluded by!CHANGELOG.md
📒 Files selected for processing (9)
.claude/plans/hugo-v2-14-0-issue-scripts-check-layout-lucky-yao.md.claude/settings.local.jsonCLAUDE.mdREADME.mdassets/css/compiled/main.cssconfig/_default/languages.en.tomlconfig/_default/languages.ja.tomllayouts/_partials/functions/warnings.htmlthemes/congo
💤 Files with no reviewable changes (1)
- layouts/_partials/functions/warnings.html
Bump Congo theme from v2.13.0 (3623fa5) to v2.14.0 (87dd58c), released
2026-05-23.
Key upstream changes:
- Required Hugo minimum bumped to v0.158.0 (current v0.161.1 already
satisfies)
- Migrated deprecated Site.Languages API to Rotate "language" (PR #1162)
- KaTeX v0.17.0 / Mermaid v11.15.0 upgrades
- Alternate hreflang links auto-declared for translated pages (SEO)
- Hindi / Gujarati translations added
- Author warning that previously prevented sites from building is fixed
(PR #1165)
sfz.dev-side changes:
- Remove layouts/_partials/functions/warnings.html: the upstream fix
(PR #1165) now removes the Author warning block, making this local
patch redundant
- Migrate config/_default/languages.{en,ja}.toml keys to match the
v2.14.0 example site conventions:
languageCode → locale
languageName → label
rtl → direction
(old keys were deprecated in Hugo v0.156.0)
- Switch task update:theme from `git submodule update --remote --merge`
to `--checkout` so subsequent theme updates don't create local merge
commits that are unreachable from the upstream Congo repository.
Update README accordingly
- Bump Congo version references in README and CLAUDE.md
- Regenerate CHANGELOG via git-cliff
Verification:
- task build: no errors (only a single .Site.Data deprecation warning
remaining, which originates from Congo's own sharing-links.html and
is upstream's to address)
- task test:headless: 380 / 380 Playwright tests pass
- task lighthouse: perf 0.89 / a11y 0.87 / best-practices 0.96 /
seo 0.92, all assertions pass
682565e to
44d974d
Compare
There was a problem hiding this comment.
Actionable comments posted: 1
🧹 Nitpick comments (1)
CLAUDE.md (1)
30-30: ⚡ Quick win
update:themeの手順説明をこのファイル内でも同期してください。Line 224 の保守メモが
--mergeのままで、Taskfile.yml/README.mdの--checkoutと不整合です。手順誤認防止のため、同じコマンドに揃えてください。🔧 提案差分
-2. **テーマ更新**: `task update:theme`(`git submodule update --remote --merge themes/congo`)でCongoテーマを更新可能。 +2. **テーマ更新**: `task update:theme`(`git submodule update --remote --checkout themes/congo`)でCongoテーマを更新可能。🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@CLAUDE.md` at line 30, The CLAUDE.md maintenance note for the update:theme workflow is out of sync: it still references the old --merge flag while Taskfile.yml and README.md use --checkout; update the CLAUDE.md section that documents the update:theme procedure so it uses the same command (--checkout), and ensure any explanatory steps, examples, or commands in the update:theme paragraph match the exact wording and flags used in Taskfile.yml and README.md to prevent confusion.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.claude/plans/hugo-v2-14-0-issue-scripts-check-layout-lucky-yao.md:
- Around line 145-149: The task description for update:theme is incorrect: it
says the git submodule update uses --merge but the Taskfile.yml actually invokes
git submodule update --remote --checkout; update the prose so the execution
steps match the real Task definition by replacing any mention of --merge with
--checkout and ensuring the command shown is `git submodule update --remote
--checkout themes/congo` (reference: the update:theme task and Taskfile.yml
task: check:layouts / the git submodule update command in the diff).
---
Nitpick comments:
In `@CLAUDE.md`:
- Line 30: The CLAUDE.md maintenance note for the update:theme workflow is out
of sync: it still references the old --merge flag while Taskfile.yml and
README.md use --checkout; update the CLAUDE.md section that documents the
update:theme procedure so it uses the same command (--checkout), and ensure any
explanatory steps, examples, or commands in the update:theme paragraph match the
exact wording and flags used in Taskfile.yml and README.md to prevent confusion.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: defaults
Review profile: CHILL
Plan: Pro
Run ID: 4831bb70-59a2-462a-a8d5-d76b2d635dbd
📒 Files selected for processing (11)
.claude/plans/hugo-v2-14-0-issue-scripts-check-layout-lucky-yao.md.claude/settings.local.jsonCHANGELOG.mdCLAUDE.mdREADME.mdTaskfile.ymlassets/css/compiled/main.cssconfig/_default/languages.en.tomlconfig/_default/languages.ja.tomllayouts/_partials/functions/warnings.htmlthemes/congo
💤 Files with no reviewable changes (1)
- layouts/_partials/functions/warnings.html
✅ Files skipped from review due to trivial changes (2)
- assets/css/compiled/main.css
- config/_default/languages.ja.toml
| 実行内容(`Taskfile.yml:179-184`): | ||
|
|
||
| 1. `git submodule update --remote --merge themes/congo` で stable ブランチ最新へ追随 | ||
| 2. `npm install --prefix themes/congo` でCongo側依存を再インストール | ||
| 3. `task: check:layouts` で上書き状況のdiffを表示 |
There was a problem hiding this comment.
update:theme の実行内容説明が実コードとズレています。
ここは --merge ではなく --checkout に合わせて記載を更新してください。手順書どおり実行した際に、実際の Task 定義と挙動が食い違います。
修正案
-1. `git submodule update --remote --merge themes/congo` で stable ブランチ最新へ追随
+1. `git submodule update --remote --checkout themes/congo` で stable ブランチ最新へ追随📝 Committable suggestion
‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.
| 実行内容(`Taskfile.yml:179-184`): | |
| 1. `git submodule update --remote --merge themes/congo` で stable ブランチ最新へ追随 | |
| 2. `npm install --prefix themes/congo` でCongo側依存を再インストール | |
| 3. `task: check:layouts` で上書き状況のdiffを表示 | |
| 実行内容(`Taskfile.yml:179-184`): | |
| 1. `git submodule update --remote --checkout themes/congo` で stable ブランチ最新へ追随 | |
| 2. `npm install --prefix themes/congo` でCongo側依存を再インストール | |
| 3. `task: check:layouts` で上書き状況のdiffを表示 |
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In @.claude/plans/hugo-v2-14-0-issue-scripts-check-layout-lucky-yao.md around
lines 145 - 149, The task description for update:theme is incorrect: it says the
git submodule update uses --merge but the Taskfile.yml actually invokes git
submodule update --remote --checkout; update the prose so the execution steps
match the real Task definition by replacing any mention of --merge with
--checkout and ensuring the command shown is `git submodule update --remote
--checkout themes/congo` (reference: the update:theme task and Taskfile.yml
task: check:layouts / the git submodule update command in the diff).
Closes #65
Summary
layouts/_partials/functions/warnings.htmlのカスタムオーバーライドを削除(不要に)config/_default/languages.{en,ja}.tomlのキー名を v2.14.0 慣例に移行languageCode→localelanguageName→labelrtl→directionREADME.md/CLAUDE.mdのCongoバージョン表記を v2.14.0 へCHANGELOG.mdをtask update:changelog(git-cliff)で再生成v2.14.0 主要変更点
hreflang代替リンク自動宣言(SEO改善).Site.Languagesを Hugo v0.156+ 推奨のRotate "language"方式へ移行Test plan
task update:themeでテーマsubmoduleが v2.14.0 へ更新されることを確認task check:layoutsが "No custom layouts override Congo theme files." を出力hugo configでlocale/label/directionが新キー名で出力されるtask buildがエラー無しで完了(残warningは Congo自身の_partials/sharing-links.html内.Site.Dataのみ・上流側の対処待ち)task test:headlessで 380 / 380 Playwright テスト passtask lighthouseアサーション pass(perf 0.89 / a11y 0.87 / best-practices 0.96 / SEO 0.92)Notes
tests/snapshots/は .gitignore 対象のため PR には含まれません)References
Summary by CodeRabbit
リリースノート
アップデート
改善
ドキュメント