setup-github-pages

Installation
SKILL.md

setup-github-pages

任意のリポジトリ(新規・既存)に、fandhe-frontend の公式サイトと同じデザイン・同じ仕組みの GitHub Pages ドキュメントサイトを構築する。Markdown を site/ に置き、既定ブランチへ push すると GitHub Actions がビルドして公開する。

このスキルで構築済みのリポジトリで再実行すると、スキルの最新の構成(デザインの実体である FF_REV・build-local.sh 等のスクリプト・pages.yml)へ更新できる。利用者が編集したサイトの内容(site/。ブランド設定は site/nav.toml の [site])と、pages.yml の追加の監視パス(利用者区間)は保持される。新規構築か更新かは Step 1 で自動判定する。

仕組みは次のとおり。

  • 生成器: fandhe-frontend の Rust 製 SSG(crates/docs-site)をそのまま使う。tools/docs-site-gen/FF_REV の commit を匿名の cargo install --git(--locked)で docs-site バイナリとしてインストールし、--no-page-sections で生成する(旧構成の wrapper crate はビルドに使わない)
  • ブランド設定: ヘッダーのブランド名・GitHub リンク・フッター等は site/nav.toml の [site](brand・repository_url・tagline 等)で指定する。上流の生成器がそのまま出力するため、生成後の置換は行わない。[site] の各キーの許容値は上流ガイドが正(ここへは書き写さない)。上流名は帰属表記(Built with … docs-site と MIT / Apache-2.0 のリンク)の中にだけ残る(references/maintenance.md)
  • デプロイ: Fandhe-AI/actions の共通 reusable workflow(pages-deploy.yml@latest)を呼ぶ

使い方

/setup-github-pages
Installs
27
First Seen
9 days ago