> 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/narejjibsu/038-fixing-and-preventing-compile-timeouts.md).

# コンパイルタイムアウトの修正と予防

をクリックすると **再コンパイル** Overleaf プロジェクト内のボタンをクリックすると、プロジェクトのファイルを読み込み、それらを組版済み PDF に変換する処理が始まります。コンパイルタイムアウトエラーが発生した場合、それはコンパイル処理が次の [Overleaf プランのタイムアウト上限](/latex/ja/narejjibsu/119-overleaf-plan-limits.md).

いくつかのプロジェクトは大きすぎたり複雑すぎたりして、与えられた時間内に PDF を生成できないこともありますが、コンパイルタイムアウトは多くの場合、修正または防止できます。

## コンパイルタイムアウトを解決する手順

コンパイルタイムアウトの原因となる一般的な問題を特定して修正するには、次の手順に従ってください。

1. [コンパイルエラーを確認し、次を使って修正します **最初のエラーで停止** mode](#first-errors)
2. [試してみてください **Fast\[draft\]** モードでコンパイルし、画像サイズを最適化します](#second-images)
3. [時間のかかる処理がないかプロジェクトを確認します](#third-assess)

これらの手順に従うことに加えて、次の状況で何をすべきかについての提案も確認してください [特定のタイムアウト状況](#anchor-advice) また、何を [ベストプラクティス](#anchor-best) コンパイルタイムアウトを防ぐために従うべきか。

多くのプロジェクトは Overleaf の無料プランで提供される時間内にコンパイルできますが、大規模または複雑な文書を準備している場合は、 [有料プランに登録する](https://www.overleaf.com/user/subscription/plans) より多くのコンパイル時間を確保する必要があるかもしれません。

## ステップ 1: コンパイルエラーを確認して修正する

いくつかのコンパイルエラー、または複数のエラーの蓄積によって、次を完全に妨げることがあります [latexmk のビルド処理](https://learn.overleaf.com/learn/Kb/How_does_Overleaf_compile_my_project%3F) その結果、コンパイルタイムアウトにつながることがあります。エラーを見つけて修正するには、次を有効にしてください **最初のエラーで停止** 次の下にあるコンパイルモード **再コンパイル** ドロップダウンメニュー:

![「最初のエラーで停止」コンパイルモードを有効にする方法を示すスクリーンショット](/files/6258298cc419edce95ca33cebafad74afd08c014)

この [**最初のエラーで停止**](/latex/ja/narejjibsu/149-using-the-stop-on-first-error-compilation-mode.md) コンパイルモードは、まさに想像どおりの動作をします。エラーが発生するとただちにコンパイルを停止します。この場合、PDF は生成されず、エラーを説明するメッセージが表示されます。を有効にすると **最初のエラーで停止** プロジェクトがエラーなしになるまで、各エラーを見つけて修正できます。

各エラーメッセージをクリックすると、問題の原因となっているソースコードの行に移動できるので、コードを修正できます。いくつかの一般的なエラーは次で説明されています [このページ](/latex/ja/latexno/05-errors.md)、また一部の LaTeX デバッグのヒントは次に一覧されています [このページ](/latex/ja/to-2/81-tips-and-tricks-for-troubleshooting-latex.md)。また、次の [この記事のセクション](#anchor-fatal) には、いくつかの一般的な **致命的なコンパイルエラー** があり、これらがコンパイルタイムアウトの原因になります。

## ステップ 2: Fast \[draft] モードでコンパイルしてみる

プロジェクトに多数の画像ファイルや大きな画像ファイルを含めると、コンパイルに必要な時間が大幅に増えることがあります。

画像処理がタイムアウトの原因かどうかを見極めるのに役立つ方法の1つは、次でコンパイルしてみることです **高速 \[下書き]** モードです。そのためには、次を選択します **高速 \[下書き]** 次のオプションを **Recompile メニュー**。これにより、すべてのグラフィックがボックスに置き換わり、PDF のコンパイルがずっと速くなります:

![Overleaf プロジェクトでドラフトコンパイルモードを設定する](/files/4e0d830b2992815e4171af3c647af9503a251146)

文書が次のモードではコンパイルできても **高速 \[下書き]** モードではコンパイルが完了しない場合、 **通常** 原因は大きな画像ファイルや多数の画像ファイルかもしれません。

### 画像ファイルの最適化

複数の大きな高解像度 PNG または JPEG ファイルを使用している場合、それらの処理によってプロジェクトのコンパイル時間が増加し、場合によってはかなり長くなることがあります。必ず次を行ってください:

* 図やグラフには PNG ではなく PDF ファイルを使用してください。
* JPEG は写真に限定して使用してください。

追加のアドバイスについては、次を参照してください: [大きな画像ファイルの最適化](/latex/ja/narejjibsu/113-optimising-very-large-image-files.md).

## ステップ 3: 時間のかかる処理と致命的エラーの観点からプロジェクトを評価する

もし両方の **最初のエラーで停止** や **Fast\[draft]** コンパイルモードでもまだコンパイルタイムアウトが発生する場合は、原因をさらに詳しく調べて特定し、（できれば）対処する必要があります。

1\. [コンパイルを遅くする、時間のかかる手法やパッケージの一覧を確認する](#anchor-slow)

2\. [タイムアウトにつながる可能性のある一般的な致命的エラーの一覧を確認する](#anchor-fatal)

3\. [自分の状況に最も当てはまる特定のタイムアウト状況に関するアドバイスを確認する](#anchor-advice)

### 時間のかかる手法とパッケージ

一部の手法やパッケージは、コンパイルを非常に遅くし、タイムアウトにさえつながることがあります。

**複雑な TikZ や pgfplots の図を含める**

`TikZ` や [`pgfplots`](https://ctan.org/pkg/pgfplots?lang=en) 優れた図を生成しますが、 [コンパイルに長い時間がかかることがあります](https://tex.stackexchange.com/a/254946/226)。次のような方法があります [TikZ の図を外部化する方法がいくつかあります](/latex/ja/to-2/60-i-have-a-lot-of-tikz-matlab2tikz-or-pgfplots-figures-so-i-m-getting-a-compilation-timeout.-can-i.md) こうすることで、LaTeX が新しい PDF を作成するたびにそれらを毎回描き直す必要がなくなります。

**mhchem パッケージの使用**

最近の [`mhchem` パッケージ](https://ctan.org/pkg/mhchem?lang=en) はコンパイルに時間がかかることがあります。用途によっては、 [`chemformula` パッケージ](https://ctan.org/pkg/chemformula) を使うことでコンパイルに必要な時間を短縮できるかもしれません。すでに `mhchem`を使っている場合は、差し替えとして `chemformula` を試すことができます:

```latex
% \usepackage{mhchem}
\usepackage{chemformula}
\let\ce\ch
```

* **注**：構文と機能に違いがあります `mhchem` や `chemformula`。そのため、常にうまく動作するとは限りません。例えば、 `\ce{2H2O}` は次で問題なく表示されます `mhchem`が、次では `chemformula` これを次のように書く必要があります `\ch{2 H2O}` 先頭の後にスペースを入れて `2`.

**トレースまたはデバッグ呼び出しを含める**

もし `\tracingall` コマンドが文書にある場合、大量の *大量の* データを次へ書き出している可能性があります `.log`。 `\tracingall` 記録および処理する `.log` データが `\tracingall` ファイル内にあると、コンパイルが非常に遅くなることがあります。次の呼び出しは削除することをお勧めします [`トレース` パッケージ](http://ctan.org/pkg/trace) を代わりに使います。

**acro パッケージの使用**

次を使っているユーザーは [`acro` パッケージ](https://www.ctan.org/pkg/acro) 必要があるなら [バージョン 3 は遅いと報告しています](https://github.com/cgnieder/acro/issues/205) 略語定義の読み込みに時間がかかるということです。 `acro`のコンパイル時間が増えることで、コンパイルタイムアウトが発生する可能性があります。幸いなことに、回避策があります。それは、次のバージョン 2 を使用することです `acro` xr

バージョン 3 からバージョン 2 に戻すには、プロジェクトを編集して、バージョン 2 のオプション、機能、コマンドと互換性があることを確認する必要があるかもしれません。バージョン 2 のドキュメントは、次のように取得できる以前のソースコードリリース内に含まれています [GitHubからダウンロードできます](https://github.com/cgnieder/acro/releases/tag/v2.10).

バージョン 2 に戻す際に確認すべき項目をいくつか挙げます。この一覧は網羅的ではありません:

1. プロジェクトのメインの `.tex` を次のように変更します:
   * 変更します `\usepackage{acro}` から `\usepackage{acro}[=v2]`
   * 次の `include=...` オプションキーを `\printacronyms` から `include-classes=...`
2. 任意の `\DeclareAcronym` コマンド内で、次の `tag=...` オプションキーを次のように変更します `class=...`.

次を参照してください [`acro` バージョン 2.10 のドキュメント](https://github.com/cgnieder/acro/releases/tag/v2.10) で、バージョン 2 では使えてバージョン 3 では使えないコマンドとオプションを確認してください。

**EPS または SVG 画像の使用**

EPS または SVG 画像を使用すると、PDF 形式に変換するための追加処理が必要になることがあります。この追加処理により、プロジェクトのコンパイルに必要な時間が増えます。

* 一方で **latex** コンパイラは EPS 画像を直接サポートしますが、 **pdfLaTeX** コンパイラは EPS 画像をサポートしていないため、そのコンパイラを使用する場合は、これらを PDF 画像に変換する追加手順が必要です。この処理は次のパッケージによって行われます `epstopdf` パッケージが次を使用して `Ghostscript` EPS ファイルを PDF に変換します。この変換ステップにより、プロジェクトのコンパイルに必要な時間が大幅に増えることがあります。
* SVG 画像ファイルはどの LaTeX コンパイラでも直接サポートされておらず、次のものの使用が必要です `svg` パッケージおよび `\includesvg` コマンドが提供するものです。 `svg` パッケージは `inkscape` を使って SVG 画像を PDF に変換します。この変換ステップにより、プロジェクトのコンパイルに必要な時間が大幅に増えることがあります。

コンパイルタイムアウトを避けるのに役立つ、より速い結果を得るには、EPS や SVG 形式ではなく画像の PDF 版を使用してください。

**tabularray パッケージの使用**

この `tabularray` パッケージは、LaTeX で表を作成するための標準コマンドや環境の代替手段を提供します。残念ながら、 `tabularray` パッケージは非常に遅く、特に大きな表や特定の列タイプを使う表では顕著です。現在は、コンパイル時間の観点から、標準的な表の定義方法が次より推奨されます `tabularray` コンパイル時間を考慮して。

**コマンド内で無限ループを作成する**

コンパイル中に、LaTeX コマンドがごくまれに「無限ループ」を引き起こすことがあります。無限ループは通常、パッケージやユーザー定義コマンドのバグが原因です。

ループが発生している疑いがある場合は、誤って次を作成していないか確認してください [再帰的な](https://en.wikipedia.org/wiki/Recursion) カスタムコマンドのいずれかにある定義。例えば `\newcommand{\foo}{\foo}`.

### 致命的なコンパイルエラーの原因の例

以下は、既知の致命的エラーの原因です。

**重要なタイトル指定コマンドに空行を含める**

LaTeX クラスやジャーナルテンプレートでは、文書タイトルの一部を指定するための特別なコマンドが用意されていることがよくあります。これらのコマンドは通常、単純な引数を指定するためのもので、予期しない使い方をするとコンパイルエラーやタイムアウトにつながることがあります。特に、次のようなコマンド `\author{...}`, `\date{...}` や `\title{...}` には空行を含めるべきではありません。

**固定配置のフロートを多く含めすぎる**

次の指定を使う表や図が多すぎる場合 `[H]` の配置指定子を `float` パッケージから使っている場合、それらすべてに適した配置場所を見つけようとして LaTeX が無限ループに陥ることがあります。すべての `[H]` と `[hbt!]` を必要に応じて置き換え、さらに場合によっては時々 `\clearpage` を使って、改ページを入れる前にキュー内のすべての表と図を出し切ってください。

**\caption コマンドおよび tabular 環境のエラー**

表に関する注意点を以下に示します。一般に、表を組むときは注意してください!

* `\caption{...}` は常に配置すべきです *数式モードの* その `tabular` 環境内に。というのも、次のときに致命的なエラーを引き起こす可能性があるためです [`caption` パッケージ](https://ctan.org/pkg/caption) が読み込まれている場合。次の例で示します:

  ```latex
  \documentclass{article}
  \usepackage{caption}
  \begin{document}

  \begin{table}
      \begin{tabular}{c|c}
          \caption{Caption}% \caption{...} は tabular 環境の外に置く必要があります
          a & b \\
          c & d \\
      \end{tabular}
  \\end{table}
  \end{document}
  ```

  [この例を開く **これにより Overleaf のタイムアウトエラーが発生します**](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Overleaf+timeout+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bcaption%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cbegin%7Btable%7D%0A++++%5Cbegin%7Btabular%7D%7Bc%7Cc%7D%0A++++++++%5Ccaption%7BCaption%7D%25+%5Ccaption%7B...%7D+should+be+OUTSIDE+the+tabular+environment%0A++++++++a+%26+b+%5C%5C%0A++++++++c+%26+d+%5C%5C%0A++++%5Cend%7Btabular%7D%0A%5Cend%7Btable%7D%0A%5Cend%7Bdocument)
* 一方で、次の点に注意してください `longtable` 環境 *は* 必要があります `\caption{...}` その中で。これは、当社の次の例で示されています [表のヘルプ記事](/latex/ja/to/01-tables.md#multi-page-tables).
* `\caption{...}` 含めるべきではありません `\\`, `\newline`, `\centering`, `\raggedright` など
* 一部のテンプレートやパッケージでは、 `\ref{...}` または `\cite{...}` 次の中で `\caption` の前に次を付ける必要があります `\protect` 致命的なエラーを避けるためです。例えば、 `\protect\cite{...}`.
* 不完全なものを確認してください `\cmidrule{...}` の内部で `tabular` 環境を確認してください。これには列の範囲が必要なため、次のように書く必要があります `\cmidrule{3-3}` 単に次のように書くのではなく `\cmidrule{3}` 1 列だけにまたがる横罫線を引きたい場合。
* 入れ子の `tabular` 環境は避けてください。次を参照してください [`makecell` パッケージ](https://ctan.org/pkg/makecell?lang=en) 表のセル内で手動改行を入れたい場合は、または次の `p{...}` 列型、および/または [`tabularx`](https://ctan.org/pkg/tabularx) 長い行を自動折り返しする列を作成する方法を探しているなら、パッケージを参照してください。
* tabular の行が次で始まる場合は `[...` を追加する必要があるかもしれません `\relax` の後に `\\` 前の行の

**soul または changes パッケージの使用**

もし次を使用しているなら [`soul`](https://ctan.org/pkg/soul) または [`changes`](https://ctan.org/pkg/changes) パッケージでテキストを強調表示したり取り消し線を引いたりしている場合は、 `\cite` や `\ref` の前に次を付ける必要があります `\protect`で設定します。たとえば、 `\protect\cite{...}`.

**tikzpicture の使用**

不足しているものを確認してください `;` パス/ノードコマンドの末尾にある `]` のパラメータリストの末尾にある `tikzpicture`がありません。

**breqn パッケージの使用**

この [`breqn`](https://ctan.org/pkg/breqn) パッケージの `dmath` 環境は無限ループに陥ることがあります。次のものに置き換えてください `align` 必要に応じて手動で改行してください。

**babel パッケージの使用**

一部の [`babel`](https://ctan.org/pkg/babel) 言語オプションでは特定の文字の意味が変わることがあり、その文字を「通常」の文脈、たとえば数式モードで使うと問題が起こることがあります。これを避けるには、次のオプションを使ってみてください `shorthands=off` babel を読み込むときに（例： `\usepackage[shorthands=off]{babel}`).

**jabbrv パッケージの使用**

一部のテンプレートでは次を使用します [`jabbrv` パッケージ](https://github.com/compholio/jabbrv) ジャーナル名を自動的に省略するために（次を参照 [この Overleaf の例](https://www.overleaf.com/latex/templates/automatic-journal-abbreviations/mxfsdscmvxcr)）。 `.bib` ファイルにアクセント付きの Unicode 文字（例: Biología）が含まれていると、コンパイルが妨げられ、Overleaf でタイムアウトが発生することがあります。代わりに LaTeX コマンドを使用する必要があります。たとえば `Biolog{\'i}a` または、 [プロジェクトのコンパイラを変更する](/latex/ja/narejjibsu/026-changing-compiler.md) から `XeLaTeX` または `LuaLaTeX`こともできます。どちらも Unicode 文字の読み取りを標準でサポートしています。

## 特定のタイムアウト状況に関するアドバイス

### プロジェクトは以前はエラーなくコンパイルできていたのに、今はコンパイルタイムアウトが発生します

小さな変更でもコンパイルタイムアウトを引き起こすことがあります。原因の特定と修正に役立つよう、次の手順を試してください:

1. 使用する [最初から再コンパイル](/latex/ja/narejjibsu/028-clearing-the-cache.md) 問題の原因となっている可能性のある古い生成ファイルを削除するためです。
2. 次の [Overleaf の履歴機能](/latex/ja/sononotopikku/49-using-the-history-feature.md) で最近の変更を見つけてください。上記の致命的なコンパイルエラーの原因一覧も参照してください。
3. 次の [最初のエラーで停止](/latex/ja/narejjibsu/149-using-the-stop-on-first-error-compilation-mode.md) オプションを使って、誤って導入したエラーを見つけて修正します。

小さな変更が致命的なコンパイルエラーにつながった可能性があります。次を参照してください [上記の致命的なコンパイルエラーの一覧](#anchor-fatal) にある原因の候補を確認してください。

### Overleaf にプロジェクトをアップロードしたばかりなのに、コンパイルタイムアウトが発生しました

プロジェクトに重要なファイルやパッケージが不足しているか、あるいは Overleaf のコンパイル処理に問題を引き起こす構成になっている可能性があります。

* ローカル環境では問題なくコンパイルできたのに Overleaf ではコンパイルできない場合は、異なるバージョンの **TeX Live** を自分のコンピュータで使っているのかもしれません。 [プロジェクトの TeX Live のバージョンを変更する](https://www.overleaf.com/blog/new-feature-select-your-tex-live-compiler-version) ことで、ローカルで正常にコンパイルできた環境により近づけることができます。
* アップロードしたプロジェクトのファイル構成が Overleaf に最適でない可能性があります。メインの tex ファイルがフォルダ内にある場合、コンパイラが一部の依存ファイルを見つけるのに苦労しているかもしれません。メインの tex ファイルがフォルダ内にある場合は、メインの tex ファイルがプロジェクトの最上位に来るようにプロジェクトを再構成してみてください。

上記の [エラーの特定と修正に関する手順に従うと](#first-errors) 不足しているファイル、TeX Live のバージョンの問題、プロジェクトの構成上の問題を特定できることがよくあります。

### コンパイルできていたプロジェクトのコピーを作成したのに、今はコンパイルタイムアウトが発生します

既存プロジェクトのコピーを含む新しいプロジェクトでは、既定で TeX Live の最新版が使用されます。元のプロジェクトが古い TeX Live バージョンだった場合、最新バージョンとの互換性の問題が原因で問題が起きているのかもしれません。次を試してください [TeX Live のバージョンを変更する](https://www.overleaf.com/blog/new-feature-select-your-tex-live-compiler-version) 新しいコピーで元のプロジェクトのバージョンに合わせます。

### すべてのセクションを含めるとプロジェクトをコンパイルできないのに、それぞれ単独では問題なくコンパイルできる

次に従ってください [上記の Fast\[draft\] コンパイルオプションに関するアドバイス](#second-images) に従って、プロジェクト全体を Fast\[draft] モードでコンパイルできるか確認してください。

場合によっては、大きなプロジェクトを 2 段階でうまくコンパイルできます。まず Fast\[draft] モードで実行し、その後 Normal モードでコンパイルします。

プロジェクトの各セクションを確認して、コンパイルが遅くなる原因を特定してください。これには次が含まれることがあります [最適化できる大きな画像ファイル](#anchor-optimize)、またはその他の [時間のかかる手法やパッケージ](#anchor-slow).

### プロジェクトはときどきタイムアウトしますが、安定してコンパイルできません

プロジェクトは最大コンパイル時間の上限ぎりぎりで動作しているのかもしれません。上記のアドバイスに従って [エラーを修正し](#first-errors), [画像を最適化し](#second-images)、そして [時間のかかる手法やパッケージを避けてください](#third-assess).

## コンパイルタイムアウトを防ぐためのベストプラクティス

コンパイルタイムアウトが起きてから対処する、時にストレスの多い作業をするよりも、そもそも起きないようにするほうがずっと望ましいです。以下の推奨事項は、コンパイルタイムアウトの発生を防ぎ、発生した場合もすばやく復旧するのに役立ちます。

### コンパイルエラーは発生したらすべて修正する

コンパイルエラーは、次で説明されているように、Recompile ボタンの横の赤い通知バルーンで示されます [このページ](/latex/ja/to-2/81-tips-and-tricks-for-troubleshooting-latex.md)。赤いバルーンをクリックすると、エラーメッセージが表示されます。各エラーメッセージをクリックすると、ソースコードの対応する行に移動できるので、コードを修正できます。エラーはできるだけ早く修正することをお勧めします。放置して蓄積すると、将来的にデバッグが難しい致命的なエラーにつながる可能性があるためです。

[このページ](/latex/ja/latexno/05-errors.md) では、いくつかの一般的なコンパイルエラーを説明しています。エラーメッセージの理解に困ったときは、エラー文をそのまま使ってオンラインで検索すると、そのエラーの説明や解決策が載ったブログやフォーラムの投稿が見つかることがよくあります。

### 大きな変更や重要な節目の前に、プロジェクトのバージョンにラベルを付ける

次の [Overleaf の履歴機能](/latex/ja/sononotopikku/49-using-the-history-feature.md) プロジェクトのバージョンにラベルを付けると、現在のプロジェクトと以前のバージョンを簡単に比較できます。これにより、新たなコンパイルエラーの原因をすばやく見つけやすくなります。

### ファイルを整理する

プロジェクトがよく整理されているほど、問題の発見と修正は容易になります。さらに、適切なプロジェクト管理により、プロジェクトの特定のセクションだけをコンパイルでき、異常に長いコンパイルの原因となっている箇所を特定しやすくなります。どうぞ [こちらを参照してください](/latex/ja/wen-shu-gou-zao/07-management-in-a-large-project.md) 大規模プロジェクトの管理に関するアドバイス

## コンパイルとコンパイル時間に関する詳細情報

### そもそも「コンパイル」とは何ですか？

コンパイルとは、LaTeXコードを組版済みのPDFファイルに変換する प्रक्रियाです。 [Overleaf が LaTeX プロジェクトをどのようにコンパイルするかについて詳しく学ぶ](/latex/ja/narejjibsu/064-how-does-overleaf-compile-my-project.md).

### フェアユースの制限

大きい文書や複雑な文書の中には、Overleaf の無料プランのタイムアウト制限よりもコンパイルに長い時間がかかるものがあり、当社の [有料プラン](https://www.overleaf.com/user/subscription/plans)で利用できる拡張コンパイル時間が必要になる場合があります。プロジェクトによっては、有料プランで利用できるよりもさらに長いコンパイル時間が必要なこともあります。その場合は、プロジェクトをダウンロードしてローカルでコンパイルする必要があるかもしれません。

### まだ解決しませんか？

ここでのアドバイスを使っても解決できないコンパイルのタイムアウトがある場合は、どうか [お知らせください](https://www.overleaf.com/contact).


---

# 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/narejjibsu/038-fixing-and-preventing-compile-timeouts.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.