CoderDojo 立川 Web サイト（pages + pages-theme）

このリポジトリ群は CoderDojo 立川のホームページです。フレームワークは Jekyll、ホスティングは GitHub Pages。文字コンテンツ（pages）とレイアウト/Jekyll テーマ（pages-theme）を分けて管理します。開発時はローカルのテーマを自動的に参照します。

Remote Theme (jekyll-remote-theme)

pages/_config.yml で

remote_theme: coderdojotachikawa/pages-theme@main
plugins:
  - jekyll-remote-theme

を指定し、GitHub 上の pages-theme リポジトリを参照しています。レイアウトや Sass を変更したら必ず pages-theme 側で commit & push してください。未 push の変更は本番に反映されません。ローカルでは _plugins/local_theme_override.rb により隣接する pages-theme ディレクトリを強制参照するため、ローカル表示と公開内容が乖離する場合があります。

ローカルに pages-theme がない場合

• ./pages-theme ディレクトリがローカルに存在しない場合、Jekyll は GitHub 上の remote_theme（coderdojotachikawa/pages-theme@main）を直接取得して利用します。
• 文字コンテンツのみ編集する運用なら pages リポジトリだけ clone すれば十分です。
• レイアウトを編集する必要が出た時点で pages-theme を追加 clone してください。
• ローカルテーマが無い状態では _plugins/local_theme_override.rb はシンボリックリンクを作成せず、GitHub 版がそのまま使われます。

リポジトリ構成

./project-root
├─ pages
└─ pages-theme

使用技術

• Jekyll 4.x
• GitHub Pages
• jekyll-remote-theme
• Bootstrap 5 (CDN)
• Sass/SCSS

セットアップ

git clone <pages repo>
# レイアウト編集が必要な場合のみ
git clone <pages-theme repo>
cd pages
bundle install

開発

cd pages
./serve.sh

デプロイ手順の切り分け

• コンテンツ更新: pages で編集 → commit → push
• レイアウト/スタイル更新: pages-theme で編集 → commit → push → 必要に応じ pages を再ビルド

主ファイル

• pages/_config.yml (remote_theme 設定)
• pages/assets/images/* 画像
• pages/assets/css/main.scss SCSS (Front Matter 必須)
• pages-theme/_layouts/* レイアウト
• pages-theme/_includes/* 共通部品
• pages-theme/assets/css/main.scss テーマ SCSS

注意点 / トラブルシュート

• テーマ変更が公開に反映されない: pages-theme を push したか確認
• SCSS 未反映: 先頭 --- / jekyll clean
• パス問題: {{ '/path' | relative_url }}

編集の切り分け

• 文字コンテンツのみ運用: pages のみ clone
• レイアウト調整が必要: pages-theme も clone