> 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 のセットアップ方法と、数分で最初のドキュメントサイトを公開する方法を説明します。

このガイドの最後まで進むと、公開中のドキュメントサイトができあがり、拡張やカスタマイズの準備が整います。

{% 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. その中で、 **コンテンツ** サイドバーのセクションで、Documentation などのセクションをクリックして開きます。
2. クリック **編集** 右上隅で。これにより変更リクエストが開き、セクションの内容を変更できます。
3. クリック **新規追加…** > **ページ** 左側の目次で。
4. 新しいページにタイトルを付けます。

**変更をプレビューする**

Web アプリの上部には、次のタブがあります： **エディタ**, **変更**、そして **プレビュー**。これらはコンテンツの異なる表示に切り替えます。クリック **プレビュー** して、変更リクエスト内のすべての変更を反映したドキュメントサイトが、デスクトップとモバイルの両方でどのように表示されるか確認します。

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

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

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

**Git Sync を設定する**

1. 同期したいセクションを **コンテンツ** サイドバーの部分から開きます。
2. Git Sync インジケーターの **セットアップ** ボタンをトップバーでクリックします。
3. 指示に従って、選択した Git リポジトリにセクションを同期します。詳しくは [Git Sync ページ](/docs/documentation/ja-gitbook-documentation/docs-as-code/git-sync.md) をご覧ください。

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

セクションを Git リポジトリに同期したら、次の手順に進みます：

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

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

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

**変更をプレビューする**

できます [変更をプレビューする](/docs/documentation/ja-gitbook-documentation/docs-as-code/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/gong-kai/custom-domain.md) または [カスタムサブディレクトリ](/docs/documentation/ja-gitbook-documentation/gong-kai/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="/files/cb5791a087f2a6e11b07c994372333c41e6b8c44">/files/cb5791a087f2a6e11b07c994372333c41e6b8c44</a></td><td><a href="/pages/e7f961e40a9e3175310b21716bce866be03225d8">/pages/e7f961e40a9e3175310b21716bce866be03225d8</a></td><td><a href="/files/2e71e1cc5b6994b715f760d095ade64f25418ed0">/files/2e71e1cc5b6994b715f760d095ade64f25418ed0</a></td><td><a href="/files/2e71e1cc5b6994b715f760d095ade64f25418ed0">/files/2e71e1cc5b6994b715f760d095ade64f25418ed0</a></td><td></td><td></td><td></td></tr><tr><td><strong>サイトの公開範囲を変更する</strong></td><td>共有リンクと認証済みアクセスで、コンテンツを閲覧できるユーザーを管理する</td><td><a href="/files/f14471e36fb2f6dc7eb3a8bd78480914fcbaef9c">/files/f14471e36fb2f6dc7eb3a8bd78480914fcbaef9c</a></td><td><a href="/pages/37f11f55f4220a1d169cd8ed543486c55684f5bf#publish-a-docs-site">/pages/37f11f55f4220a1d169cd8ed543486c55684f5bf#publish-a-docs-site</a></td><td><a href="/files/d50e6a5022c3c2a2022969ad3cb882d8c2a6e5cf">/files/d50e6a5022c3c2a2022969ad3cb882d8c2a6e5cf</a></td><td></td><td><a href="/files/d50e6a5022c3c2a2022969ad3cb882d8c2a6e5cf">/files/d50e6a5022c3c2a2022969ad3cb882d8c2a6e5cf</a></td><td><a href="/files/d50e6a5022c3c2a2022969ad3cb882d8c2a6e5cf">/files/d50e6a5022c3c2a2022969ad3cb882d8c2a6e5cf</a></td><td></td></tr><tr><td><strong>自動翻訳を追加する</strong></td><td>ワンクリックで翻訳を作成し、自動的に更新する</td><td><a href="/files/6e236cdd87116721aee0cc9b8970443b47a000c7">/files/6e236cdd87116721aee0cc9b8970443b47a000c7</a></td><td><a href="/pages/7f67aba647e0d7c72577043b29a77711dcc60f8d">/pages/7f67aba647e0d7c72577043b29a77711dcc60f8d</a></td><td><a href="/files/d1cfdafa4a1bb035bf79c9a3e8dcd8ea58f5f7f9">/files/d1cfdafa4a1bb035bf79c9a3e8dcd8ea58f5f7f9</a></td><td></td><td></td><td><a href="/files/d1cfdafa4a1bb035bf79c9a3e8dcd8ea58f5f7f9">/files/d1cfdafa4a1bb035bf79c9a3e8dcd8ea58f5f7f9</a></td><td></td></tr><tr><td><strong>連携をインストールする</strong></td><td>スタックと統合し、強力な連携で機能を拡張する</td><td><a href="/files/821690e8431f025bbd473628ea280556e3423a91">/files/821690e8431f025bbd473628ea280556e3423a91</a></td><td><a href="/pages/71043d094c98fde9931838b59a16dca6fe6f0bfa">/pages/71043d094c98fde9931838b59a16dca6fe6f0bfa</a></td><td><a href="/files/e39fa21a3652c0566b4e004e84b914a25e7bc11a">/files/e39fa21a3652c0566b4e004e84b914a25e7bc11a</a></td><td></td><td></td><td></td><td><a href="/files/e39fa21a3652c0566b4e004e84b914a25e7bc11a">/files/e39fa21a3652c0566b4e004e84b914a25e7bc11a</a></td></tr><tr><td><strong>API リファレンスを追加する</strong></td><td>API 仕様から、自動更新される対話型 API リファレンスドキュメントを作成する</td><td><a href="/files/0f733daecd3b589c439348fd8b475d24845a1cdd">/files/0f733daecd3b589c439348fd8b475d24845a1cdd</a></td><td><a href="/pages/8f82fb55bc9bc941e0e9f34aa206234409488ef3">/pages/8f82fb55bc9bc941e0e9f34aa206234409488ef3</a></td><td><a href="/files/cbfec1593f6f549c69c35a102dc3db4682fc5bf7">/files/cbfec1593f6f549c69c35a102dc3db4682fc5bf7</a></td><td></td><td></td><td></td><td></td></tr><tr><td><strong>ドキュメント分析を追跡する</strong></td><td>組み込みのインサイトを使って成功を測定し、ユーザー行動を把握する</td><td><a href="/files/3c7cf30330567853bce430e7d1aa9ce86877a5e0">/files/3c7cf30330567853bce430e7d1aa9ce86877a5e0</a></td><td><a href="/pages/fde014aaa6aebaaa1a909804747fce75f331d76d">/pages/fde014aaa6aebaaa1a909804747fce75f331d76d</a></td><td><a href="/files/8e26a73a9810ce610524cdf3f095636b731aad92">/files/8e26a73a9810ce610524cdf3f095636b731aad92</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.