GitHub同期の有効化

GitBookのためのGitHub統合を設定して認可する

始めるにあたって

GitHubリポジトリと同期したいスペースで、に移動し、 スペースヘッダー 右上にある、そして選択します 構成。プロバイダリストから、を選択します GitHub Sync.

GitHub Sync の設定オプション。

GitHubで認証する

GitHub Sync を初めて設定し、まだ GitHub アカウントをリンクしていない場合は、Git Sync の設定を開始するとリンクを行うよう促されます。既にアカウントをリンクしている場合でも、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 インスタンス上の顧客には提供されていません。