> 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/quickstart.md).

# クイックスタート

GitBook をすぐに使い始めて、数分で最初のドキュメントサイトを公開しましょう

このクイックスタートガイドでは、GitBook のセットアップ方法と、数分で最初の Docs サイトを公開する方法を説明します。

このガイドの最後には、拡張やカスタマイズの準備が整った公開中のドキュメントサイトが手に入ります。

{% stepper %}
{% step %}

#### アカウントを作成する

[アカウントを作成](https://app.gitbook.com/join) 最初のドキュメントサイトを始めるために。
{% endstep %}

{% step %}

#### 最初のサイトを作成

1. 組織から **ホーム**、 **+** の横にある **サイト** をサイドバーで。
2. 訪問者がすぐに認識できるサイト名を付けてください。
3. クリックして **作成**.
   {% endstep %}

{% step %}

#### どのように始めるかを選択してください

GitBook が新しいサイトへようこそと案内し、どのように始めたいかを尋ねます。

<table><thead><tr><th width="200">開始地点</th><th>最適な用途</th></tr></thead><tbody><tr><td><strong>Docs テンプレート</strong></td><td>プレースホルダーのセクションを含む、完成済みのドキュメントレイアウトから始める方法です。完全なサイトが動作するのを最も早く確認できます。</td></tr><tr><td><strong>インポート</strong></td><td>オンラインのドキュメント、Markdown、または HTML から既存のコンテンツを取り込む方法です。</td></tr><tr><td><strong>OpenAPI</strong></td><td>OpenAPI 仕様から、インタラクティブな API リファレンスドキュメントを生成します。</td></tr><tr><td><strong>空白</strong></td><td>空のセクションから始め、ゼロから作成します。</td></tr><tr><td><strong>Git と同期</strong></td><td>GitHub または GitLab リポジトリとドキュメントを同期して、同期を維持します。</td></tr></tbody></table>

すでに GitBook で作業している内容がある場合は、組織の既存コンテンツから選ぶこともできます。

このガイドはテンプレートの流れに従います：

1. クリックして **Docs テンプレート** プレビューを確認します。
2. クリックして **Docs テンプレートを使用** 適用します。
   {% endstep %}

{% step %}

#### 新しいサイトを確認する

サイトは未公開の状態で開くため、公開前にすべてを編集・カスタマイズ・プレビューできます。サイドバーには次が表示されます：

<table><thead><tr><th width="160">サイドバー領域</th><th>ここにあるもの</th></tr></thead><tbody><tr><td><strong>サイトヘッダー</strong></td><td>サイト名、公開ステータス、および <strong>プレビュー</strong> 、 <strong>公開</strong> ボタンがあります。</td></tr><tr><td><strong>全般</strong></td><td><strong>概要</strong>, <strong>変更リクエスト</strong>, <strong>サイト構造</strong>を読み取り、 <strong>設定</strong>.</td></tr><tr><td><strong>ツール</strong></td><td><strong>スタイルガイド</strong>, <strong>カスタマイズ</strong>, <strong>分析</strong>を読み取り、 <strong>拡張</strong>.</td></tr><tr><td><strong>コンテンツ</strong></td><td>これらはサイトのセクションです。Docs テンプレートの場合は、Home、Documentation、API Reference、Changelog、Help Center です。左側の <strong>コンテンツ</strong> ヘッダーで使って、セクションを検索・名前変更・追加できます。</td></tr></tbody></table>

{% hint style="success" %}
コンテンツはまだ公開されていません。そのため、公開する前にドキュメントサイトを編集・カスタマイズ・プレビューできます。 **公開** すぐに公開するには、

<i class="fa-arrow-down">:arrow-down:</i> [このページの「ドキュメントを公開する」ステップへジャンプします](#publish-your-documentation)
{% endhint %}
{% endstep %}

{% step %}

#### コンテンツを編集

Docs テンプレートでは、サイドバーの **コンテンツ** 部分にプレースホルダーのセクションが表示されます。任意のセクションをクリックして開き、プレースホルダーの内容を確認します。

GitBook では、コンテンツの編集と更新に 2 つの方法があります。ビジュアルエディターを使う方法と、docs-as-code ワークフローに従う方法です。 **どちらか一方を選んでも、両方を組み合わせても構いません。** どのワークフローを選んでも、 **ブランチベースの編集フロー**を使用してコンテンツを編集します。 [コンセプトページ](/docs/documentation/ja-gitbook-documentation/rifarensu/concepts.md).

{% tabs %}
{% tab title="ビジュアルエディター" icon="hand-pointer" %}
GitBook の WYSIWYG（見たまま編集）エディターを使うと、視覚的にコンテンツを編集したり、コンテンツブロックをドラッグして並べ替えたり、作業しながら見た目を確認できます。コードエディターを使いたくない場合や、Notion や Google Docs のようなツールに慣れている場合に最適です。

**変更リクエストでドキュメントを編集する**

1. 次の場所で **コンテンツ** サイドバーの
2. クリックして **編集** セクションで、Documentation などのセクションをクリックして開きます。
3. クリックして **右上の** > **これは、セクションのコンテンツを変更できる変更リクエストを開きます。** 新規追加…
4. ページ

**左側の目次内に**

ウェブアプリの上部には、 **エディター**, **変更**を読み取り、 **プレビュー**のタブが表示されます。これらはコンテンツのさまざまな表示に切り替えるためのものです。 **プレビュー** をクリックすると、変更リクエスト内のすべての変更を反映したドキュメントサイトの見た目を、デスクトップとモバイルの両方で確認できます。

**変更をマージする**

変更に満足したら、右上の **マージ** ボタンをクリックします。これにより、変更リクエストのすべての編集がコンテンツのプライマリーバージョンに反映されます。コンテンツが公開中のドキュメントサイトの一部である場合、サイトはすぐに更新されます。
{% endtab %}

{% tab title="AI エージェント" icon="robot" %}
GitHub または GitLab リポジトリとドキュメントを同期して、既存の開発環境でコードベースの編集を有効にします。その他のコードと並べてドキュメントを管理したい技術ユーザーに最適です。

**Git Sync をセットアップ**

1. 同期したいセクションを **コンテンツ** サイドバーの
2. Git Sync インジケーターの **セットアップ** トップバーの
3. 手順に従って、選択した Git リポジトリにセクションを同期します。 [Git Sync ページ](/docs/documentation/ja-gitbook-documentation/dokyumentowokdotoshiteu/git-sync.md) で詳細を確認してください。

**開発環境からドキュメントを編集する**

セクションを Git リポジトリに同期したら、

1. リポジトリを開きます。
2. プルリクエストを作成します。
3. 希望する変更を加えます。

{% hint style="info" %}
GitBook は [Markdown 編集](/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/formatting/markdown.md)をサポートしているため、一般的な構文を使ってコンテンツを作成・整形できます。

GitBook の標準ブロックはすべて、Markdown を使って記述および整形できます。
{% endhint %}

**左側の目次内に**

できます [変更内容をプレビューする](/docs/documentation/ja-gitbook-documentation/dokyumentowokdotoshiteu/git-sync/github-pull-request-preview.md) GitHub または GitLab のプルリクエストから公開中のドキュメントサイトで確認できます。プルリクエストには、固有のプレビュー URL を含むステータスが表示されます。 **詳細** そのステータスで開くと、マージ後のサイトの見た目を確認できます。

**変更をマージする**

プルリクエストをマージすると、GitBook アプリ内と公開中のドキュメントサイトの両方でコンテンツが更新されます。GitBook アプリでは、すべてのコミットとマージ済みのプルリクエストが、バージョン履歴の更新としてセクションに同期されます。
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

#### ドキュメントをカスタマイズする

**サイトのナビゲーションを整理する**

API リファレンス、ヘルプセンター、変更履歴など、必要に応じていつでもサイトにコンテンツを追加し、訪問者が探しているものを見つけやすいようにサイトのナビゲーションバーを整理できます。 [サイト構造](/docs/documentation/ja-gitbook-documentation/saitowosuru/site-structure.md) で、セクション、グループ、バリアントについて学びましょう。

**見た目をカスタマイズする**

サイトはそのままでも見栄えが良いですが、 **カスタマイズ**の下で、独自の [ロゴ、色、フォント](/docs/documentation/ja-gitbook-documentation/saitowosuru/customization/icons-colors-and-themes.md)を設定し、レイアウトを調整し、 [サイトの公開設定](/docs/documentation/ja-gitbook-documentation/saitowosuru/site-settings.md#audience).
{% endstep %}

{% step %}

#### ドキュメントを公開する <a href="#publish-your-documentation" id="publish-your-documentation"></a>

いつでもクリックひとつでサイトを公開できます。

1. 組織からサイトを開く **ホーム**.
2. クリックして **公開** をサイトヘッダーで。

サイトが公開されると、 **概要** 画面が公開サイトへのリンク付きで更新されます。

{% hint style="success" %}
より詳しく公開を探求したいですか？ [GitBook でコンテンツを作成・公開するための完全ガイド](/docs/guides/editing-and-publishing-documentation/complete-guide-to-publishing-docs-gitbook.md).
{% endhint %}
{% endstep %}
{% endstepper %}

#### カスタムドメインを追加する

デフォルトでは、サイトは次の形式の固有 URL で公開されます：

{% code title="サイトのデフォルト URL" %}

```
https://[organization-name].gitbook.io/[site-title]
```

{% endcode %}

これは一部のチームには適しているかもしれませんが、多くのチームは URL を次のように変更することを選びます [カスタムドメイン](/docs/documentation/ja-gitbook-documentation/suru-1/custom-domain.md) または [カスタムサブディレクトリ](/docs/documentation/ja-gitbook-documentation/suru-1/custom-domain/setting-a-custom-subdirectory.md).

1. 展開 **設定** サイトのサイドバーで。
2. クリックして **ドメインとURL**.
3. 希望するオプションを選択します。
4. ドメインプロバイダーに対して DNS 設定を構成する手順に従います。

{% hint style="info" %}
DNS 変更が反映されるまで最大 48 時間かかることがありますが、通常はもっと早く伝播します。
{% endhint %}

#### 次のステップ

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">カバー画像</th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-type="image">カバー画像（ダーク）</th><th data-hidden data-type="image">カバー画像（ダーク）</th><th data-hidden data-type="image">カバー画像（ダーク）</th><th data-hidden data-type="image">カバー画像（ダーク）</th><th data-hidden data-card-cover-dark data-type="image">カバー画像（ダーク）</th></tr></thead><tbody><tr><td><strong>チームを招待して共同作業する</strong></td><td>組織にチームメンバーを追加し、権限を設定する</td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fx86ICzAJYkRIHo8CkBfa%2FInvite%20your%20team%20to%20collaborate.png?alt=media&amp;token=427f64f0-9175-4787-a952-827bcdbec2ab">25_12_10_invite_your_team_to_collaborate_1.png</a></td><td><a href="/docs/documentation/ja-gitbook-documentation/suru/member-management/invite-members-to-your-organization.md">メンバーの管理または削除</a></td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fanu5lcBOfoYfNQPIUA65%2FInvite%20your%20team%20to%20collaborate.png?alt=media&amp;token=1759c40c-08a4-42e4-a345-2b91dfad1f62">25_12_10_invite_your_team_to_collaborate.png</a></td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fanu5lcBOfoYfNQPIUA65%2FInvite%20your%20team%20to%20collaborate.png?alt=media&amp;token=1759c40c-08a4-42e4-a345-2b91dfad1f62">25_12_10_invite_your_team_to_collaborate.png</a></td><td></td><td></td><td></td></tr><tr><td><strong>サイトの公開範囲を変更する</strong></td><td>共有リンクと認証アクセスで、誰がコンテンツを閲覧できるかを制御する</td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FA33LxfEQT05aX7uUdLpb%2FChange%20site%20visibility.png?alt=media&amp;token=896f9961-f57b-4a5b-8903-792303827565">25_12_10_change_site_visibility_1.png</a></td><td><a href="/docs/documentation/ja-gitbook-documentation/suru-1/publish-a-docs-site.md#publish-a-docs-site">ドキュメントサイトを公開する</a></td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FDpa2c6rD9NiYgtdlIvF0%2FChange%20site%20visibility.png?alt=media&amp;token=f2c838ef-2737-4b8a-ad8b-69453bf28f53">25_12_10_change_site_visibility.png</a></td><td></td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FDpa2c6rD9NiYgtdlIvF0%2FChange%20site%20visibility.png?alt=media&amp;token=f2c838ef-2737-4b8a-ad8b-69453bf28f53">25_12_10_change_site_visibility.png</a></td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FDpa2c6rD9NiYgtdlIvF0%2FChange%20site%20visibility.png?alt=media&amp;token=f2c838ef-2737-4b8a-ad8b-69453bf28f53">25_12_10_change_site_visibility.png</a></td><td></td></tr><tr><td><strong>自動翻訳を追加する</strong></td><td>自動で更新されるワンクリック翻訳を作成する</td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FC5waVC2qQyf9I6hE7uQW%2FAdd%20auto-translations.png?alt=media&amp;token=888e2471-7041-40f0-8b22-83c442bd0808">25_12_10_add_auto_translations_1.png</a></td><td><a href="/docs/documentation/ja-gitbook-documentation/saitowosuru/site-settings.md">サイト設定</a></td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Flewca2EA3o9UnsB9j0vz%2FAdd%20auto-translations.png?alt=media&amp;token=f3a42248-f303-44ce-b577-375f8579c34c">25_12_10_add_auto_translations.png</a></td><td></td><td></td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Flewca2EA3o9UnsB9j0vz%2FAdd%20auto-translations.png?alt=media&amp;token=f3a42248-f303-44ce-b577-375f8579c34c">25_12_10_add_auto_translations.png</a></td><td></td></tr><tr><td><strong>インテグレーションをインストールする</strong></td><td>強力なインテグレーションでスタックと連携し、機能を拡張する</td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FitoGCSdPpGwPPCGwb29a%2FInstall%20integrations.png?alt=media&amp;token=6243ef56-d3f7-464f-8d8b-7ffee19f02a3">25_12_10_install_integrations_1.png</a></td><td><a href="broken://pages/71043d094c98fde9931838b59a16dca6fe6f0bfa">Broken link</a></td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F5bKkozsx0KN2mbeWaWMv%2FInstall%20integrations.png?alt=media&amp;token=8f25beb6-8844-486b-8afb-8ae50e9b7554">25_12_10_install_integrations.png</a></td><td></td><td></td><td></td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F5bKkozsx0KN2mbeWaWMv%2FInstall%20integrations.png?alt=media&amp;token=8f25beb6-8844-486b-8afb-8ae50e9b7554">25_12_10_install_integrations.png</a></td></tr><tr><td><strong>API リファレンスを追加する</strong></td><td>API 仕様から、自動更新されるインタラクティブな API リファレンスドキュメントを作成する</td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F2mbcS7cM3bp2Gi5XwWmf%2FAdd%20an%20API%20reference.png?alt=media&amp;token=fed30694-81df-4f0f-a061-9c869879fda1">25_12_10_add_an_api_reference_1.png</a></td><td><a href="broken://pages/8f82fb55bc9bc941e0e9f34aa206234409488ef3">Broken link</a></td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F5q9ieVfqWc6JewePmrTd%2FAdd%20an%20API%20reference.png?alt=media&amp;token=43439c73-f6bd-43f4-b7fa-6c9c03b3c969">25_12_10_add_an_api_reference.png</a></td><td></td><td></td><td></td><td></td></tr><tr><td><strong>ドキュメント分析を追跡する</strong></td><td>組み込みのインサイトを使って成果を測定し、ユーザーの行動を理解する</td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FSmrnppLSbEjgJXeblvHp%2FTrack%20docs%20analytics.png?alt=media&amp;token=09f31b10-1c10-48e1-a21c-bcc3d356b70d">25_12_10_track_docs_analytics_1.png</a></td><td><a href="/docs/documentation/ja-gitbook-documentation/fen-xi/insights.md">サイト分析</a></td><td><a href="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FbzbqcT1c5ndzkO12Eh6d%2FTrack%20docs%20analytics.png?alt=media&amp;token=23b06593-393f-4382-a97f-697009646263">25_12_10_track_docs_analytics.png</a></td><td></td><td></td><td></td><td></td></tr></tbody></table>


---

# 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/quickstart.md?ask=<question>&goal=<endgoal>
```

`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.
