Git it Write の設定と使い方完全ガイド

GitHub の Markdown ファイルを push するだけで、WordPress の投稿に自動反映できる神プラグインが 「Git it Write」です。

この記事では、Git it Write の導入から Webhook の設定まで、手順をステップごとに丁寧に紹介します。

---

🧩 Git it Write とは？

Git it Write は、GitHub のリポジトリと WordPress を連携し、Markdown 形式の記事を自動で投稿・更新できるプラグインです。

例えば、README.md や docs/ フォルダにある記事をそのまま WordPress 投稿として公開できます。
技術ブログやドキュメントサイト運用に最適です。

---

⚙️ 導入手順

1. プラグインをインストール

1. WordPress 管理画面 → プラグイン → 新規追加
2. 「Git it Write」で検索
3. 「今すぐインストール」→「有効化」

---

2. GitHub 側で Personal Access Token を作成

1. GitHub → 右上アイコン → Settings → Developer settings → Personal access tokens
2. 「Generate new token (classic)」をクリック
3. スコープは repo → public_repo にチェック
4. トークンを生成してコピー（後で WordPress に貼り付けます）

---

3. WordPress 側の設定

設定 → Git it Write を開いて、以下を入力します。

項目	入力内容
GitHub Username	あなたの GitHub ユーザー名
GitHub Access token	さきほど生成したトークン
Webhook secret	任意の文字列（例：GiW_2024_hamaruki）

最後に「Save settings」をクリック。

---

4. リポジトリを追加

同じ画面で「Add a new repository to publish posts from」をクリック。

項目	入力例
Owner	Sunwood-ai-labs
Repository	WP-dev
Path	（ルートなら空欄）
Post Type	post

→ 保存すると、連携リポジトリ一覧に追加されます。

---

5. GitHub に Webhook を設定

ここが一番重要なポイントです。

GitHub → 対象リポジトリ → Settings → Webhooks → Add webhook

項目	入力内容
Payload URL	https://hamaruki.com/wp-json/giw/v1/publish
Content type	application/json ✅
Secret	WordPress 側と同じ文字列（例：GiW_2024_hamaruki）
Which events...	「Just the push event」
Active	✅ チェックのまま

💡 ポイント:
Content type を application/x-www-form-urlencoded のままにすると、WordPress 側が 500 エラーを返すので必ず JSON に変更してください。

---

6. 動作確認

1. GitHub で .md ファイルを push
2. 数秒後、WordPress 管理画面 → Git it Write → Logs を確認
3. 「Received push event...」と出ていれば成功🎉
4. 投稿一覧に記事が自動追加されているはずです。

---

📝 Markdown の書き方

ファイル名が投稿のスラッグになります。

docs/
├── getting-started.md
└── tips/
└── index.md

• index.md はそのフォルダのメイン記事として扱われます。
• フロントマターでタイトルやカテゴリを指定可能。

---
title: はじめての Git it Write
post_status: publish
taxonomy:
  category:
    - WordPress
  post_tag:
    - Git
    - 自動化
---

# Git it Write 入門

この記事では、GitHub の Markdown を WordPress に自動投稿する方法を解説します。

---

💡 よくあるトラブルと解決法

症状	原因	対処
500 エラーになる	Content type が x-www-form-urlencoded のまま	application/json に変更
401 Unauthorized	Secret が不一致	WordPress と GitHub の Secret を同じにする
投稿されない	Path や Post Type が間違い	設定画面を再確認
画像が表示されない	_images フォルダに配置していない	/_images に入れて push

---

🎯 まとめ

ステップ	内容
1️⃣	GitHub Token 作成
2️⃣	WordPress 側に設定
3️⃣	Webhook 登録 (application/json)
4️⃣	.md を push
✅	自動で WordPress 投稿に反映！

---

🚀 おわりに

「Git it Write」を使えば、GitHub のワークフローをそのまま WordPress に繋げられます。
開発者にとって理想的なコンテンツ管理の形です。

🧡 この記事が役に立ったら、ぜひ Git it Write の公式ページ に 5⭐ レビューを！

---

作成者: Sunwood AI Labs