> 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 をセットアップし、数分で最初の docs サイトを公開する方法を説明します。 このガイドの最後には、拡張やカスタマイズの準備が整った、公開中のドキュメントサイトが完成しています。 {% stepper %} {% step %} **はじめに** 必要があります [アカウントを作成](https://app.gitbook.com/join) 最初のドキュメントサイトを始める前に。 アカウントを作成すると、編集やカスタマイズができる新しい docs サイトが自動的に表示されます。画面上のオプションから、公開前にサイトへコンテンツを追加する方法を選んでください。 {% hint style="success" %} コンテンツはまだ公開されていないため、公開前に docs サイトを編集、カスタマイズ、プレビューできます。すぐに公開するには **公開** をクリックしてください。 :arrow-down: [このページの「公開」セクションへ移動](#publish-your-documentation) {% endhint %} {% endstep %} {% step %} **コンテンツを編集する** GitBook でコンテンツを編集・更新する方法は 2 つあります。ビジュアルエディタを使う方法と、docs-as-code ワークフローに従う方法です。 **どちらか一方を選ぶことも、両方を組み合わせて使うこともできます**. どのワークフローを選んでも、コンテンツの編集には **ブランチベースの編集フロー**を使用します。詳しくは [Concepts ページ](/docs/documentation/ja-gitbook-documentation/rissu/concepts.md).
ビジュアルエディタを使う GitBook の WYSIWYG（見たまま編集）エディタでは、コンテンツを視覚的に編集したり、コンテンツブロックをドラッグして並べ替えたり、作業しながらコンテンツの見た目を確認したりできます。 このビジュアル編集ワークフローは、コードエディタで作業したくないユーザーや、Notion や Google ドキュメントのようなツールの使用経験があるユーザーに最適です。 **1. 変更リクエストで docs を編集する** まず、サイドバーで docs サイトを見つけ、その下にある項目をクリックします。すると、コンテンツが保存されているスペースに移動します。 右上の **編集** をクリックします。すると、スペースのコンテンツを編集できる変更リクエストが開きます。 右上の **新規追加…** を左側の目次でクリックしてページを追加し、タイトルを付けます。
A screenshot of the Editor in the GitBook app, zoomed in to show the menu that lets you add new pages, groups, links and more to a GitBook space.
**2. 変更をプレビューする** Web アプリの上部には、 **エディタ**, **変更** と **プレビュー**のタブがあります。これらでコンテンツの異なる表示を切り替えます。 右上の **プレビュー** 変更リクエスト内のすべての変更を反映した docs サイトの見た目を、デスクトップとモバイルの両方でライブプレビューできます。
A screenshot of the GitBook app with the Preview tab open, showing a docs site being previewed on a mobile-size display
**3. 変更をマージする** 変更内容に問題がなければ、 **マージ** ボタンを右上隅でクリックします。 これにより、変更リクエストで行ったすべての編集がコンテンツのメインバージョンに反映されます。コンテンツが公開中の docs サイトの一部である場合、サイトは直ちに更新されます。
コードベースの編集 ドキュメントを GitHub または GitLab リポジトリと同期すると、コードベースの編集を有効にできます。同期後は、既存の開発環境で docs を編集できます。 このワークフローは、ツールを切り替えたくなく、他のコードと一緒にドキュメントを管理したい技術系ユーザーに最適です。 **1. Git Sync を設定する** サイト作成時にまだ Git Sync を設定していない場合は、まずサイドバーで docs サイトを見つけ、その下にあるコンテンツ名をクリックします。すると、コンテンツが保存されているスペースに移動します。 右上の **Git Sync を設定** ボタンをクリックし、手順に従ってスペースを選択した Git リポジトリと同期します。 詳しくは [Git Sync ページ](/docs/documentation/ja-gitbook-documentation/getting-started/git-sync.md) をご覧ください。 **2. 開発環境から docs を編集する** スペースを Git リポジトリと同期すると、そのリポジトリから開発環境内で docs のコンテンツを更新できます。 リポジトリを開き、プルリクエストを作成して、必要な変更を行います。 {% hint style="info" %} #### Markdown 編集 GitBook は対応しています [Markdown 編集](/docs/documentation/ja-gitbook-documentation/creating-content/formatting/markdown.md)そのため、一般的な構文を使ってコンテンツを作成し、書式設定できます。 GitBook のすべての標準ブロックは、Markdown 構文を使って記述および書式設定できます。 {% endhint %} **3. 変更をプレビューする** GitHub または GitLab のプルリクエストから、公開済みの docs サイト上で [変更をプレビュー](/docs/documentation/ja-gitbook-documentation/getting-started/git-sync/github-pull-request-preview.md) できます。 プルリクエストでは、一意のプレビュー URL が付いたステータスが表示されます。 **詳細** をそのステータス上でクリックすると、プレビュー URL が開き、プルリクエストがマージされてサイトが更新されたときの見た目を確認できます。 **4. 変更をマージする** これで準備完了です。プルリクエストをマージすると、コンテンツは GitBook アプリと、公開中であれば docs サイトの両方で更新されます。 GitBook アプリでは、すべてのコミットとマージ済みプルリクエストが、バージョン履歴内の更新としてスペースに同期されます。
A screenshot of the GitBook app showing the version history side panel open. In the side panel the highlighted entry shows a pull request from GitHub that was merged as part of the history, with a link to view the pull request on GitHub.
{% endstep %} {% step %} **docs をカスタマイズする**
サイトナビゲーションを整理する API リファレンス、ヘルプセンター、変更履歴など、サイトにはいつでもさらにコンテンツを追加できます。コンテンツを追加したら、ユーザーが必要な情報を簡単に見つけられるように、サイトのナビゲーションバーを整理できます。 詳しくは [Concepts ページ](/docs/documentation/ja-gitbook-documentation/rissu/concepts.md) サイトナビゲーションについてご覧ください。 詳しくは [Site structure ページ](/docs/documentation/ja-gitbook-documentation/docs-site/site-structure.md) サイトへのコンテンツ追加について詳しく知るには。
A screenshot of a published docs site hosted on GitBook. The top of the site has a navigation bar, and the cursor is hovering over a drop-down in that bar, with a submenu open below it showing links to more pages
docs サイトの見た目をカスタマイズする docs サイトはそのままでも見栄えが良いですが、公開サイトの見た目を変える多くの設定をカスタマイズすることもできます。 サイトの [ロゴ、色、フォント](/docs/documentation/ja-gitbook-documentation/docs-site/customization/icons-colors-and-themes.md)をカスタマイズしたり、 [サイトセクション](/docs/documentation/ja-gitbook-documentation/docs-site/site-structure/site-sections.md) と [バリアント](/docs/documentation/ja-gitbook-documentation/docs-site/site-structure/variants.md)を使ってサイトのナビゲーションバーに追加したり、 [サイトの公開範囲](/docs/documentation/ja-gitbook-documentation/docs-site/site-settings.md#audience) 設定を更新したり、その他さまざまなことができます。
An illustration showing five docs sites hosted in GitBook, each with distinct visual customizations
{% endstep %} {% step %} **ドキュメントを公開する**
docs を公開する サイトはいつでもワンクリックで公開できます。 サイドバーでサイト名をクリックして、サイトのダッシュボードを開きます。次に **公開** を右上隅でクリックして公開します。 サイトが公開されると、ダッシュボードに公開中サイトへのリンクが表示されます。
A screenshot of the GitBook app showing a dashboard for a docs site. The dashboard shows the public URL, site status, site content, some top-level analytics for the site, and other options in tabs along the top of the screen.
{% hint style="success" %} 公開についてさらに詳しく知りたいですか？ [GitBook でコンテンツを作成して公開するための完全ガイド](/docs/guides/editing-and-publishing-documentation/complete-guide-to-publishing-docs-gitbook.md). {% endhint %}
カスタムドメインを追加する デフォルトでは、サイトは次の形式の一意の URL で公開されます。 ``` https://[organization-name].gitbook.io/[site-title] ``` これで十分なチームもありますが、多くのチームは URL を [カスタムドメイン](/docs/documentation/ja-gitbook-documentation/docs-site/custom-domain.md) または [カスタムサブディレクトリ](/docs/documentation/ja-gitbook-documentation/docs-site/custom-domain/setting-a-custom-subdirectory.md). に変更することを選びます。そのためには、サイドバーでサイト名をクリックしてサイトのダッシュボードを開き、次に **設定** タブを開いて、 **ドメインとURL**.
A screenshot of the GitBook app showing the menu that guides you through the process of setting up a custom domain for your docs site.
を選択します。画面上のボタンを使って希望するオプションを選び、手順に従ってドメインプロバイダーで DNS 設定を構成してください。 {% hint style="info" %} DNS の変更が反映されるまで最大 48 時間かかることがありますが、通常はそれよりずっと早く伝播します。 {% endhint %}
{% endstep %} {% endstepper %} ### 次のステップ
カバー画像カバー画像（ダーク）カバー画像（ダーク）カバー画像（ダーク）カバー画像（ダーク）カバー画像（ダーク）
チームを招待して共同作業するチームメンバーを組織に追加し、権限を設定する/files/b47c174e6fd51629c63b994d670dc1434cbe1ed9/pages/e7f961e40a9e3175310b21716bce866be03225d8/files/ec74e12270dc907ed3561bf1f6dd258230cf2295/files/ec74e12270dc907ed3561bf1f6dd258230cf2295
サイトの公開範囲を変更する共有リンクと認証アクセスで、コンテンツを閲覧できる人を制御する/files/fd2ba96fe1ee9324aed2a14f880a303eb4957ed3/pages/37f11f55f4220a1d169cd8ed543486c55684f5bf#publish-a-docs-site/files/13f092853675ff932305fdefdd5c6ffdb1d102ba/files/13f092853675ff932305fdefdd5c6ffdb1d102ba/files/13f092853675ff932305fdefdd5c6ffdb1d102ba
自動翻訳を追加するワンクリックで翻訳を作成し、自動的に更新する/files/09d1042fd33c37f17e235047a85ad7b8c7671b75/pages/7f67aba647e0d7c72577043b29a77711dcc60f8d/files/529f1497c699578448c29dcd23ba17f75cdafea2/files/529f1497c699578448c29dcd23ba17f75cdafea2
連携機能をインストールする利用中のスタックと連携し、強力なインテグレーションで機能を拡張する/files/255138c5edaa71173412fd5bd600264b2998a1b5/pages/71043d094c98fde9931838b59a16dca6fe6f0bfa/files/75c70a575719de716328beb648ac2ceabc6a6004/files/75c70a575719de716328beb648ac2ceabc6a6004
API リファレンスを追加するAPI 仕様から自動更新されるインタラクティブな API リファレンス docs を作成する/files/89d97c5c9558d8716806350dfdef57596e63b0d4/pages/8f82fb55bc9bc941e0e9f34aa206234409488ef3/files/2684564247529c54f4fac5dc8310b7e30f43fafa
docs の分析を追跡する組み込みのインサイトを使って成果を測定し、ユーザー行動を理解する/files/a86f47574b4d261c7a3b65a784a141e9316ca057/pages/fde014aaa6aebaaa1a909804747fce75f331d76d/files/51dfcc4c75ac91dd75332d7571efdf5fe387576a
### よくある質問
GitBook とは何ですか？ GitBook は、チームがブランド化された docs を Web サイトとして作成、レビュー、公開できる、コラボレーティブで AI ネイティブなドキュメントプラットフォームです。GitBook でホストされる docs サイトは、組み込みの AI Assistant を提供でき、MCP 経由で他の AI ツールにも接続できます。 高度なビジュアルエディタで Markdown を使ってコンテンツを編集したり、docs-as-code ワークフローのために docs を Git リポジトリと同期したり、あるいはその両方を組み合わせて使うこともできます。チームがどのように GitBook を使う場合でも、完全なバージョン履歴を備えた Git ライクなブランチワークフローを利用するため、チーム全体でのコラボレーションとフィードバックを促進しながら、メインのコンテンツを保護できます。
GitBook でドキュメントを公開するにはどうすればよいですか？ GitBook での公開は、コンテンツを公開できる状態になればシンプルなプロセスです。 1. 新しい docs サイトを作成するか既存のものを開き、公開したいコンテンツを選びます。 2. サイトの対象読者を選びます。 **公開** 設定で全員に公開することも、 **共有リンク** または **認証アクセス**. 3. で対象を制限することもできます。（任意）組み込みオプションを使って、ブランド、ドメイン、テーマをカスタマイズします。 4. 右上の **公開**これで完了です。docs が公開されました！後からさらにスペースをサイトセクションやバリアントとして追加できます。 詳しくは [クイックスタートガイド](#getting-started) をご覧いただくか、 [GitBook でドキュメントを作成して公開するための完全ガイド](/docs/guides/editing-and-publishing-documentation/complete-guide-to-publishing-docs-gitbook.md).
GitBook はオープンソースですか？ GitBook 自体はオープンソースではありません。ただし、docs サイト上でドキュメントをホストして表示するために使われる GitBook の公開 docs プラットフォームはオープンソースです。 [リポジトリを見る](https://github.com/GitbookIO/gitbook) と、コードを確認し、変更をレビュー用に提出できます。 GitBook 自体はオープンソースではありませんが、 **オープンソースプロジェクトは GitBook で無料でドキュメントを公開できます**。チームは [Community プラン](/docs/documentation/ja-gitbook-documentation/akaunto/plans/community.md) に登録し、 [Sponsored サイトプラン](/docs/documentation/ja-gitbook-documentation/akaunto/plans/community/sponsored-site-plan.md)を使ってコンテンツを公開できます。どちらも条件を満たすチームは無料です。
GitBook のサイトとスペースの違いは何ですか？ GitBook では、 **docs サイト** はドキュメント全体のハブであり、対象ユーザーがアクセスできるすべてのコンテンツをホストし、テーマやドメインなどのカスタマイズ可能なオプションを備えています。 各サイトには 1 つ以上の **スペース**が含まれます。これらはサイト内の個別セクションとして機能し、関連コンテンツを整理して、モジュール性と管理のしやすさを高めます。スペースを使うと特定のトピックにコラボレーションを集中でき、1 つのサイト上で複数のスペースを組み合わせて構造を作ったり、翻訳（ローカライズされたドキュメント向け）や複数製品対応のようなオプションを有効にしたりできます。
GitBook のビジュアルエディタと Git Sync の違いは何ですか？ GitBook では、ドキュメントを編集する主な方法が 2 つあります。ビジュアルエディタと Git Sync です。 **ビジュアルエディタ** は、高度なブロックベースのエディタで、Markdown サポートを含む従来型のユーザーインターフェースを使って GitBook 内で直接コンテンツを作成・変更できます。コードを直接扱わずに、より直感的で手を動かしやすい編集体験を好む人に最適です。 **Git Sync** は、ドキュメントのワークフローを Git リポジトリと統合し、「docs as code」アプローチを可能にします。このオプションは、慣れ親しんだ Git コマンドとワークフローを使って、コードベースと一緒にドキュメントを管理したい開発者やチームに最適です。 チームはこれらのワークフローのどちらか一方を選ぶことも、両方を組み合わせて使うこともできます。どの方法を選んでも、編集は完全なバージョン履歴とコンテンツレビューのプロセスを備えた、一貫した Git ライクなブランチワークフローに従います。これにより docs 全体でのコラボレーションと品質が向上するだけでなく、メインコンテンツを誤編集から保護できます。
--- # 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=&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.