> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/git-sync/troubleshooting.md).
# トラブルシューティング
## GitHub同期エラーが発生しています
### リポジトリ内では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リポジトリ内で直接作成されたものです。このファイルは必須で、ドキュメントのホームページとして使用されます。詳細は、当社の [コンテンツ設定](/docs/documentation/ja-gitbook-documentation/getting-started/git-sync/content-configuration.md).
* MarkdownファイルにYAMLフロントマターがある場合は、次を使って有効であることを確認してください [リンター](http://www.yamllint.com)。
## GitBookが私の `docs` フォルダ
デフォルトでは、GitBookはリポジトリのルートを開始点として使用します。Markdownファイルの範囲を限定するために、特定のディレクトリを指定できます。詳細は、次のドキュメントをご覧ください。 [コンテンツ設定](/docs/documentation/ja-gitbook-documentation/getting-started/git-sync/content-configuration.md) 詳細については。
## GitBookが新しいMarkdownファイルを作成している
**GitBookから同期および編集する際** 既存のGitリポジトリでは、GitBookは既存のファイルではなく新しいMarkdownファイルを作成することがあります。 これは、GitBookがリポジトリ内に以前から存在していたファイルを上書きしないようにするためです。
## リダイレクトが正しく機能していません
リダイレクトを機能させるには、YAMLファイルが正しく書式設定されている必要があります。インデントや空白の誤りにより、リダイレクトが機能しないことがあります。 [YAMLファイルを検証する](https://www.yamllint.com/) リダイレクトがスムーズに動作することを確認できます。
リダイレクトを設定する際は、先頭にスラッシュを付けないでください。たとえば、次へリダイレクトしようとしても `./misc/support.md` は機能しません。
また、あるパスにページが存在する限り、GitBookはリダイレクトの可能性を探しません。そのため、古いページから新しいページへのリダイレクトを設定する場合は、リダイレクトを機能させるために古いページを削除する必要があります。
## リポジトリが一覧に表示されません
### GitHubリポジトリの場合
GitBook GitHubアプリを正しい場所にインストールしていること（アプリのインストール時には、個人のGitHubにインストールするか、権限のある組織にインストールするかを選べます）、そしてアプリに正しいリポジトリ権限を付与していることを確認してください。
### GitLabリポジトリの場合
アクセストークンに次のアクセス権が設定されていることを確認してください:
* `api`
* `read_repository`
* `write_repository`
## リポジトリに新しいファイルを追加してもGitBookで何も起こりません
{% hint style="warning" %}
**このセクションでは、次の場合の問題を特に扱います `SUMMARY.md` ファイルがすでに存在する**
リポジトリに〜が含まれていない場合 `SUMMARY.md` ファイルがない場合、GitBookは最初の同期時に自動的に作成します。つまり、Git syncの設定後にGitBookから少なくとも1回コンテンツを編集していれば、GitBookがこのファイルを自動的に作成しているはずです。
{% endhint %}
リポジトリでMarkdownファイルを追加または変更した後も、GitBookに更新が反映されず、サイドバーにも同期中のエラーが表示されない場合、変更したファイルはおそらく [あなたの `SUMMARY.md` ファイル](/docs/documentation/ja-gitbook-documentation/getting-started/git-sync/content-configuration.md#summary)。
これは、ファイルを手動で作成したか、GitBookで編集を行った際に、同期のGitBookからGitへのエクスポート段階で作成されたためかもしれません。
このファイルの内容は、あなたの [目次](/docs/documentation/ja-gitbook-documentation/rissu/gitbook-ui.md#table-of-contents) GitBook上での内容を反映しており、同期の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. 「GitHubでサインイン」オプションを選択します。
5. GitHubの認証情報を入力します。
6. ログインしたら、次へ移動します [アカウント設定](https://app.gitbook.com/account) そして、次のいずれかを行います:
1. 個人設定の「サードパーティログイン > GitHub」セクションでアカウントのリンクを解除する
2. 必要ない場合はアカウントを完全に削除します。
7. セッションからログアウトします。
8. 次の方法で再度ログインします `name@email.com` GitBookアカウント。
9. Git Syncの設定をもう一度試してください。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/git-sync/troubleshooting.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.