つむぎで作った記事は、「公開先」を接続しておくと、あなたのサイトの管理場所へ自動で届けられます。設定は「設定」→ サイトの「公開設定」で行います。
公開先とは
記事の届け先となる外部サービスとの接続です。2種類あります。
| 種類 | 届き方 | 向いている使い方 |
|---|---|---|
| GitHub PR | 記事をドラフトのプルリクエスト(PR)として作成します | GitHubで管理しているサイト。自動配信・手動配信の両方に使えます |
| WordPress | WordPressへ記事を届けます | 個別公開用。自動運用の既定公開先には設定できません |
接続は組織内のサイトで共有されます。一度登録すれば、複数のサイトから同じ接続を使えます。
公開先を接続する
公開先の管理は、オーナーまたは管理者のみが行えます。
- 「設定」を開き、左メニューの「現在のサイト」で対象サイトを選ぶ
- 「公開設定」を開き、「公開先の接続」の「配信先を追加」を押す
- 名前と種類を入力して「保存」する
種類ごとの入力内容は次のとおりです。
- GitHub PR — リポジトリ(owner/name)、ベースブランチ(任意)、認証方式を入力します
- 認証方式が「Personal Access Token」の場合: repo権限のアクセストークンを入力します
- 認証方式が「GitHub App」の場合: 対象リポジトリにAppをインストールし、そのInstallation IDを入力します(トークンの保存は不要です)
- WordPress — WordPressのエンドポイント(https://example.com/wp-json など)とアプリケーションパスワードを入力します
トークンやパスワードは安全のため保存後は表示されません。変更したい場合は、接続を削除して登録し直します。
サイトの既定公開先を設定する
「既定の公開先」で配信先を選び、「公開先を保存」を押します。ここで選んだ接続が、自動運用で今後作成する記事のPR作成先になります。
- 変更は今後作成する記事だけに適用され、進行中の記事には影響しません
- 「配信しない」を選ぶと、記事は自動配信されず、つむぎの中に保存されるだけになります
自動でドラフトPRが作られる流れ
既定公開先(GitHub PR)を設定しておくと、記事の生成が完了したタイミングで、本文と画像をまとめたドラフトPRが自動で作成されます。
PRの内容をあなたが確認し、問題なければマージして公開してください。つむぎが勝手にサイトを公開・更新することはありません。
手動で配信する
生成時に公開先を設定していなかった記事や、配信に失敗した記事は、あとから手動で配信できます。
- 記事の詳細ページを開き、「配信先」パネルの「手動配信」を見る
- 配信先を選び、「PR作成を確認」にチェックを入れる
- 「GitHubにPRを作成」を押す
手動配信には、先に記事の承認が必要です。同じ記事でもう一度実行すると、新しいPRは作られず同じPRが更新されます。