> 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/rissu/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 サイトに属しており、docs サイトには好きなだけセクションを追加できます。そのため、コンテンツを作成していく際には、製品ドキュメント、API リファレンス、変更履歴、ヘルプセンターなど、含めたいものごとに個別のセクションを作成し、それらをすべて 1 つの docs サイトに公開できます。 主なドキュメントの翻訳版や、製品の異なるバージョンごとに別々のドキュメントを作成することもできます。それぞれに独自のセクションがあり、1 つの docs サイトに追加してユーザーが閲覧できるようにできます。 #### グループ グループは GitBook アプリ内のフォルダのように機能し、関連するセクションをまとめて、コンテンツの整理と保存をしやすくします。 コンテンツを整理しやすくするだけでなく、グループはコンテンツ単位の権限管理を大規模に行いやすくもします。複数のセクションをグループに追加し、グループ全体に権限を設定することで、組織レベルの権限を上書きできます。 ### docs サイト コンテンツを docs サイトとして公開できます。ドキュメントは公開され、選択した対象に対して、独自のブランディング、分析、カスタムドメインでカスタマイズできる Web サイトとして利用可能になります。 docs サイトはいくつでも作成できます。これらはすべてサイドバーとアプリの Docs sites セクションに一覧表示され、そこで設定やカスタマイズオプションを変更できます。GitBook アプリで docs サイトのすべての設定とオプションを管理できます。 サイト上のコンテンツは、そのセクション内に存在します。新しい docs サイトを作成すると、新しいセクションを作成するか、既存のコンテンツを追加できます。docs サイトには 1 つのセクション、または翻訳や以前の製品バージョンを含む複数のセクションを含めることができます。 ## コンテンツの編集 GitBook のビジュアルエディターでは、WYSIWYG（見たままがそのまま得られる）インターフェースを使って、セクションにコンテンツを追加できます。 ### ページ ページは、コンテンツを追加、編集、埋め込む場所です。ページは常にセクション内にあり、セクションには好きなだけページを追加できます。 セクション内のページは、エディター左側の目次に表示されます。ここで新しいページを追加したり、ページグループを作成したり、ページを他のページの下に入れてサブページを作成したりできます。 {% hint style="info" %} #### ページの編集や追加方法がわかりませんか？ サイトが公開されている場合、セクションのコンテンツに変更を加える前に、変更リクエストを作成する必要があります。 [変更リクエストについては以下をご覧ください](#change-requests). {% endhint %} ### ブロック GitBook はブロックベースのエディターです。つまり、標準的なテキストや画像から、より高度でインタラクティブなブロックまで、さまざまな種類のブロックをページに追加できます。ページには好きな組み合わせのブロックを含めることができ、1 ページに配置できるブロック数に制限はありません。 ブロックベースの編集では、ドラッグ＆ドロップでコンテンツを簡単に再整理したり、既存コンテンツの途中に新しいブロックを追加したりできます。エディターのインターフェースから新しいブロックを作成することも、Markdown を使ってブロックを作成・整形することもできます。 GitBook で使用できるすべてのブロックを確認する [ブロックセクションで](/docs/documentation/ja-gitbook-documentation/creating-content/blocks.md). #### Markdown 編集 GitBook のエディターでは、Markdown を使用してコンテンツブロックを作成・整形できます。 Markdown は、シンプルさで広く知られている人気のマークアップ構文です。GitBook は、キーボード中心でリッチかつ構造化されたテキストを書く方法としてこれをサポートしており、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/getting-started/git-sync.md). ## 編集フロー ### 変更リクエスト 変更リクエストは [**ブランチ**](https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell) です。メインコンテンツの別コピーとして、バージョン履歴を維持しながら同時編集に使えます。GitHub のプルリクエストや GitLab のマージリクエストを使ったことがある人には、なじみのある仕組みです。 公開済みの docs サイトのコンテンツを編集したい場合は、まずセクションで変更リクエストを開く必要があります。 変更リクエストでは、セクション内のコンテンツを追加、編集、削除したうえで、チームにレビューを依頼し、変更をメインコンテンツにマージして公開済み docs サイトを更新できます。 {% hint style="info" %} #### ブランチングの概要 変更リクエストを開くと、その時点のコンテンツのコピーが作成され、これは「ブランチ」と呼ばれることもあります。変更リクエストをマージするまで、加えた変更はメインコンテンツには表示されません。 ブランチングの利点は、同時に作業していても、チームメイトが互いに干渉することなく、自分の変更リクエストを作成、編集、マージできることです。また、誰かがあなたと同じコンテンツを編集していた場合でも、GitBook がマージ前に競合の解決を案内します。 {% endhint %} #### レビュー レビューは確認作業を促し、ドキュメントの品質と正確性の向上に役立ちます。 変更をマージして docs サイト上で公開する前に、変更リクエストに対してレビューを依頼できます。変更リクエストにタイトルと説明を追加すると、レビュアーに文脈を伝えられます。 レビュアーは変更リクエストの diff を確認でき、変更リクエスト内で新しく追加、変更、削除された内容がすべて強調表示されます。組み込みのコメント機能を使ってページ上で直接フィードバックを残し、変更リクエストを承認するか、追加の変更を求めることもできます。 #### マージ 変更リクエストをマージすると、その変更リクエスト内のすべてのコンテンツがメインブランチのコンテンツに追加され、その変更は docs サイト上にも反映されます。 変更リクエストをマージすると、セクションのバージョン履歴に新しいバージョンも作成されます。 ## ドキュメントの公開 コンテンツを [docs サイト](#docs-site)として公開すると、サイトにさらにコンテンツを追加したり、対象ユーザーを変更したり、見た目やその他の設定をカスタマイズしたりできます。 ### docs サイトの構成 サイトに追加コンテンツを入れたい場合、用途の異なる 2 つの方法があります。セクションとバリアントです。 #### サイト構成内のセクション セクションを使うと **1 つの docs サイトに複数の異なる種類のドキュメントを追加できます**。たとえば、この docs サイトのように、1 つの docs サイトを使って製品ドキュメント、API リファレンス、ヘルプセンター、変更履歴を公開できます。 新しいセクションを追加すると、サイト上部のナビゲーションバーが構築され、それぞれのセクションがバー上に独自の項目を持つようになります。また、セクションを [グループ](#collection) にまとめることで、ナビゲーションバーにドロップダウンメニューを作成することもできます。サイトに階層構造を加えるのに最適です。 #### バリアント バリアントは、 **同じドキュメントの複数のバージョンを 1 つの docs サイトに追加できるように設計されています**。たとえば、ドキュメント全体を複数の言語にローカライズしたり、未更新のユーザー向けに製品の以前のバージョンを文書化したりできます。 エンドユーザーは、サイト左側の目次上部にある言語ピッカーまたはバリアントピッカーを使って、docs サイト上でこれらのバリアントを切り替えられます。
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/saitohenoakusesu/adaptive-content.md). ### サイトのカスタマイズ GitBook には docs サイト向けの組み込みカスタマイズオプションがあり、ドキュメントの見た目を製品やブランドに合わせやすくなっています。 カスタマイズを適用しなくても、ドキュメントはそのままで十分見栄えよく表示されます。ただし、ロゴ、アイコン、色をカスタマイズしたり、カスタムフォントを追加したり、組み込みテーマから選んで製品に負けない見た目のドキュメントにすることもできます。
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 サイトが含まれます。1 つのアカウントで 1 つまたは複数の組織のメンバーになれ、サイドバー上部の組織メニューを使って切り替えられます。 ### メンバー メンバーは組織内の個々のユーザーです。組織には好きなだけメンバーを追加でき、それぞれに特定のアクセス要件に合った権限を設定できます。 #### 権限 権限を使うと、組織メンバーのアクセスレベルを決められます。メンバーが組織に参加すると、Editor や Viewer などの役割を割り当てます。これらの役割が、組織内のすべてのコンテンツに対する権限を定義します。ただし、コンテンツ単位でこれらの権限を上書きすることもできます。たとえば、 * Viewer ロールの人に、特定のコンテンツ 1 つだけ編集権限を与えることができます * 特定の機密コンテンツや非公開コンテンツへのアクセスを制限し、組織内の特定メンバーのみにアクセスを許可できます。 詳細はこちら [権限と継承のページをご覧ください](/docs/documentation/ja-gitbook-documentation/collaboration/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/rissu/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.