> 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>ドキュメントテンプレート</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. クリックして **ドキュメントテンプレート** そしてプレビューを確認します。
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 ドキュメントのようなツールに慣れている場合に最適です。

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

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

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

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

**変更をマージ**

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

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

**Git 同期を設定**

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/kontentsuwosuru/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/b47c174e6fd51629c63b994d670dc1434cbe1ed9">/files/b47c174e6fd51629c63b994d670dc1434cbe1ed9</a></td><td><a href="/pages/e7f961e40a9e3175310b21716bce866be03225d8">/pages/e7f961e40a9e3175310b21716bce866be03225d8</a></td><td><a href="/files/ec74e12270dc907ed3561bf1f6dd258230cf2295">/files/ec74e12270dc907ed3561bf1f6dd258230cf2295</a></td><td><a href="/files/ec74e12270dc907ed3561bf1f6dd258230cf2295">/files/ec74e12270dc907ed3561bf1f6dd258230cf2295</a></td><td></td><td></td><td></td></tr><tr><td><strong>サイトの公開範囲を変更する</strong></td><td>共有リンクと認証済みアクセスで、コンテンツを閲覧できるユーザーを管理する</td><td><a href="/files/fd2ba96fe1ee9324aed2a14f880a303eb4957ed3">/files/fd2ba96fe1ee9324aed2a14f880a303eb4957ed3</a></td><td><a href="/pages/37f11f55f4220a1d169cd8ed543486c55684f5bf#publish-a-docs-site">/pages/37f11f55f4220a1d169cd8ed543486c55684f5bf#publish-a-docs-site</a></td><td><a href="/files/13f092853675ff932305fdefdd5c6ffdb1d102ba">/files/13f092853675ff932305fdefdd5c6ffdb1d102ba</a></td><td></td><td><a href="/files/13f092853675ff932305fdefdd5c6ffdb1d102ba">/files/13f092853675ff932305fdefdd5c6ffdb1d102ba</a></td><td><a href="/files/13f092853675ff932305fdefdd5c6ffdb1d102ba">/files/13f092853675ff932305fdefdd5c6ffdb1d102ba</a></td><td></td></tr><tr><td><strong>自動翻訳を追加する</strong></td><td>自動で更新されるワンクリック翻訳を作成する</td><td><a href="/files/09d1042fd33c37f17e235047a85ad7b8c7671b75">/files/09d1042fd33c37f17e235047a85ad7b8c7671b75</a></td><td><a href="/pages/7f67aba647e0d7c72577043b29a77711dcc60f8d">/pages/7f67aba647e0d7c72577043b29a77711dcc60f8d</a></td><td><a href="/files/529f1497c699578448c29dcd23ba17f75cdafea2">/files/529f1497c699578448c29dcd23ba17f75cdafea2</a></td><td></td><td></td><td><a href="/files/529f1497c699578448c29dcd23ba17f75cdafea2">/files/529f1497c699578448c29dcd23ba17f75cdafea2</a></td><td></td></tr><tr><td><strong>インテグレーションをインストールする</strong></td><td>スタックと統合し、強力なインテグレーションで機能を拡張する</td><td><a href="/files/255138c5edaa71173412fd5bd600264b2998a1b5">/files/255138c5edaa71173412fd5bd600264b2998a1b5</a></td><td><a href="/pages/71043d094c98fde9931838b59a16dca6fe6f0bfa">/pages/71043d094c98fde9931838b59a16dca6fe6f0bfa</a></td><td><a href="/files/75c70a575719de716328beb648ac2ceabc6a6004">/files/75c70a575719de716328beb648ac2ceabc6a6004</a></td><td></td><td></td><td></td><td><a href="/files/75c70a575719de716328beb648ac2ceabc6a6004">/files/75c70a575719de716328beb648ac2ceabc6a6004</a></td></tr><tr><td><strong>API リファレンスを追加する</strong></td><td>API 仕様から、自動更新される対話型 API リファレンスドキュメントを作成する</td><td><a href="/files/89d97c5c9558d8716806350dfdef57596e63b0d4">/files/89d97c5c9558d8716806350dfdef57596e63b0d4</a></td><td><a href="/pages/8f82fb55bc9bc941e0e9f34aa206234409488ef3">/pages/8f82fb55bc9bc941e0e9f34aa206234409488ef3</a></td><td><a href="/files/2684564247529c54f4fac5dc8310b7e30f43fafa">/files/2684564247529c54f4fac5dc8310b7e30f43fafa</a></td><td></td><td></td><td></td><td></td></tr><tr><td><strong>ドキュメント分析を追跡する</strong></td><td>組み込みのインサイトを使って成果を測定し、ユーザー行動を把握する</td><td><a href="/files/a86f47574b4d261c7a3b65a784a141e9316ca057">/files/a86f47574b4d261c7a3b65a784a141e9316ca057</a></td><td><a href="/pages/fde014aaa6aebaaa1a909804747fce75f331d76d">/pages/fde014aaa6aebaaa1a909804747fce75f331d76d</a></td><td><a href="/files/51dfcc4c75ac91dd75332d7571efdf5fe387576a">/files/51dfcc4c75ac91dd75332d7571efdf5fe387576a</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.