GitHubリポジトリをkakubaseに連携して記事を自動公開する方法

はじめに

kakubase は GitHub リポジトリと連携することで、記事の公開・更新を自動化できます。

一度セットアップすれば、手順はとてもシンプルです。

1. 記事を書く
2. git push する
3. kakubase に自動反映される

このページでは、そのセットアップを一から説明します。

事前準備

GitHub アカウントを用意する

GitHub アカウントをお持ちでない場合は、GitHub からアカウントを作成してください。

すでにお持ちの場合はそのまま次に進んでください。

リポジトリを作成する

kakubase の記事を管理する GitHub リポジトリを新規作成します。

1. GitHub にログインして「New repository」をクリック
2. リポジトリ名を入力（例：my-kakubase-content）
3. Public / Private どちらでも OK
4. 「Create repository」をクリック

Step 1 — kakubase にログインする

kakubase にアクセスして、GitHub アカウントでログインします。

「GitHub でログイン」ボタンをクリックすると GitHub の認証画面が開きます。許可して進んでください。

Step 2 — GitHub リポジトリを連携する

ログイン後、kakubase のダッシュボードからリポジトリの連携設定を行います。

1. ダッシュボードの「リポジトリを連携する」をクリック
2. 先ほど作成した GitHub リポジトリを選択
3. 「連携する」をクリック

連携が完了すると、そのリポジトリへの push を kakubase が検知するようになります。

Step 3 — リポジトリを初期化する

npx kakubase-cli init を実行する

手元にリポジトリをクローンして、初期化コマンドを実行します。

git clone https://github.com/{ユーザー名}/{リポジトリ名}.git
cd {リポジトリ名}
npx kakubase-cli init

実行すると、以下のファイルとフォルダが自動で生成されます。

articles/        ← 記事を置く場所
images/          ← サイト共通の画像
.gitignore
README.md
はじめかた.md
記事の書きかた.md
よくある質問.md

生成されるファイル構成

初期化後のフォルダ構成はこのようになります。

my-kakubase-content/
├── articles/          ← 記事はここに入れる
├── images/            ← サイト全体で使う画像
├── .gitignore
├── README.md
├── はじめかた.md
├── 記事の書きかた.md
└── よくある質問.md

この状態で最初の push をします。

git add .
git commit -m "初期化"
git push

Step 4 — 記事を書いて push する

記事フォルダを作成する

記事を新規作成します。

npx kakubase-cli new:article

スラッグ（記事の URL）の入力を求められます。英小文字・数字・ハイフンのみ使えます。

slug（記事のURL・フォルダ名）: my-first-post

入力すると articles/my-first-post/index.md が生成されます。エディタで開いて記事を書きましょう。

ローカルで見た目を確認したい場合は、プレビューサーバーを起動します。

npx kakubase-cli preview
# → http://localhost:4567 が開く

published: true にして push する

記事が完成したら、index.md の published を true に変更します。

---
title: 私の最初の記事
published: true   # ← false から true に変更
---

あとは git push するだけです。

git add articles/my-first-post/
git commit -m "最初の記事を公開"
git push

Step 5 — kakubase で公開を確認する

push 後、数秒〜数十秒で kakubase に記事が反映されます。

kakubase のダッシュボードまたは自分のプロフィールページで、記事が表示されているか確認してください。

まとめ

ステップ	作業内容
事前準備	GitHub アカウント作成・リポジトリ作成
Step 1	kakubase に GitHub アカウントでログイン
Step 2	ダッシュボードでリポジトリを連携
Step 3	npx kakubase-cli init で初期化・push
Step 4	記事を書いて published: true にして push
Step 5	kakubase で公開を確認

一度セットアップしてしまえば、あとは記事を書いて push するだけで公開できます。ぜひ活用してみてください。