# トラブルシューティング

## GitHub同期エラーが発生しました <a href="#i-have-a-github-sync-error" id="i-have-a-github-sync-error"></a>

### リポジトリには必ずREADMEファイルのみを作成してください

Git Syncが有効なときは、GitBookのUIを通じてREADMEファイルを作成しないよう注意してください。GitBookのUIでREADMEファイルを作成すると：

* リポジトリに重複するREADMEファイルが作成されます
* GitBookとGitHubの間でレンダリングの競合が発生します
* ビルドやデプロイのプロセスが壊れる可能性があります
* ファイルの優先順位が予測不能になります

これはREADME.md、readme.md、Readme.md、拡張子なしのREADMEという名前のファイルを含みます。代わりに、READMEファイルは直接gitリポジトリ内で管理するようにしてください。

### まだエラーが発生しますか？

次を確認してください：

* あなたのリポジトリが **を持っていること** `README.md` **ファイル** ルート（または `root` に指定されたフォルダ）に `.gitbook.yaml`)に、gitリポジトリで直接作成されたファイル。このファイルは必須で、ドキュメントのホームページとして使用されます。詳細については、私たちの [コンテンツ設定](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/git-sync/content-configuration).
* MarkdownファイルにYAMLフロントマターがある場合は、必ず [リンター](http://www.yamllint.com)を使って有効か確認してください。

## GitBookが私の `docs` フォルダを使っていません <a href="#gitbook-is-not-using-my-docs-folder" id="gitbook-is-not-using-my-docs-folder"></a>

デフォルトでは、GitBookはリポジトリのルートを開始ポイントとして使用します。Markdownファイルのスコープを限定するために特定のディレクトリを指定できます。詳細は私たちのドキュメントの [コンテンツ設定](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/git-sync/content-configuration) を参照してください。

## GitBookが新しいMarkdownファイルを作成しています <a href="#gitbook-is-creating-new-markdown-files" id="gitbook-is-creating-new-markdown-files"></a>

**既存のGitリポジトリと同期してGitBookから編集する際、** GitBookは既存のファイルを使用せずに新しいMarkdownファイルを作成することがあります。これは、GitBookがリポジトリに元々存在していたファイルを上書きしないようにするために行われます。

## リダイレクトが正しく動作しない

リダイレクトを機能させるにはYAMLファイルが正しくフォーマットされている必要があります。インデントや空白の誤りなどは、リダイレクトが機能しない原因になります。 [YAMLファイルの検証は](https://www.yamllint.com/) リダイレクトがスムーズに動作することを確実にします。

リダイレクトを設定する際は、先頭にスラッシュを追加しないでください。例えば、 `./misc/support.md` へのリダイレクトは動作しません。

また、あるパスにページが存在する限り、GitBookはリダイレクトの有無を探さないことに注意することも重要です。したがって、古いページから新しいページへのリダイレクトを設定する場合は、リダイレクトを機能させるために古いページを削除する必要があります。

## 私のリポジトリが一覧に表示されません <a href="#my-repository-is-not-listed" id="my-repository-is-not-listed"></a>

### GitHubリポジトリの場合

GitBook GitHubアプリが正しい場所にインストールされていることを確認してください（アプリをインストールする際、個人のGitHubにインストールするか、権限のある組織にインストールするかを選択できます）およびアプリに正しいリポジトリ権限が付与されていることを確認してください。

### GitLabリポジトリの場合

アクセストークンに次のアクセスが設定されていることを確認してください：

* `api`
* `read_repository`
* `write_repository`

## リポジトリに新しいファイルを追加してもGitBookで何も起きない <a href="#nothing-happens-on-gitbook-after-adding-a-new-file-to-my-repository" id="nothing-happens-on-gitbook-after-adding-a-new-file-to-my-repository"></a>

{% hint style="warning" %}
**このセクションは特に、 `SUMMARY.md` ファイルが既に存在する場合の問題に対処しています**

リポジトリに `SUMMARY.md` ファイルが含まれていない場合、GitBookは最初の同期時に自動的に1つ作成します。つまり、Git Syncを設定した後に少なくとも一度GitBookからコンテンツを編集した場合、GitBookはこのファイルを自動的に作成しているはずです。
{% endhint %}

リポジトリを更新してMarkdownファイルを追加または変更した後に、GitBookに更新が反映されず、サイドバーに同期中のエラーが表示されない場合、変更したファイルはおそらく [あなたの `SUMMARY.md` ファイル](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/content-configuration#summary)のファイルを探します。

に一覧表示されていません

このファイルの内容はGitBook上のあなたの [の目次](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/rissu/gitbook-ui#table-of-contents) を反映しており、GitからGitBookへのインポートフェーズで目次を再作成し、リポジトリからの今後の更新を既存のGitBookコンテンツと再調整する際に使用されます。

すべてのファイルが `SUMMARY.md` ファイルに含まれていることを確認した後でもGitBookで何も起きない場合は、遠慮なく [サポートに連絡してください](https://gitbook.com/docs/help-center/further-help/how-do-i-contact-support) 支援を受けるために。

## GitHubプレビューが表示されない

GitHubプレビューが表示されない場合、GitSync統合が2022年1月以前に構成されている可能性があります。この日以前に構成されたGitSyncのバージョンにはGitHubプレビューが含まれていません。

PRへの読み取り専用アクセスを有効にするための更新された権限要求を承認するよう求める通知を受け取っているはずです。

通知を受け取っていない場合は、トラブルシューティングのために新しいバージョンに更新する必要があります：

1. 組織からGitSync統合をアンインストールしてください。
2. 更新された権限で新しいバージョンを再インストールしてください。

GitSync統合をアンインストールすると、以前接続されていたスペースごとに統合の再構成が必要になることに注意してください。

## サインイン時のアカウント重複の可能性

このエラーは通常、同期を設定するために使用したGitHubアカウントが既に別のGitBookユーザーアカウントに関連付けられている場合に発生します。

GitHubアカウントが既にリンクされているGitBookアカウントを特定する良い方法は：

1. 現在のGitBookユーザーセッション（例： `name@email.com`)
2. すべてのGitHubユーザーセッションからログアウトしてください。
3. に移動してください [ログインページ](https://app.gitbook.com/login).
4. 「Sign in with GitHub」オプションを選択してください。
5. GitHubの資格情報を入力してください。
6. ログインしたら、に移動してください [アカウント設定](https://app.gitbook.com/account) そして次のいずれかを行ってください：
   1. 個人設定の「サードパーティログイン > GitHub」セクションでアカウントの連携を解除する
   2. 不要であればアカウントを完全に削除する
7. セッションからログアウトしてください。
8. あなたの `name@email.com` GitBookアカウントで再ログインしてください。
9. もう一度Git Syncの設定を試してください。