GitHubリポジトリでZennのコンテンツを管理する

Zennにはオンラインエディターが用意されていますが、GitHubリポジトリと連携すればローカルのテキストエディターで執筆することもできます。

GitHub連携時のイメージ

GitHubリポジトリと連携した場合、投稿コンテンツの作成や更新はすべてリポジトリ内で行います。登録したブランチに変更があると、zenn.devへ自動で同期（デプロイ）が行われます。

同期するブランチの指定

GitHub連携が完了している場合、下記のページからブランチを変更できます。
デプロイ設定 →

コンテンツの作成

ローカルのテキストエディターなどでmarkdownファイルを作成し、編集します。ファイルの作成やプレビューにはZenn CLIを使用できます。

編集が完了したらリモートリポジトリ（GitHub）へプッシュします。登録したブランチへのプッシュやプルリクエストのマージによりデプロイが開始されます。

zenn.devにまだ存在しない名前のファイルが見つかると新しいコンテンツとして作成されます。

デプロイ履歴はダッシュボードから確認できます。デプロイ時に発生したエラーもここでチェックします。

内容の更新

内容を変更するときは.mdファイルを編集し、再度プッシュします。変更が加えられた.mdファイルのみがzenn.devに同期されます。

コンテンツの削除

安全のため、コンテンツの削除はダッシュボードからのみ行うことができます。

GitHubとの連携手順

1. リポジトリを作成する

まずGitHubで好きな名前のリポジトリを作成します。公開設定はPublicでもPrivateでもOKです。この時点ではリポジトリの中身は空にしておきます。README.mdを作成する必要もありません。

2. ダッシュボードから連携する

Zennにログインしたうえで、ダッシュボードのデプロイ管理を開きます。

［リポジトリを連携］を選ぶと、リポジトリを選択する画面が表示されます。

このとき必ず「Only select repositories」にチェックを入れて、連携するリポジトリだけを選ぶようにしてください。

連携できるリポジトリは最大2つです。3つ以上選択されていると連携が失敗します。これは安全のための意図的な仕様です。

これで連携は完了です。

3. 同期するブランチ名を確認

デプロイページで同期したいブランチ名を確認・変更します。

ここで登録されている名前のブランチに変更があったときに自動でデプロイが行われます。

ファイルの作成やプレビューはCLIで

ローカルでのファイルの作成や、markdownのプレビューにはZenn CLIを使います。具体的な使い方は下記のページをご覧ください。

📘 Zenn CLIの導入手順 →

GitHubリポジトリ連携についてのFAQ

連携するリポジトリを変更したい

ダッシュボードで連携を解除した後に、再度連携を行なってください。連携を解除しても同期されているデータはそのまま残ります。

連携するリポジトリを追加したい場合も一度連携を解除してから再連携を行っていただくようお願いします。

リポジトリにプッシュしてもデプロイされない

ダッシュボードからデプロイ履歴を確認してください。

プッシュされた内容に問題がある場合は、エラーメッセージが表示されます。

もしデプロイ履歴にログが出ていない場合は、GitHubのインストール済みのApplicationsの一覧からZenn ConnectのConfigureを開き、ダッシュボードに表示されている連携リポジトリとApplicationがアクセスを許可しているリポジトリが一致することを確認してください。

【ダッシュボードに表示されている連携リポジトリ】

【Applicationがアクセスを許可しているリポジトリ】

一致していない場合はデプロイされませんので、Application側のリポジトリを変更してください。また、連携するリポジトリを変更したい場合は、zennのダッシュボードから一度連携を解除してから再度連携を行ってください。

（複数リポジトリ連携時）同じ記事を別のリポジトリに移行することはできる？

slugが一致していればどちらのリポジトリから同期されても同じように上書きされます。そのため、記事や本のファイルを別のリポジトリに移動するだけで移行は完了します。