トラブルシューティング

リポジトリが見つからない

GitHub アカウントの連携、所有者のアカウントへの GitHub App のインストール、対象リポジトリへのアクセス許可を確認してください。組織へのインストールでは、オーナーの承認が必要な場合があります。修正後に Repositories に戻り、再接続します。

Git の変更が見えない

リポジトリをスキャンし、インデックスの作成完了を待ちます。Prosefly は GitHub webhook の自動同期ではなく、明示的なスキャンを使います。想定の対象ブランチをスキャンしたか確認してください。

スペースがアーカイブされている

リポジトリを切断すると、スペースはアーカイブされます。再接続後、オーナーか管理者が必要なスペースを再有効化します。有効なスペースの利用枠が確認されます。

文書をビジュアル編集で開けない

Source を開き、ファイル全体を確認します。frontmatter の誤りや未対応の MDX が原因になることがあります。任意のリポジトリのコンポーネントを実行することはありません。ソースを修正し、保存状態を確認してください。

公開できない

レビューの競合や検証エラーを確認します。GitHub App の書き込み権限、スペースの公開方法、対象ブランチの保護、組織の役割、有効な利用権限を確認してください。基準が変わった場合は、現在の Git の内容と下書きを比較します。

公開してもサイトが変わらない

Publish history の GitHub リンクを開きます。PR ならマージ済みか確認してください。サイトのビルド状態とデプロイ対象ブランチを確認します。Git への公開自体は、デプロイを実行しません。

アップロードが失敗する、解析が空になる

ファイルの検証と Billing の利用枠を確認します。アップロードの状態を確認してから再試行してください。音声・動画の解析には稼働中の連携設定が必要です。レポートがないだけでは、再生されなかったとは判断できません。

サポートに問題を伝える場合は、行った操作、表示されたエラー、関連するリポジトリやファイルのパスを添えてください。認証情報や、共有を意図しない非公開コンテンツは含めないでください。