GitHub同期の有効化

GitBookのためのGitHub統合を設定および認可する

はじめに

GitHub リポジトリと同期したいスペースで、次に移動します スペースヘッダー 右上の、をクリックしてから選択します 設定プロバイダー一覧から、を選択します GitHub 同期.

GitHub 同期の構成オプション。

GitHub で認証する

GitHub 同期を初めて設定し、まだ GitHub アカウントをリンクしていない場合は、Git 同期の設定を開始するときにリンクを求められます。すでにアカウントをリンクしている場合でも、GitHub 経由で認証する必要がある場合があります。

が表示された場合 「重複の可能性があるアカウント」 このステップでエラーメッセージが表示される場合、あなたの GitHub アカウントは既に別の GitBook ユーザーアカウントとリンクされています。

どのアカウントがリンクされているかを特定するには、このセッションからログアウトし、GitHub でサインインする方法を使ってログインし直す必要があります。

GitHub と関連付けられた GitBook アカウントが既に分かっている場合は、そのユーザーアカウントにログインして GitHub アカウントのリンクを解除（設定で行います）してから、再度ログインして現在のアカウントをリンクできます。

詳細は当社の トラブルシューティングページ.

GitHub アカウントに GitBook アプリをインストールする

まだ行っていない場合、次の追加を促す表示が出ます GitBook アプリ をあなたの GitHub アカウントに追加します。

GitHub のポップオーバーの指示に従い、必要に応じて GitBook に特定のリポジトリ権限を付与するか、すべてのリポジトリへのアクセスを許可してください。

リポジトリとブランチを選択する

GitBook のコンテンツと同期したいアカウントとリポジトリを選択します。

リポジトリが見つかりませんか？ リストにリポジトリが見つからない場合は、次をインストールしているか確認してください GitBook GitHub アプリ が正しいスコープ（例：個人アカウントやリポジトリが存在する GitHub 組織）にインストールされていることを確認してください。また、GitBook GitHub アプリで正しいリポジトリアクセスを構成しているか確認する必要があります。

正しいリポジトリを選択したら、コミットをプッシュして同期するブランチを選択します。

初回同期を実行する

初めて同期を行うとき、次の2つの方向のいずれかで同期するオプションがあります：

1. GitBook -> GitHub はあなたのスペースのコンテンツを同期します に 選択したブランチへ。これは空のリポジトリから始めて GitBook のコンテンツをすばやく取り込みたい場合に便利です。

2. GitHub -> GitBook はあなたのスペースのコンテンツを同期します から 選択したブランチから。既存の Markdown コンテンツがリポジトリにあり、それを GitBook に取り込みたい場合に便利です。

書いてコミットする

準備完了です。スペースが ライブ編集 モードだった場合、ライブ編集は現在ロックされています。これにより、チームの誰かが GitBook で 変更リクエスト をマージしたときに、コンテンツを確実にリポジトリへ同期できます。

GitBook で編集すると、すべての変更リクエストのマージは選択した GitHub ブランチへのコミットにつながります。

GitHub にコミットすると、すべてのコミットが履歴コミットとしてあなたの GitBook スペースに同期されます。

当社の GitHub 統合を支える GitHub アプリは、現在 GitHub Enterprise Server インスタンスの顧客には提供されていません。