Blog Builder
ユーザーが個人ブログを立ち上げるのを支援します。フレームワーク選定から、テーマ、記事テンプレート、デプロイ、適切な SEO 設定まで、ライブ公開までの全範囲をカバーします。
ワークフロー
Step 1 -- ユーザーの状況を把握する
質問する(または文脈から推測する):
- 技術的なバックグラウンド?(非技術者 / JS 開発者 / Python 開発者 / など)
- ゼロから始めるのか、既存サイトがあるのか?
- 希望するデプロイ先:GitHub Pages、Vercel、Cloudflare Pages?
- コンテンツの焦点:執筆、ポートフォリオ、チュートリアルブログ、ドキュメント?
Step 2 -- フレームワークを推奨する
| 状況 | 推奨 |
|---|---|
| 非技術者、ただ書きたいだけ | Hugo -- JS 不要、高速、豊富なテーマライブラリ |
| すでに JS/TS を書き、コンポーネント制御を希望 | Astro -- アイランドアーキテクチャ、優れた DX |
| テーマエコシステムが好き、Node に慣れている | Hexo -- 成熟したプラグインエコシステム |
| React 開発者、完全制御を希望 | Next.js -- App Router + MDX |
短い理由とともに推奨を提示します。次に進む前に確認します。
Step 3 -- フレームワークのセットアップ
該当するリファレンスファイルを読み、インストールとスターターテーマの手順をユーザーに案内します:
| フレームワーク | リファレンスファイル |
|---|---|
| Hugo | references/hugo.md |
| Hexo | references/hexo.md |
| Astro | references/astro.md |
| Next.js | references/nextjs.md |
Step 4 -- 記事テンプレートを生成する
完全なフロントマターを含む、すぐに使える記事テンプレートファイルを作成します。 assets/post-templates/ にあるアセットテンプレートは出発点です -- ユーザーの選んだテーマや好みに合わせてコピーして適応してください。
Step 5 -- デプロイ
references/deployment.md を読み、適切な CI/CD ワークフローを確認します。コミット可能な完全な GitHub Actions YAML を提供します。
重要な注意:
- GitHub Pages:.github/workflows/deploy.yml にプッシュ;リポジトリ設定で Pages を有効化
- Vercel:ダッシュボードでリポジトリを接続;フレームワークプリセットと出力ディレクトリを設定
- Cloudflare Pages:build command = npm run build、output dir = dist(Astro/Hexo/Next.js) または public(Hugo)
Step 6 -- SEO 設定
すべてのブログに必要なもの:
- sitemap.xml -- フレームワーク固有;references/.md を参照
- robots.txt -- 説明だけでなく、実際のファイル内容を提供する
- Open Graph タグ -- og:title、og:description、og:image、og:url を実際のマークアップとして
- Canonical URL -- 設定で baseURL / site を設定し、sitemap と OG タグが正しく動作するようにする
常に注意:サイト URL をフレームワーク設定に設定しないと、sitemap は正しい絶対 URL を生成できません。
基本方針
- 説明だけでなく、実際のファイル内容(コード、YAML、TOML)を提供する
- 意味のあるフィールドのみを含め、圧倒的なボイラープレートは避ける
- 人を惹きつける1〜2の落とし穴を指摘する(例:Hugo の baseURL、Astro の site フィールド)
- コピペしてすぐに使える例を優先する