# GitHub プルリクエストのプレビュー

GitBook スペースに同期されている GitHub ブランチにプルリクエスト（PR）を送信すると、マージする前にコンテンツをプレビューできます。これにより、変更をマージする前にその影響を確認できます。

この機能を使うと、PR をマージする前に最終チェックを行うことができ、同期先ブランチにマージする前に、本番以外の環境で変更内容を確認できます。

### プレビューリンクへのアクセス方法

この動作は、以下に必要な読み取り専用権限を付与していれば、 [GitBook GitHub アプリ](https://github.com/apps/gitbook-com) PR に対する必要な読み取り専用権限を付与した場合に、追加の設定なしで動作します。

GitBook スペースと同期されたターゲットブランチを使って PR を作成するたびに、PR に一意のプレビュー URL を含むステータスが追加されます。ステータス上の **詳細** リンクをクリックすると、コンテンツのプレビュー URL に移動します。その後、PR をマージする前に、コンテンツが期待どおりであることを確認できます。

{% hint style="info" %}
プレビューリンクにアクセスできるのは、GitBook アカウントを持つユーザーのみです。
{% endhint %}

### セキュリティに関する考慮事項

セキュリティ上の理由から、デフォルトでは GitBook は現在、リポジトリのフォークから開かれた PR のプレビューを生成しません。PR プレビューのコンテンツは、あなた自身のドメイン配下でアクセス可能であり、たとえば `.gitbook.io` またはカスタムドメイン上で公開されるため、公開リポジトリのフォーク内に悪意のあるコンテンツを生成され、それがあなたの名前で配信される可能性があります。

この設定は、Git Sync 設定のオプションから明示的に指定できます。

### FAQ

#### プルリクエストで GitBook ドキュメントのプレビューが表示されないのはなぜですか？

よくある原因:

* **サイトが公開されていません。** PR プレビューの URL は、公開済みのドキュメントサイト（ `.gitbook.io` またはカスタムドメイン）から配信されます。
* **サイトが認証アクセスの背後にあります。** Git Sync の PR プレビューは、以下のように公開されているサイトでは利用できません [認証済みアクセス](/docs/documentation/ja-gitbook-documentation/saitoakusesu/authenticated-access.md).


---

# Agent Instructions: 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:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/git-sync/github-pull-request-preview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
