Skip to content

feat: ✨ Congoテーマ v2.14.0 へのアップデート#66

Merged
shin-sforzando merged 1 commit into
mainfrom
065_update_congo_v2_14_0
May 25, 2026
Merged

feat: ✨ Congoテーマ v2.14.0 へのアップデート#66
shin-sforzando merged 1 commit into
mainfrom
065_update_congo_v2_14_0

Conversation

@shin-sforzando

@shin-sforzando shin-sforzando commented May 24, 2026

Copy link
Copy Markdown
Contributor

Closes #65

Summary

  • Congoテーマを v2.13.0 → v2.14.0(2026-05-23 release)へアップデート
  • 上流 PR #1165 が同等修正を取り込んだため、layouts/_partials/functions/warnings.html のカスタムオーバーライドを削除(不要に)
  • config/_default/languages.{en,ja}.toml のキー名を v2.14.0 慣例に移行
    • languageCodelocale
    • languageNamelabel
    • rtldirection
    • 旧キーは Hugo v0.156.0 で deprecated
  • README.md / CLAUDE.md のCongoバージョン表記を v2.14.0 へ
  • CHANGELOG.mdtask update:changelog(git-cliff)で再生成

v2.14.0 主要変更点

  • ⚠️ Required Hugo version v0.158.0+ → 現状 v0.161.1+extended でクリア
  • KaTeX v0.17.0 / Mermaid v11.15.0 アップグレード
  • 多言語ページで hreflang 代替リンク自動宣言(SEO改善)
  • .Site.Languages を Hugo v0.156+ 推奨の Rotate "language" 方式へ移行
  • Hindi / Gujarati 翻訳追加
  • Author警告でビルド失敗する不具合修正
  • Taxonomy単独メタデータ時に描画されない不具合修正
  • Pagination width が float の場合の不具合修正

Test plan

  • task update:theme でテーマsubmoduleが v2.14.0 へ更新されることを確認
  • task check:layouts が "No custom layouts override Congo theme files." を出力
  • hugo configlocale / label / direction が新キー名で出力される
  • task build がエラー無しで完了(残warningは Congo自身の _partials/sharing-links.html.Site.Data のみ・上流側の対処待ち)
  • task test:headless で 380 / 380 Playwright テスト pass
  • task lighthouse アサーション pass(perf 0.89 / a11y 0.87 / best-practices 0.96 / SEO 0.92)

Notes

  • スナップショットは Congo v2.14.0 由来の DOM 変更(hreflang 追加、schema.html / baseof.html 更新等)を吸収するためローカルベースラインを更新済み(tests/snapshots/ は .gitignore 対象のため PR には含まれません)

References

Summary by CodeRabbit

リリースノート

  • アップデート

    • Congo テーマを v2.13.0 → v2.14.0 に更新し、KaTeX/Mermaid等のバージョンやHugo要件を引き上げました。
    • hreflang の自動宣言や多言語対応の改善を導入しました。
  • 改善

    • 言語設定の形式を旧キーから新キーへ移行しました(locale/label/direction)。
    • 不要な警告表示のオーバーライドを削除し、ビルド出力を簡素化しました。
  • ドキュメント

    • 移行手順、検証チェックリスト、ロールバック手順、CHANGELOG/READMEを更新しました。

Review Change Stack

@shin-sforzando shin-sforzando self-assigned this May 24, 2026
@coderabbitai

coderabbitai Bot commented May 24, 2026

Copy link
Copy Markdown
📝 Walkthrough

Walkthrough

Congo テーマのサブモジュール参照をv2.14.0に更新し、言語設定キーを新形式に移行、不要なオーバーライド(warnings.html)を整理、タスク/ドキュメント/メタデータを合わせて更新。アップデート手順書を新規追加。

Changes

Congo テーマ v2.14.0 へのアップデート

Layer / File(s) Summary
アップデート計画と検証手順書
.claude/plans/hugo-v2-14-0-issue-scripts-check-layout-lucky-yao.md
Congo v2.14.0 アップデートの全工程を記載。Issue起票・ブランチ作成・サブモジュール更新・オーバーライド削除・設定移行・ビルド検証・E2E/Lighthouse・ドキュメント更新を Task 0~10 として列挙。検証チェックリストとロールバック手順を添付。
テーマ更新と設定キー移行
themes/congo, config/_default/languages.en.toml, config/_default/languages.ja.toml
サブモジュール参照を v2.14.0 へ更新。英語・日本語の言語設定を旧キー(languageCode/languageName/rtl)から新キー(locale/label/direction)へ移行。
タスク・スクリプトと設定の調整
Taskfile.yml, README.md, .claude/settings.local.json
update:themegit submodule コマンドを --merge--checkout に変更(CI 的問題の注記追加)。README.md のコマンド表記を合わせ、.claude/settings.local.jsonSkill(superpowers:writing-plans)WebFetch 許可を追加。
ドキュメント・メタデータ更新
CLAUDE.md, README.md, assets/css/compiled/main.css, CHANGELOG.md
各所の Congo バージョン表記を 2.13.0 → 2.14.0 に統一。CSS ヘッダコメントと CHANGELOG の最終更新日時を更新。

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs:

Suggested labels:
enhancement

"I hopped through changelogs, nibbling old keys away,
Submodules updated, now brighter is the day.
Languages rotated with a cheerful thump,
Docs polished clean — a happy rabbit's jump.
🐇✨"

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title clearly describes the main change: updating the Congo theme from v2.13.0 to v2.14.0, which directly matches the changeset's primary objective.
Linked Issues check ✅ Passed All coding requirements from Issue #65 are met: Congo theme updated to v2.14.0, unnecessary warnings.html override removed, language configuration keys migrated to new format, documentation updated, and build/test verification completed.
Out of Scope Changes check ✅ Passed All changes are directly related to the Congo v2.14.0 update objective. Theme submodule reference updated, language config migrated, unnecessary override removed, documentation updated, and task configuration adjusted for safer submodule updates.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch 065_update_congo_v2_14_0

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

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint skipped: no ESLint configuration detected in root package.json. To enable, add eslint to devDependencies.


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.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@claude

claude Bot commented May 24, 2026

Copy link
Copy Markdown

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

📥 Commits

Reviewing files that changed from the base of the PR and between 8d97c44 and e1639fe.

⛔ Files ignored due to path filters (1)
  • CHANGELOG.md is 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.json
  • CLAUDE.md
  • README.md
  • assets/css/compiled/main.css
  • config/_default/languages.en.toml
  • config/_default/languages.ja.toml
  • layouts/_partials/functions/warnings.html
  • themes/congo
💤 Files with no reviewable changes (1)
  • layouts/_partials/functions/warnings.html

Comment thread themes/congo Outdated
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
@shin-sforzando shin-sforzando force-pushed the 065_update_congo_v2_14_0 branch from 682565e to 44d974d Compare May 25, 2026 05:03

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

📥 Commits

Reviewing files that changed from the base of the PR and between e1639fe and 44d974d.

📒 Files selected for processing (11)
  • .claude/plans/hugo-v2-14-0-issue-scripts-check-layout-lucky-yao.md
  • .claude/settings.local.json
  • CHANGELOG.md
  • CLAUDE.md
  • README.md
  • Taskfile.yml
  • assets/css/compiled/main.css
  • config/_default/languages.en.toml
  • config/_default/languages.ja.toml
  • layouts/_partials/functions/warnings.html
  • themes/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

Comment on lines +145 to +149
実行内容(`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を表示

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

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.

Suggested change
実行内容(`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).

@shin-sforzando shin-sforzando merged commit 59652b7 into main May 25, 2026
6 checks passed
@shin-sforzando shin-sforzando deleted the 065_update_congo_v2_14_0 branch May 25, 2026 05:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: ✨ Congoテーマ v2.14.0 へのアップデート

1 participant