GitHub の接続

既存の GitHub リポジトリを接続し、そのコンテンツを Prosefly に取り込みます。オーナーと管理者が Organization settings → Repositories から管理できます。Connect repository を選んで始めます。

アカウント連携は GitHub 上の本人確認、GitHub App の認証はリポジトリへのアクセス許可です。リポジトリを選ぶ前に、両方が必要です。

1. GitHub アカウントを連携する

Connect GitHub account を選び、GitHub で認証を完了して Prosefly に戻ります。連携すると GitHub account connected と表示されます。

2. リポジトリへのアクセスを許可する

Authorize GitHub repositories を選びます。GitHub でリポジトリを所有するアカウントか組織を選び、管理したいリポジトリへのアクセスを Prosefly GitHub App に許可します。

組織へのインストールは、オーナーの承認が必要になることがあります。スキャンには読み取り権限で足ります。公開には必要な書き込み権限があり、ブランチ保護にも従う必要があります。

3. リポジトリを選ぶ

Prosefly に戻り、認証済みの一覧から、この組織に接続するリポジトリを検索・選択します。プランの枠内で複数選べます。一覧の下の接続ボタンで確定します。

見つからない場合は、Manage repository access から GitHub App の許可を確認してください。アカウントを連携するだけでは、すべてのリポジトリにアクセスできません。

4. リポジトリをスキャンする

接続したリポジトリは Organization settings → Repositories に表示されます。使いたいものの Scan repository を選びます。設定された対象ブランチを読み取り、サイトとコレクションを検出します。

スキャンは Git のファイルを変更せず、リポジトリのコードも実行しません。リポジトリの接続とスキャンは別の操作です。

5. コンテンツスペースを確定する

検出されたサイトやアプリを確認します。フレームワーク、ディレクトリ、コレクション、属性を確認して、管理するスペースを選びます。選択を確定し、インデックスの作成完了を待ってください。

下の Starlight の例では、Docs コレクション、コンテンツディレクトリ、15 個の属性、標準ナビゲーションの設定が検出されています。コンテンツスペースを確定する前に確認してください。結果はリポジトリの構成と対応する設定によって変わります。

コンテンツを開く

リポジトリの設定から確認済みのスペースを開き、Content で項目を選びます。下書きを編集・保存できます。保存では Git にコミットせず、公開は別途レビューして行います。

検出結果が想定と違う場合は、ブランチとコンテンツパスを確認してください。独自のローダーや動的な設定では、.prosefly/config.yaml による手動設定が必要になることがあります。Prosefly の外で変更した場合は、再スキャンとインデックスの再構築で表示を更新します。

エディターに進むか、設定とインデックスの詳細はリポジトリとコンテンツスペースをご覧ください。.prosefly/config.yaml の schema はリポジトリ設定で確認できます。

フレームワーク別の CMS 導入フロー

Astro 向け CMS、Hugo のコンテンツ管理、Starlightや Fumadocs のドキュメント編集をご覧ください。各ページで、対応するコンテンツ、編集方法、公開フローを紹介しています。

チームでの運用については、製品ドキュメントの管理で確認できます。

フレームワークごとの手順は Astro 向け CMS 導入ガイド、Starlight 向け CMS 導入ガイド、Fumadocs 向け CMS 導入ガイドをご覧ください。