> 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/rifarensu/concepts.md). # 基本概念
An illustration showing the block palette open in the GitBook editor. The window is floating on a pastel yellow and pink background
## コンテンツの整理 ### セクション セクションは、関連するページのセットに取り組めるようにするプロジェクトです。セクション内では、コンテンツを書いたり、ページグループやサブページでページを整理したり、連携をインストールしたり、その他さまざまなことができます。 セクションは docs site に属し、docs site には好きなだけセクションを追加できます。そのため、コンテンツを作成していくときに、製品ドキュメント、API リファレンス、変更履歴、ヘルプセンター、その他ドキュメントに含めたいものごとに個別のセクションを作成し、それらをすべて 1 つの docs site に公開できます。 主要なドキュメントの翻訳版や、製品の異なるバージョンごとの個別のドキュメントを作成することもできます。これらそれぞれにも独自のセクションがあり、1 つの docs site に追加してユーザーが閲覧できます。 #### グループ グループは GitBook アプリ内のフォルダのように機能し、関連するセクションをまとめて保持できるため、コンテンツの整理や保管がしやすくなります。 コンテンツを整理できるだけでなく、グループを使うとコンテンツ単位の権限管理も大規模に行いやすくなります。複数のセクションをグループに追加してグループ全体に権限を設定することで、組織レベルの権限を上書きできます。 ### docs site コンテンツを docs site として公開できます。ドキュメントは、独自のブランディング、分析、カスタムドメインでカスタマイズできる Web サイトとして公開され、選択した対象ユーザーが利用できます。 docs site は好きなだけ作成できます。これらはすべてサイドバーとアプリの「Docs sites」セクションに一覧表示され、そこで設定やカスタマイズオプションを変更できます。GitBook アプリで docs site のすべての設定とオプションを管理できます。 サイト上のコンテンツは各セクション内にあります。新しい docs site を作成するときは、新しいセクションを作成するか、既存のコンテンツを追加できます。docs site には 1 つのセクションだけでも、翻訳や以前の製品バージョンを含む複数の異なるコンテンツを持つ複数のセクションでも含められます。 ## コンテンツの編集 GitBook のビジュアルエディタでは、WYSIWYG（見たまま編集）インターフェースを使ってセクションにコンテンツを追加できます。 編集はデスクトップおよびラップトップ端末で利用できます。スマートフォンでは組織やコンテンツを閲覧できますが、編集にはデスクトップまたはラップトップが必要です。 ### ページ ページは、コンテンツを追加、編集、埋め込みする場所です。ページは常にセクション内にあり、セクションには好きなだけページを追加できます。 セクション内のページは、エディタ左側の目次に表示されます。ここで新しいページを追加したり、ページグループを作成したり、ページをほかのページの下に入れ子にしてサブページを作成したりできます。 {% hint style="info" %} #### ページの編集や追加方法がわかりませんか？ サイトが公開されている場合、セクションのコンテンツに変更を加える前に変更リクエストを作成する必要があります。 [変更リクエストについては以下をお読みください](#change-requests). {% endhint %} ### ブロック GitBook はブロックベースのエディタです。つまり、標準的なテキストや画像から、より高度でインタラクティブなブロックまで、さまざまな種類のブロックをページに追加できます。ページには好きな組み合わせのブロックを含められ、1 ページに置けるブロック数に制限はありません。 ブロックベースの編集では、ドラッグ＆ドロップでコンテンツを簡単に並べ替えたり、既存コンテンツの途中に新しいブロックを追加したりできます。エディタのインターフェースで新しいブロックを作成することも、Markdown を使ってブロックを作成・書式設定することもできます。 GitBook で使えるすべてのブロックを見つける [Blocks セクションで](/docs/documentation/ja-gitbook-documentation/kontentsuwosuru/blocks.md). #### Markdown の編集 GitBook のエディタでは、Markdown を使ってコンテンツブロックを作成し、書式設定できます。 Markdown はシンプルさで広く知られている、人気のマークアップ構文です。GitBook は、リッチで構造化されたテキストをキーボードだけで書ける方法として Markdown をサポートしています。GitBook のすべてのブロックは Markdown 構文で記述できます。 {% hint style="info" %} Markdown 自体について詳しく知るには、以下をご覧ください [CommonMark](https://commonmark.org/help/). {% endhint %} ### Git Sync Git Sync を使うと、チームは GitHub または GitLab のリポジトリを GitBook と同期し、Markdown ファイルを美しく使いやすいドキュメントに変換できます。設定すると、GitBook アプリとコードベースの間でコンテンツが常に同期されます。 Git Sync は双方向なので、GitBook のビジュアルエディタで行った変更も、GitHub や GitLab で行われたコミットも自動的に同期されます。これにより、開発者は GitHub または GitLab から直接コミットでき、他のチームメンバーは GitBook で変更を編集したりフィードバックを残したりできます。 Git Sync は、一括変更、リンティングなど、GitBook のドキュメント内で役立つほかの多くのワークフローも可能にします。詳しくは [Git Sync セクションをご覧ください](/docs/documentation/ja-gitbook-documentation/docs-as-code/git-sync.md). ## 編集の流れ ### 変更リクエスト 変更リクエストとは [**ブランチ**](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell) であり、バージョン履歴を維持しながら同時編集に使えるメインコンテンツの分岐です。GitHub のプルリクエストや GitLab のマージリクエストを使ったことがある人にはおなじみでしょう。 公開済みの docs site のコンテンツを編集したい場合は、まずセクションで変更リクエストを開く必要があります。 変更リクエストでは、セクション内のコンテンツを追加、編集、削除したうえで、チームにレビューを依頼し、変更をメインコンテンツにマージして公開済みの docs site を更新できます。 {% hint style="info" %} #### ブランチの概要 変更リクエストを開くと、その時点でのコンテンツのコピーが作成されます。これは「ブランチ」と呼ばれることもあります。変更リクエストをマージするまでは、加えた変更はメインコンテンツには表示されません。 ブランチの利点は、同時に他のメンバーも自分の変更リクエストを作成、編集、マージでき、お互いの作業を邪魔しないことです。もし誰かがあなたと同じコンテンツを編集した場合でも、GitBook がマージ前の競合解決を案内します。 {% endhint %} #### レビュー レビューは確認体制を促し、ドキュメントの品質と正確性の向上に役立ちます。 変更をマージして docs site に反映させる前に、変更リクエストにレビューを依頼できます。変更リクエストにタイトルと説明を追加すると、レビュー担当者に文脈が伝わりやすくなります。 レビュー担当者は変更リクエストの diff を確認でき、新規、変更、削除された内容がすべてハイライト表示されます。組み込みのコメント機能を使ってページ上で直接フィードバックを残し、変更リクエストを承認したり、さらに変更を求めたりできます。 #### マージ 変更リクエストをマージすると、その変更リクエスト内のすべてのコンテンツがメインブランチのコンテンツに追加され、変更は docs site にも公開されます。 変更リクエストをマージすると、セクションのバージョン履歴に新しいバージョンも作成されます。 ## ドキュメントの公開 コンテンツを [docs site](#docs-site)として公開すると、サイトにさらにコンテンツを追加したり、対象ユーザーを変更したり、見た目やその他の設定をカスタマイズしたりできます。 ### docs site の構成 サイトに追加のコンテンツを加えたい場合、用途の異なる 2 つの選択肢があります。セクションとバリアントです。 #### サイト構成内のセクション セクションを使うと **1 つの docs site に複数種類のドキュメントを追加できます**。たとえば、この docs site のように、1 つの docs site で製品ドキュメント、API リファレンス、ヘルプセンター、変更履歴をまとめて公開できます。 新しいセクションを追加すると、サイト上部のナビゲーションバーが構築され、各セクションにバー上の独自の項目が割り当てられます。セクションを [グループ](#collection) にまとめて、ナビゲーションバーにドロップダウンメニューを作成することもできます。サイトに階層を追加するのに最適です。 #### バリアント バリアントは、 **1 つの docs site に同じドキュメントの複数のバージョンを追加できるようにするためのものです**。たとえば、ドキュメント全体を複数の言語にローカライズしたい場合や、未更新のユーザー向けに以前の製品バージョンを文書化したい場合があります。 エンドユーザーは、サイト左側の目次上部にある言語ピッカーまたはバリアントピッカーを使って、これらのバリアントを切り替えられます。
A screenshot of the Roboflow Documentation site, with a navigation bar along the top and an open drop-down menu at the top of the table of contents showing different language variants for the site.

セクションはサイト上部にナビゲーションバーを作成し、ユーザーは目次内のメニューでバリアントを切り替えます。

### サイトの対象ユーザー 公開時に、ドキュメントを誰が閲覧できるかを選択できます。新しいサイトの既定値は、公開され、検索エンジンにインデックスされることです。 ただし、サイトにアクセスできる人をさらに細かく制御したい場合は、以下を使って対象ユーザーを制限できます **共有リンク** または **認証済みアクセス**. 共有リンクを使うと、プライベートリンクを作成して直接共有することで、組織に招待することなく顧客やパートナーとコンテンツを非公開で共有できます。リンクを持つ人は誰でもサイトにアクセスできます。 さらに厳密に管理したい場合は、認証済みアクセスを使うことで、閲覧時に認証を必要としつつコンテンツを公開できます。有効にすると、GitBook は認証プロバイダーにアクセス権の管理を任せます。これは、非公開コンテンツや、チームメンバーのみがアクセスできる社内ナレッジベースの公開に最適です。 適応型コンテンツという機能を使って、個々のページやブロックを誰に見せるかも制御できます。設定すると、あなたが決めたユーザー属性に基づいてコンテンツを表示または非表示にします。詳しくは [適応型コンテンツのページ](/docs/documentation/ja-gitbook-documentation/gong-kai/adaptive-content.md). ### サイトのカスタマイズ GitBook には docs site 向けの組み込みカスタマイズオプションがあり、ドキュメントの見た目や雰囲気を製品やブランドに合わせやすくなっています。 カスタマイズを一切適用しなくても、ドキュメントはそのままで十分に見栄えがします。しかし、ロゴ、アイコン、色をカスタマイズしたり、カスタムフォントを追加したり、製品同様にドキュメントを魅力的に見せる組み込みテーマを選んだりできます。
An illustration showing five docs sites hosted in GitBook, each with distinct visual customizations

独自のロゴ、色、フォント、画像などを使って、ドキュメントをブランドに合わせてカスタマイズできます。

### SEO と AI の最適化 GitBook で公開されたドキュメントは、検索（SEO）と、ChatGPT、Claude、Google AI Overview（GEO）などの AI システム向けに自動的に最適化されます。これらはバックエンドで処理されるため、必要なのはターゲットにしたいキーワードや用語を含めてコンテンツを書くことだけです。 ページは各ページのタイトルと説明からメタデータを取得し、コンテンツはレスポンシブになるよう整形されます。GitBook は目次に基づいてサイトマップを自動生成し、ページはキャッシュされ、グローバル CDN 経由で配信されてパフォーマンスが向上します。これらすべてが、ドキュメントの検索順位向上に役立ちます。 同様に、GitBook は急速に進化する業界標準に従って、AI ツール向けの最適化も行っています。 GitBook はすべてのページの .md 版を自動生成するため、大規模言語モデル（LLM）が解析しやすくなります。また、公開された各サイトに対して Model Context Protocol（MCP）サーバーも自動的に公開されるため、AI ツールはスクレイピングなしで、リソースとしてドキュメントを見つけて取得する構造化された方法を利用できます。さらに、サイトでは `llms.txt` 、 `llms-full.txt` AI に取り込まれるよう設計されています。 ## チーム管理 ### 組織 GitBook の組織には、1 つの会社に属するすべてのコンテンツと docs site が含まれます。1 つのアカウントで 1 つまたは複数の組織のメンバーになれ、サイドバー上部の組織メニューで切り替えられます。 ### メンバー メンバーは組織内の個々のユーザーです。組織には好きなだけメンバーを追加でき、それぞれに必要なアクセス権に応じた権限を設定できます。 #### 権限 権限を使うと、組織メンバーのアクセスレベルを決められます。メンバーが組織に参加すると、Editor や Viewer などのロールを割り当てます。これらのロールは、組織内のすべてのコンテンツに対する権限を定義します。ただし、コンテンツレベルでこれらの権限を上書きすることもできます。たとえば、 * Viewer ロールの人に、特定のコンテンツ 1 件への編集アクセスを付与できます * 特定の機密コンテンツや非公開コンテンツへのアクセスを制限し、組織内の特定メンバーのみにアクセスを許可できます。 詳しくは [権限と継承のページをご覧ください](/docs/documentation/ja-gitbook-documentation/gong-tong-zuo-ye/member-management/permissions-and-inheritance.md). --- # 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/rifarensu/concepts.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.