> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ja/sononotopikku/27-inserting-images.md). # 画像の挿入 ## Overleafで画像を挿入する4つの方法（LaTeXの図を作成する） オプションは次のとおりです: 1. 次の [**図を挿入** ボタン](https://learn.overleaf.com/learn/Kb/How_to_insert_figures_in_Overleaf#Using_Insert_Figure_to_add_a_figure_to_your_project)(![The Insert Figure button on the editor toolbar](/files/78c6fd0c89f8b2a19a1fa58c2b212ec64fabbd37)）、エディタのツールバー上にあるものを使って、図を挿入するために **ビジュアルエディタ** または **コードエディタ**. 2. [画像をコピーして貼り付ける](/latex/ja/narejjibsu/075-how-to-paste-formatted-content-into-overleaf.md#pasting-images-into-your-overleaf-project) に **ビジュアルエディタ** または **コードエディタ**. 3. ローカルのファイルシステム上のファイル、または Overleaf プロジェクトにアップロードしたファイルの1つを選び、それをドロップして図を作成できます **ビジュアルエディタ** または **コードエディタ**。Overleafは、図の設定をカスタマイズするためのオプションを含むウィンドウを表示します。 4. 使用 **コードエディタ** グラフィックを挿入して figure 環境内に配置する LaTeX コードを書きます。 オプション1、2、3は図を作成するのに必要なLaTeXコードを自動生成しますが、ここでは最も柔軟性の高いオプション4を取り上げます。 ## はじめに この記事では、最も一般的な形式の画像を含める方法、縮小・拡大・回転の方法、そして文書内で参照する方法を説明します。まずは、画像の取り込み方を示す例から始めます。 ```latex \documentclass{article} \usepackage{graphicx} \graphicspath{ {./images/} } \begin{document} 宇宙は広大で、 大規模に見ると、私たちがどこを見ても一様であるように見えます。 \includegraphics{universe} 上には銀河の画像があります \end{document} ``` ![画像挿入の例](/files/0c8d70d3477d0438746f31bb765196a004d561c3) Latex は画像を自力では扱えないので、次の `graphicx` パッケージを使用する必要があります。これを使うには、プリアンブルに次の行を含めます: `\usepackage{graphicx}`. コマンド `\graphicspath{ {./images/} }` は、画像が名前のフォルダに保存されていることを LaTeX に知らせます `images` メイン文書のディレクトリ内にあります。 その `\includegraphics{universe}` というコマンドが、実際に文書に画像を含めるものです。ここで `universe` は、拡張子を除いた画像ファイル名です。そのため `universe.PNG` になります `universe`。画像のファイル名には空白文字や複数のドットを含めないでください。 注: ファイル拡張子を含めることもできますが、省略するのがよいでしょう。拡張子を省略すると、LaTeX は対応しているすべての形式を検索するようになります。詳しくは、次の節を参照してください。 [高解像度画像と低解像度画像の生成](#generating-high-res-and-low-res-images). [Overleafで画像の例を開く](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) ## 画像へのフォルダパス 複数の画像を含む文書を作成するときは、それらの画像を1つまたは複数の別々のフォルダに保存して、プロジェクトをより整理された状態に保つことができます。 コマンド `\graphicspath{ {images/} }` LaTeX に `images` フォルダを探すよう指示します。パスは ***相対的*** です。つまり、コンパイラは画像が含まれているコードと同じフォルダ内のファイルを探します。初期ディレクトリが指定されていない場合、フォルダへのパスは既定で相対パスになります。たとえば ```latex %\includegraphics コマンドを含む .tex ファイルからの相対パス \graphicspath{ {images/} } ``` これは、ファイルツリー内のグラフィックスフォルダに到達する通常は簡単な方法ですが、 `.tex` フォルダ内のファイルがメイン `.tex` ファイルに含まれる場合には複雑さを招くことがあります。すると、コンパイラは画像フォルダを間違った場所で探してしまう可能性があります。したがって、 **グラフィックスパスはメイン `.tex` ファイル**、メイン `.tex` ファイルディレクトリを `./` 、たとえば次のように指定するのがよいでしょう: ```latex %メイン .tex ファイルからの相対パス \graphicspath{ {./images/} } ``` 導入部のように。 パスはまた ***絶対パス***にもできます。これは、システム上のファイルの正確な場所を指定する場合です。たとえば、自分のコンピュータ上のローカルな LaTeX インストールで作業している場合: ```latex %Windows 形式のパス: \graphicspath{ {c:/user/images/} } %Unix系（Linux、Mac OS）形式のパス \graphicspath{ {/home/user/images/} } ``` このコマンドには末尾のスラッシュが必要なことに注意してください `/` また、パスは二重の中かっこで囲まれています。 画像が1つ以上のフォルダに保存されている場合は、複数のパスを設定することもできます。たとえば、次の2つのフォルダがある場合 `images1` と `images2`、次のコマンドを使います ```latex \graphicspath{ {./images1/}{./images2/} } ``` [Overleafで画像の例を開く](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) ## 画像サイズの変更と画像の回転 LaTeX が文書内に画像をどのように含めるか（長さ、高さなど）をさらに指定したい場合は、次の形式でこれらの設定を渡せます: ```latex \begin{document} Overleaf はオンライン文書を編集するための優れた პროფესიონալツールで、 あなたの \LaTeX{} プロジェクトを共有し、バックアップできます。また、 かなり充実したヘルプ文書も提供しています。 \includegraphics[scale=1.5]{overleaf-logo} ``` ![画像サイズ変更の例](/files/bd30364e241cd10d6304c5638c065ca0ed5852b5) コマンド `\includegraphics[scale=1.5]{overleaf-logo}` は画像 `overleaf-logo` を文書に含めます。追加パラメータの `scale=1.5` がまさにそれを行い、画像を実際のサイズの1.5倍に拡大します。 画像を特定の幅と高さに拡大縮小することもできます。 ```latex \begin{document} Overleaf はオンライン文書を編集するための優れた პროფესიონալツールで、 あなたの \LaTeX{} プロジェクトを共有し、バックアップできます。また、 かなり充実したヘルプ文書も提供しています。 \includegraphics[width=5cm, height=4cm]{overleaf-logo} ``` ![画像の高さと幅を設定する例](/files/c9b26b9a4f810d207e997dc440a72eccce33a1ec) お気づきのとおり、角かっこ内のパラメータは `[width=3cm, height=4cm]` 画像の幅と高さを定義します。 [さまざまな単位](#reference-guide) をこれらのパラメータに使えます。もし *幅* パラメータだけが指定された場合、高さはアスペクト比を保つように調整されます。 長さの単位は文書内のいくつかの要素に対する相対値にもできます。たとえば、画像をテキストと同じ幅にしたい場合は: ```latex \begin{document} 宇宙は広大で、 大規模に見ると、私たちがどこを見ても一様であるように見えます。 \includegraphics[width=\textwidth]{universe} ``` ![テキスト幅に設定した画像の例](/files/24a478f5ce8aa55a2e41a34c3fd3af6a72518410) 〜の代わりに `\textwidth` 他の任意の LaTeX の既定長を使えます: `\columnsep`, `\linewidth`, `\textheight`, `\paperheight`、など。 [リファレンスガイド](#reference-guide) これらの単位のさらなる説明については、 文書に画像を含めるときのもう1つの一般的なオプションは、画像を回転させることです。これは LaTeX で簡単にできます: ```latex \begin{document} Overleaf はオンラインで編集するための優れたツールで、 あなたの \LaTeX{} プロジェクトを共有し、バックアップできます。また、 かなり充実したヘルプ文書が利用できます。 \includegraphics[scale=1.2, angle=45]{overleaf-logo} ``` ![画像を回転させる例](/files/3779d071e0bb1705afaab1942c795142316eb9cc) パラメータ `angle=45` は画像を反時計回りに45度回転させます。時計回りに回転させるには負の数を使います。 ## 配置 前の節では文書に画像を含める方法を説明しましたが、テキストと画像の組み合わせは期待どおりに見えない場合があります。これを変えるには、新しい *環境*. ```latex 次の例では、図は この文のすぐ下に配置されます。 \begin{figure}[h] \includegraphics[width=8cm]{Plot} \end{figure} ``` ![図の配置の例](/files/6060bfbffee6ced9d56cea4a62d8ef983ef6907c) その `図` この environment は、文書内で画像をフローティング要素として表示するために使われます。つまり、画像をその `図` environment の中に入れれば配置を気にする必要はなく、LaTeX が文書の流れに合うように配置してくれます。 それでも、図の表示方法をより細かく制御したいことがあります。図の配置を決めるために、追加のパラメータを渡せます。例では、 `\begin{figure}[h]`角かっこ内のパラメータが図の位置を ***こちら***に設定します。以下に、可能な配置値を一覧にした表を示します。 | パラメータ | 位置 | | ----- | ----------------------------------------------------------------------------------- | | h | フロートを配置します *こちら*、つまり *おおよそ* ソーステキストに現れるのと同じ位置に（ただし、 *正確に* その場所にではありません） | | t | ページの *上部* 。 | | b | ページの *下部* 。 | | p | 専用のものに置く *ページ* フロート専用のページへ。 | | ! | LaTeX が「良い」フロート位置を決めるために使う内部パラメータを上書きします。 | | H | LaTeX コード中の正確な位置にフロートを配置します。必要なのは `float` パッケージですが、時々問題を起こすことがあります。これは h! にやや相当します。 | 次の例では、画像が文書の `t`上部にあるのが見えます。テキストの下に宣言されているにもかかわらず。 ```latex この画像では、棒グラフが表示されています。 その調査の結果で、いくつかの重要な データが時間の経過とともに調査されたものです。 \begin{figure}[t] \includegraphics[width=8cm]{Plot} \centering \end{figure} ``` ![棒グラフの例](/files/01a7a33c95a94eb9eef39253fd84be2cfbc2eacc) 追加のコマンド `\centering` は画像を中央揃えします。既定の配置は *左*. ### 図の周囲にテキストを回り込ませる また、 **回り込ませる** ことで、図の周囲にテキストを配置できます。文書に小さな画像が含まれる場合、見栄えがよくなります。 ```latex \begin{wrapfigure}{r}{0.25\textwidth} %この図は右側に配置されます \centering \includegraphics[width=0.25\textwidth]{mesh} \end{wrapfigure} 2変数関数をプロットする方法はいくつかあります。 どの情報に関心があるかによって異なります。 たとえば、関数のメッシュを見て 導関数を見やすくしたい場合は、次のようなプロットを使えます 左のもの。 \begin{wrapfigure}{l}{0.25\textwidth} \centering \includegraphics[width=0.25\textwidth]{contour} \end{wrapfigure} 一方で、もし関心があるのが 特定の値だけなら、等高線プロットを使えます。 等高線プロットを使えます。あなたは等高線 プロットを使えます。あなたは等高線プロットを使えます。あなたは 等高線プロットを使えます。あなたは等高線プロットを使えます。 左のもののように等高線プロットを使えます。 一方で、もし関心があるのが 特定の値だけなら、等高線プロットを使えます。 等高線プロットを使えます。あなたは等高線 プロットを使えます。あなたは等高線プロットを使えます。あなたは 等高線プロットを使えます。あなたは等高線プロットを使えます。 等高線プロットを使えます。 左のもののように。 ``` ![プロットの例](/files/fe27dad26670b95b2496d3a9eb3076004c5bd48e) 例のコマンドを機能させるには、次のものをインポートする必要があります [`wrapfig` パッケージ](https://ctan.org/pkg/wrapfig?lang=en)。使用するには `wrapfig`、文書のプリアンブルに次の行を含めます: ```latex \usepackage{wrapfig} ``` これにより `wrapfigure` 環境が利用可能になり、 `\includegraphics` コマンドをその中に置いて、テキストが回り込む図を作成できます。次のように指定できます: *wrapfigure* 環境： ```latex \begin{wrapfigure}[lineheight]{position}{width} ... \end{wrapfigure} ``` その `位置` パラメータには8つの可能な値があります: | | | | | - | - | -------------------------- | | r | R | テキストの右側 | | l | L | テキストの左側 | | i | I | 内側の端—製本部に近い（ *twoside* 文書） | | o | O | 外側の端—製本部から遠い | 大文字版では図をフロートさせることができます。小文字版は *まさにここ*. これで `wrapfigure` 環境を次のコマンドで定義できます `\begin{wrapfigure}{l}{0.25\textwidth} \end{wrapfigure}`。この環境には中かっこで囲まれた追加パラメータが2つあることに注意してください。以下でコードをさらに詳しく説明します: **{l}** これは図の配置を定義します。左なら l、右なら r を設定します。さらに、書籍や同様の形式を使っている場合は、ページの外側の端には o、内側の端には i を使ってください。 **{0.25\textwidth}** これは図ボックスの幅です。画像そのものの幅ではなく、それは \includegraphics コマンドで設定する必要があります。長さはテキスト幅に対する相対値であることに注意してください。ただし、通常の単位（cm、in、mm など）も使えます。単位一覧はリファレンスガイドを参照してください。 **\centering** これはすでに説明しましたが、この例では画像は文書全体ではなく、コンテナを基準に中央揃えされます。 画像配置についてのより完全な記事は次を参照してください [画像と表の配置](/latex/ja/to/02-positioning-images-and-tables.md) [Overleafで画像の例を開く](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) ## キャプション付け、ラベル付け、参照 長い文書で作業するとき、画像に簡単な説明を付け、後で参照できるようにラベルを付けることは、2つの重要な手法です。 ### キャプション キャプションの例から始めましょう: ```latex \begin{figure}[h] \caption{媒介変数プロットの例 ($\sin (x), \cos(x), x$)} \centering \includegraphics[width=0.5\textwidth]{spiral} \end{figure} ``` ![媒介変数プロットの例](/files/eefd452fc64c28932e671083a4ee93435a6ac8d8) とても簡単です。次を追加するだけです `\caption{キャプション例}` そして中かっこ内に表示したいテキストを書きます。キャプションの配置はコマンドを置く場所によって決まります。もしそれが上にあるなら `\includegraphics` その場合、キャプションはその上に表示され、下ならキャプションも図の下に配置されます。 キャプションは図の直後に置くこともできます。 `sidecap` パッケージは、これを実現するために前の例と似たコードを使います。 ```latex \documentclass{article} \usepackage[rightcaption]{sidecap} \usepackage{graphicx} %画像を管理するためのパッケージ \graphicspath{ {images/} } \begin{SCfigure}[0.5][h] \caption{もう一度、宇宙の画像を使います。 このキャプションは右側に表示されます} \includegraphics[width=0.6\textwidth]{universe} \end{SCfigure} ``` ![キャプション付き媒介変数プロットの例](/files/231ba7d0692f33dd9329ccd665617fb61bca6e75) 新しいコマンドが2つあります **\usepackage\[rightcaption]{sidecap}** 予想どおり、この行は sidecap というパッケージを読み込みますが、追加パラメータとして rightcaption があります。このパラメータはキャプションを画像の右側に配置することを指定します。leftcaption も使えます。書籍風の文書では outercaption と innercaption も利用できます。これらの名前は説明的です。 **\begin{SCfigure}\[0.5]\[h] \end{SCfigure}** figure に似た環境を定義します。1つ目のパラメータは、\includegraphics で指定した画像サイズに対するキャプションの幅です。2つ目のパラメータ h は figure 環境の場合とまったく同じように働きます。詳しくは配置の節を参照してください。 キャプションの書式をより高度に管理することもできます。次の [さらに読む](#further-reading) の節を参照してください。 ### ラベルと相互参照 LaTeX 文書の他の多くの要素（数式、表、プロットなど）と同様に、図も本文中で参照できます。とても簡単で、次を追加するだけです `\label` に `図` または `SCfigure` 環境に追加し、あとでそのラベルを使って画像を参照します。 ```latex \begin{figure}[h] \centering \includegraphics[width=0.25\textwidth]{mesh} \caption{a nice plot} \label{fig:mesh1} \end{figure} 図 \ref{fig:mesh1} でわかるように、 関数は 0 付近で増加します。また、ページ \pageref{fig:mesh1} にも 同じ例があります。 ``` ![ラベル付き図の例](/files/56acd1a6c5fda38323866d94b96f96722843b931) この例では相互参照を生成するコマンドが3つあります。 **\label{fig:mesh1}** これにより、この図のラベルが設定されます。ラベルは文書内のさまざまな要素に使えるので、例のように fig: のような接頭辞を付けるのがよい習慣です。 **\ref{fig:mesh1}** このコマンドは、その図に割り当てられた番号を挿入します。これは自動生成され、参照対象の前に別の図を挿入すると更新されます。 **\pageref{fig:mesh1}** 参照された画像が現れるページ番号を出力します。 その `\caption` 図を参照するには必須です。 LaTeX 文書のもう1つの優れた特長は、 *図目次*を自動生成できることです。これは簡単です。 ```latex \listoffigures ``` ![図目次の例](/files/229a1be7e5e9e19d46f354d41ff386a7d9d838b6) このコマンドはキャプション付きの図にしか使えません。表のキャプションを使うためです。上の例ではこの記事の画像一覧を示しています。 重要: 相互参照を使う場合、LaTeX プロジェクトは2回コンパイルする必要があります。そうしないと、参照、ページ参照、図目次が機能しません—Overleaf がそれを処理してくれます。 ## 高解像度画像と低解像度画像の生成 ここまで、画像ファイル名を `\includegraphics` コマンドで指定する際にはファイル拡張子を省略してきました。しかし、それは必須ではなく、しばしば便利です。拡張子を省略すると、LaTeX はそのディレクトリ内で対応している画像形式を探し、既定の順序（変更可能）でさまざまな拡張子を検索します。 これは開発環境と本番環境を切り替えるときに便利です。開発環境（記事/レポート/本の作成がまだ進行中のとき）では、プレビューを素早くコンパイルするために低解像度の画像（通常は .png 形式）を使うのが望ましいです。本番環境（記事/レポート/本の最終版を作成するとき）では、画像の高解像度版を含めるのが望ましいです。 これは次のことで実現できます * コマンドでファイル拡張子を指定せず、 *\includegraphics* かつ * プリアンブルで希望する拡張子を指定すること。 したがって、画像に venndiagram.pdf（高解像度）と venndiagram.png（低解像度）の2つの版がある場合、レポート作成中に .png 版を使うためにプリアンブルに次の行を含められます - ```latex \DeclareGraphicsExtensions{.png,.pdf} ``` 上のコマンドは、同じベース名で拡張子の異なる2つのファイル（たとえば venndiagram.pdf と venndiagram.png）が見つかった場合、まず .png 版が使われ、存在しない場合は .pdf 版が使われることを保証します。低解像度版の一部が利用できない場合にも、これはよい方法です。 レポートの作成が終わったら、高解像度の .pdf 版を使うために、拡張子の検索順序を指定するプリアンブルの行を次のように変更できます ```latex \DeclareGraphicsExtensions{.pdf,.png} ``` 前の段落で説明した手法をさらに発展させて、まだ PNG に変換されていない PDF がある場合、文書をコンパイルしながら LaTeX に画像の低解像度 .png 版をその場で生成させることもできます。これを実現するには、次の内容をプリアンブルに追加し、その後に `\usepackage{graphicx}` ```latex \usepackage{epstopdf} \epstopdfDeclareGraphicsRule{.pdf}{png}{.png}{convert #1 \OutputFile} \DeclareGraphicsExtensions{.png,.pdf} ``` venndiagram2.pdf は存在するが venndiagram2.png が存在しない場合、venndiagram2-pdf-converted-to.png というファイルが作成され、それがその代わりに読み込まれます。コマンド *convert #1* が変換を担当し、追加パラメータを *convert* と *#1*の間に渡すことができます。たとえば - *convert -density 100 #1*. ただし、覚えておくべき重要な点がいくつかあります: * 自動変換を機能させるには、次を実行する必要があります *pdflatex* を `--shell-escape` オプション。 * 最終的な *本番* 版では、次をコメントアウトする必要があります `\epstopdfDeclareGraphicsRule`、そうすることで高解像度の PDF ファイルだけが読み込まれます。また、優先順も変更する必要があります。 [Overleafで画像の例を開く](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) ## リファレンスガイド **LaTeX の単位と長さ** | 略語 | 定義 | | ------------ | --------------------------- | | pt | ポイントは既定の長さの単位です。約 0.3515 mm | | mm | 1ミリメートル | | cm | 1センチメートル | | は | 1インチ | | ex | 〜の高さ **x** 現在のフォントで | | em | 〜の幅 **m** 現在のフォントで | | \columnsep | 列間の距離 | | \columnwidth | 列の幅 | | \linewidth | 現在の環境における行幅 | | \paperwidth | ページ幅 | | \paperheight | ページ高さ | | \textwidth | 本文幅 | | \textheight | 本文高さ | | \unitlength | 〜における長さの単位 *picture* 環境です。 | **LaTeX における画像形式について** **LaTeX** LaTeXでコンパイルする場合、使用できるのはEPS画像だけで、これはベクター形式です。 **pdflatex** PDFを生成するために「pdflatex」でコンパイルする場合、いくつかの画像形式を使用できます - ``` JPG: 写真を挿入したい場合に最適な選択肢 PNG: 図を挿入したい場合（ベクター版を生成できなかったとき）やスクリーンショットに最適な選択肢 PDF: 私たちはPDF文書を見ることに慣れていますが、PDFには画像も保存できます EPS: EPS画像はepstopdfパッケージを使って含めることができます（パッケージをインストールするだけでよく、 文書に含めるために \usepackage{} を使う必要はありません。） ``` **ベクター形式かビットマップ形式か？** 画像はベクター形式にもビットマップ形式にもなります。通常は気にする必要はありませんが、もし画像がどの形式であるか分かっているなら、その情報を使ってLaTeX文書に含める適切な画像形式を選ぶことができます。画像がベクター形式なら、PDFかEPSを選ぶべきです。ビットマップ形式なら、JPGかPNGを選ぶべきです。ビットマップ画像をPDFやEPSに保存すると、かなりのディスク容量を使うためです。 [Overleafで画像の例を開く](https://www.overleaf.com/project/new/template/19397?id=65443742\&templateName=Inserting+Images\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) ## 参考文献 詳しくは次を参照してください。 * [画像と表の配置](/latex/ja/to/02-positioning-images-and-tables.md) * [表目次と図目次](/latex/ja/to/03-lists-of-tables-and-figures.md) * [片面印刷と両面印刷の文書](/latex/ja/shu-shi-she-ding/08-single-sided-and-double-sided-documents.md) * [LaTeX における長さ](/latex/ja/shu-shi-she-ding/01-lengths-in-latex.md) * [**floatrow** 浮動要素（表と図）の高度なキャプション管理のためのパッケージ](http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf) * [**sidecap** サイド図のキャプション用のパッケージドキュメント](ftp://ctan.tug.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf) * [**epstopdf** パッケージドキュメント（EPSからPDFへの変換）](https://ctan.org/pkg/epstopdf?lang=en) --- # 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://overleaf-pro.ayaka.space/latex/ja/sononotopikku/27-inserting-images.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.