> 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/tr/bicimlendirme/11-code-listing.md).

# Kod listeleri

## Giriş

LaTeX bilimde yaygın olarak kullanılır ve programlama, bilimin çeşitli alanlarında önemli bir unsur haline gelmiştir; bu nedenle kodu düzgün biçimde gösteren bir araca ihtiyaç vardır. Bu makale, standart **verbatim** ortamı ile birlikte paketini **listings**ile birlikte, daha gelişmiş kod biçimlendirme özellikleri sağlayan paketi açıklar. [Bu ayrı makale](/latex/tr/bicimlendirme/12-code-highlighting-with-minted.md) şunu tartışır: `minted` paketi, Python'un `pygmentize` kitaplığı.

## Verbatim ortamı

LaTeX'te kodu göstermek için varsayılan araç `verbatim`dır ve tek aralıklı yazı tipinde bir çıktı üretir.

```latex
\begin{verbatim}
\texttt{verbatim} ortamı içine alınan metin
doğrudan yazdırılır
ve tüm \LaTeX{} komutları yok sayılır.
\end{verbatim}
```

[Bu örneği Overleaf'te açın](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=verbatim+text+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bverbatim%7D%0AText+enclosed+inside+%5Ctexttt%7Bverbatim%7D+environment+%0Ais+printed+directly+%0Aand+all+%5CLaTeX%7B%7D+commands+are+ignored.%0A%5Cend%7Bverbatim%7D%0A%5Cend%7Bdocument%7D)

Yukarıdaki kod aşağıdaki çıktıyı üretir:

![Verbatim1.png](/files/83d818b68f7958fbc4a7810dc62e6e589ff02512)

Girişteki örnekte olduğu gibi, tüm metin satır sonları ve boşluklar korunarak yazdırılır. Bu komutun çıktısı biraz farklı olan yıldızlı bir sürümü vardır.

```latex
\begin{verbatim*}
\texttt{verbatim} ortamı içine alınan metin
doğrudan yazdırılır
ve tüm \LaTeX{} komutları yok sayılır.
\end{verbatim*}
```

[Bu örneği Overleaf'te açın](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=verbatim+text+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bverbatim%2A%7D%0AText+enclosed+inside+%5Ctexttt%7Bverbatim%7D+environment+%0Ais+printed+directly+%0Aand+all+%5CLaTeX%7B%7D+commands+are+ignored.%0A%5Cend%7Bverbatim%2A%7D%0A%5Cend%7Bdocument%7D)

Yukarıdaki kod aşağıdaki çıktıyı üretir:

![Verbatim2.png](/files/2cabc5efcc4210d9b0843d14afa4bb86d7511a99)

Bu durumda boşluklar özel bir "görünen-boşluk" karakteri ile vurgulanır: **`␣`**.

Verbatim benzeri metin ayrıca bir paragraf içinde de `\verb` komutunu.

```latex
Dizin \verb|C:\Windows\system32| içinde birçok Windows
sistem uygulaması bulabilirsiniz.

\verb+\ldots+ komutu \ldots üretir
```

[Bu örneği Overleaf'te açın](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=using+the+%5Cverb+command\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AIn+the+directory+%5Cverb%7CC%3A%5CWindows%5Csystem32%7C+you+can+find+a+lot+of+Windows+%0Asystem+applications.+%0A+%0AThe+%5Cverb%2B%5Cldots%2B+command+produces+%5Cldots%0A%5Cend%7Bdocument%7D)

Yukarıdaki kod aşağıdaki çıktıyı üretir:

![Verbatim3OLV2.png](/files/2145736464dedaf3fb60a8fa5c5f05b549e72f73)

Komut `\verb|C:\Windows\system32|` içindeki metni `|` verbatim biçiminde yazdırır. Harfler ve `*`hariç herhangi bir karakter ayırıcı olarak kullanılabilir. Örneğin `\verb+\ldots+` şunu ayırıcı olarak kullanır: `+` .

## Kodu vurgulamak için listings kullanımı

Şunu kullanmak için `lstlisting` ortamını belgenizin önsözüne aşağıdaki satırı eklemeniz gerekir:

```latex
\usepackage{listings}
```

İşte `lstlisting` ortamının `listings` paketi:

```latex
\begin{lstlisting}
import numpy as np

def incmatrix(genl1,genl2):
    m = len(genl1)
    n = len(genl2)
    M = None #olay matrisi olacak
    VT = np.zeros((n*m,1), int)  #geçici değişken

    #bit düzeyinde xor matrisini hesapla
    M1 = bitxormatrix(genl1)
    M2 = np.triu(bitxormatrix(genl2),1)

    for i in range(m-1):
        for j in range(i+1, m):
            [r,c] = np.where(M2 == M1[i,j])
            for k in range(len(r)):
                VT[(i)*n + r[k]] = 1;
                VT[(i)*n + c[k]] = 1;
                VT[(j)*n + r[k]] = 1;
                VT[(j)*n + c[k]] = 1;

                if M is None:
                    M = np.copy(VT)
                else:
                    M = np.concatenate((M, VT), 1)

                VT = np.zeros((n*m,1), int)

    return M
\end{lstlisting}
```

[Bunu açın `listings` Overleaf'teki örneği](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=listings+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Blistings%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Blstlisting%7D%0Aimport+numpy+as+np%0A++++%0Adef+incmatrix%28genl1%2Cgenl2%29%3A%0A++++m+%3D+len%28genl1%29%0A++++n+%3D+len%28genl2%29%0A++++M+%3D+None+%23to+become+the+incidence+matrix%0A++++VT+%3D+np.zeros%28%28n%2Am%2C1%29%2C+int%29++%23dummy+variable%0A++++%0A++++%23compute+the+bitwise+xor+matrix%0A++++M1+%3D+bitxormatrix%28genl1%29%0A++++M2+%3D+np.triu%28bitxormatrix%28genl2%29%2C1%29+%0A%0A++++for+i+in+range%28m-1%29%3A%0A++++++++for+j+in+range%28i%2B1%2C+m%29%3A%0A++++++++++++%5Br%2Cc%5D+%3D+np.where%28M2+%3D%3D+M1%5Bi%2Cj%5D%29%0A++++++++++++for+k+in+range%28len%28r%29%29%3A%0A++++++++++++++++VT%5B%28i%29%2An+%2B+r%5Bk%5D%5D+%3D+1%3B%0A++++++++++++++++VT%5B%28i%29%2An+%2B+c%5Bk%5D%5D+%3D+1%3B%0A++++++++++++++++VT%5B%28j%29%2An+%2B+r%5Bk%5D%5D+%3D+1%3B%0A++++++++++++++++VT%5B%28j%29%2An+%2B+c%5Bk%5D%5D+%3D+1%3B%0A++++++++++++++++%0A++++++++++++++++if+M+is+None%3A%0A++++++++++++++++++++M+%3D+np.copy%28VT%29%0A++++++++++++++++else%3A%0A++++++++++++++++++++M+%3D+np.concatenate%28%28M%2C+VT%29%2C+1%29%0A++++++++++++++++%0A++++++++++++++++VT+%3D+np.zeros%28%28n%2Am%2C1%29%2C+int%29%0A++++%0A++++return+M%0A%5Cend%7Blstlisting%7D%0A%5Cend%7Bdocument%7D)

Yukarıdaki kod aşağıdaki çıktıyı üretir:

![CodeListingEx1.png](/files/18fdeccaa0cf593debb95387c1c42462dc3a3989)

Bu örnekte çıktı, tüm LaTeX komutlarını yok sayar ve metin yazılan tüm satır sonları ve boşluklar korunarak yazdırılır. İkinci bir örneğe bakalım:

```latex
\begin{lstlisting}[language=Python]
import numpy as np

def incmatrix(genl1,genl2):
    m = len(genl1)
    n = len(genl2)
    M = None #olay matrisi olacak
    VT = np.zeros((n*m,1), int)  #geçici değişken

    #bit düzeyinde xor matrisini hesapla
    M1 = bitxormatrix(genl1)
    M2 = np.triu(bitxormatrix(genl2),1)

    for i in range(m-1):
        for j in range(i+1, m):
            [r,c] = np.where(M2 == M1[i,j])
            for k in range(len(r)):
                VT[(i)*n + r[k]] = 1;
                VT[(i)*n + c[k]] = 1;
                VT[(j)*n + r[k]] = 1;
                VT[(j)*n + c[k]] = 1;

                if M is None:
                    M = np.copy(VT)
                else:
                    M = np.concatenate((M, VT), 1)

                VT = np.zeros((n*m,1), int)

    return M
\end{lstlisting}
```

[Bunu açın `listings` Overleaf'teki örneği](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Python+listings+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Blistings%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Blstlisting%7D%5Blanguage%3DPython%5D%0Aimport+numpy+as+np%0A++++%0Adef+incmatrix%28genl1%2Cgenl2%29%3A%0A++++m+%3D+len%28genl1%29%0A++++n+%3D+len%28genl2%29%0A++++M+%3D+None+%23to+become+the+incidence+matrix%0A++++VT+%3D+np.zeros%28%28n%2Am%2C1%29%2C+int%29++%23dummy+variable%0A++++%0A++++%23compute+the+bitwise+xor+matrix%0A++++M1+%3D+bitxormatrix%28genl1%29%0A++++M2+%3D+np.triu%28bitxormatrix%28genl2%29%2C1%29+%0A%0A++++for+i+in+range%28m-1%29%3A%0A++++++++for+j+in+range%28i%2B1%2C+m%29%3A%0A++++++++++++%5Br%2Cc%5D+%3D+np.where%28M2+%3D%3D+M1%5Bi%2Cj%5D%29%0A++++++++++++for+k+in+range%28len%28r%29%29%3A%0A++++++++++++++++VT%5B%28i%29%2An+%2B+r%5Bk%5D%5D+%3D+1%3B%0A++++++++++++++++VT%5B%28i%29%2An+%2B+c%5Bk%5D%5D+%3D+1%3B%0A++++++++++++++++VT%5B%28j%29%2An+%2B+r%5Bk%5D%5D+%3D+1%3B%0A++++++++++++++++VT%5B%28j%29%2An+%2B+c%5Bk%5D%5D+%3D+1%3B%0A++++++++++++++++%0A++++++++++++++++if+M+is+None%3A%0A++++++++++++++++++++M+%3D+np.copy%28VT%29%0A++++++++++++++++else%3A%0A++++++++++++++++++++M+%3D+np.concatenate%28%28M%2C+VT%29%2C+1%29%0A++++++++++++++++%0A++++++++++++++++VT+%3D+np.zeros%28%28n%2Am%2C1%29%2C+int%29%0A++++%0A++++return+M%0A%5Cend%7Blstlisting%7D%0A%5Cend%7Bdocument%7D)

Yukarıdaki kod aşağıdaki çıktıyı üretir:

![CodeListingEx2.png](/files/90705e1eefb7dae417fec1a30684c273ecc3ea33)

Köşeli parantez içindeki ek parametre `[language=Python]` bu belirli programlama dili (Python) için kod vurgulamayı etkinleştirir; özel sözcükler kalın yazı tipinde, yorumlar ise italik yazılır. Desteklenen programlama dillerinin tam listesi için [başvuru kılavuzuna](#reference-guide) bölümüne bakın.

## Kodun bir dosyadan içe aktarılması

Kod genellikle bir kaynak dosyasında saklanır; bu nedenle kodu bir dosyadan otomatik olarak çeken bir komut çok kullanışlıdır.

```latex
Bir sonraki kod doğrudan bir dosyadan içe aktarılacaktır

\lstinputlisting[language=Octave]{BitXorMatrix.m}
```

![CodeListingEx3.png](/files/a873810cb2fd832537d81eb34bfdb431d7adf564)

Komut `\lstinputlisting[language=Octave]{BitXorMatrix.m}` dosyasındaki kodu içe aktarır *BitXorMatrix.m*; köşeli parantez içindeki ek parametre Octave programlama dili için dil vurgulamayı etkinleştirir. Yalnızca dosyanın bir kısmını içe aktarmanız gerekiyorsa, parantezler içinde virgülle ayrılmış iki parametre belirtebilirsiniz. Örneğin, 2. satırdan 12. satıra kadar olan kodu içe aktarmak için önceki komut şu olur:

```latex
\lstinputlisting[language=Octave, firstline=2, lastline=12]{BitXorMatrix.m}
```

Eğer `firstline` ya da `lastline` atlanırsa, değerlerin sırasıyla dosyanın başlangıcı veya dosyanın sonu olduğu varsayılır.

## Kod stilleri ve renkler

ile kod biçimlendirme **listing** paketi oldukça özelleştirilebilir. Bir örneğe bakalım

```latex
\documentclass{article}
\usepackage{listings}
\usepackage{xcolor}

\definecolor{codegreen}{rgb}{0,0.6,0}
\definecolor{codegray}{rgb}{0.5,0.5,0.5}
\definecolor{codepurple}{rgb}{0.58,0,0.82}
\definecolor{backcolour}{rgb}{0.95,0.95,0.92}

\lstdefinestyle{mystyle}{
    backgroundcolor=\color{backcolour},
    commentstyle=\color{codegreen},
    keywordstyle=\color{magenta},
    numberstyle=\tiny\color{codegray},
    stringstyle=\color{codepurple},
    basicstyle=\ttfamily\footnotesize,
    breakatwhitespace=false,
    breaklines=true,
    captionpos=b,
    keepspaces=true,
    numbers=left,
    numbersep=5pt,
    showspaces=false,
    showstringspaces=false,
    showtabs=false,
    tabsize=2
}

\lstset{style=mystyle}

\begin{document}
Bir sonraki kod doğrudan bir dosyadan içe aktarılacaktır

\lstinputlisting[language=Octave]{BitXorMatrix.m}
\end{document}
```

Yukarıdaki kod aşağıdaki çıktıyı üretir:

![CodeListingEx4.png](/files/ee0ba7e218fed305e8070c7d5cf23fe500d3f40c)

Gördüğünüz gibi, kod renklendirmesi ve stil verme okunabilirliği büyük ölçüde artırır.

Bu örnekte paket **xcolor** içe aktarılır ve ardından komut `\definecolor{}{}{}` ileride kullanılacak rgb biçiminde yeni renkler tanımlamak için kullanılır. Daha fazla bilgi için bakınız: [LaTeX'te renk kullanımı](/latex/tr/bicimlendirme/13-using-colors-in-latex.md)

Bu örneğin stilini oluşturan esasen iki komut vardır:

**\lstdefinestyle{mystyle}{...}**

"mystyle" adlı yeni bir kod listeleme stili tanımlar. Stil tanımlayan seçenekler ikinci süslü parantez çiftinin içinde verilir; bunların ve diğer bazı parametrelerin tam açıklaması için başvuru kılavuzuna bakın.

**\lstset{style=mystyle}**

"mystyle" stilini etkinleştirir. Bu komut, gerekirse belgeniz içinde farklı bir stile geçmek için kullanılabilir.

## Başlıklar ve Listings listesi

Tıpkı float'larda ([tablolar](/latex/tr/sekiller-ve-tablolar/01-tables.md) ve [figürler](/latex/tr/daha-fazla-konu/27-inserting-images.md)), daha açık bir sunum için bir listelemeye başlık eklenebilir.

```latex
\begin{lstlisting}[language=Python, caption=Python example]
import numpy as np

def incmatrix(genl1,genl2):
    m = len(genl1)
    n = len(genl2)
    M = None #olay matrisi olacak
    VT = np.zeros((n*m,1), int)  #geçici değişken

    #bit düzeyinde xor matrisini hesapla
    M1 = bitxormatrix(genl1)
    M2 = np.triu(bitxormatrix(genl2),1)

    for i in range(m-1):
        for j in range(i+1, m):
            [r,c] = np.where(M2 == M1[i,j])
            for k in range(len(r)):
                VT[(i)*n + r[k]] = 1;
                VT[(i)*n + c[k]] = 1;
                VT[(j)*n + r[k]] = 1;
                VT[(j)*n + c[k]] = 1;

                if M is None:
                    M = np.copy(VT)
                else:
                    M = np.concatenate((M, VT), 1)

                VT = np.zeros((n*m,1), int)

    return M
\end{lstlisting}
```

[Bunu açın `listings` Overleaf'teki örneği](/latex/tr/bicimlendirme/11-code-listing.md)

Yukarıdaki kod aşağıdaki çıktıyı üretir:

![CodeListingEx5.png](/files/3a4153147971fc6d800bb8e1f38b6e319d7daf35)

Virgülle ayrılmış parametrenin eklenmesi `caption=Python example` köşeli parantezlerin içine, başlığı etkinleştirir. Bu başlık daha sonra Listings listesinden kullanılabilir.

```latex
\lstlistoflistings
```

![CodeListingEx6OLV2.png](/files/974f8cc418b6d34c074c78c93306f866f8a6338c)

## Örnek Overleaf projesi

Şu bağlantıyı açın [denemek için `listings` paket örneğini Overleaf'te.](https://www.overleaf.com/project/new/template/20053?id=68266290\&templateName=listings+package+demo\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

## Başvuru kılavuzu

### Desteklenen diller

**desteklenen diller (ve mümkünse lehçeleri; lehçeler parantez içinde belirtilir ve varsayılan lehçeler italik yazılır):**

|                                                        |                                                  |
| ------------------------------------------------------ | ------------------------------------------------ |
| ABAP (R/2 4.3, R/2 5.0, R/3 3.1, R/3 4.6C, *R/3 6.10*) | ACSL                                             |
| Ada (*2005*, 83, 95)                                   | Algol (60, *68*)                                 |
| Ant                                                    | Assembler (Motorola68k, x86masm)                 |
| Awk (*gnu*, POSIX)                                     | bash                                             |
| Basic (Visual)                                         | C (*ANSI*, Handel, Objective, Sharp)             |
| C++ (ANSI, GNU, *ISO*, Visual)                         | Caml (*light*, Objective)                        |
| CIL                                                    | Clean                                            |
| Cobol (1974, *1985*, ibm)                              | Comal 80                                         |
| command.com (*WinXP*)                                  | Comsol                                           |
| csh                                                    | Delphi                                           |
| Eiffel                                                 | Elan                                             |
| erlang                                                 | Euphoria                                         |
| Fortran (77, 90, *95*)                                 | GCL                                              |
| Gnuplot                                                | Haskell                                          |
| HTML                                                   | IDL (empty, CORBA)                               |
| inform                                                 | Java (empty, AspectJ)                            |
| JVMIS                                                  | ksh                                              |
| Lingo                                                  | Lisp (empty, Auto)                               |
| Logo                                                   | make (empty, gnu)                                |
| Mathematica (1.0, 3.0, *5.2*)                          | Matlab                                           |
| Mercury                                                | MetaPost                                         |
| Miranda                                                | Mizar                                            |
| ML                                                     | Modula-2                                         |
| MuPAD                                                  | NASTRAN                                          |
| Oberon-2                                               | OCL (decorative, *OMG*)                          |
| Octave                                                 | Oz                                               |
| Pascal (Borland6, *Standart*, XSC)                     | Perl                                             |
| PHP                                                    | PL/I                                             |
| Plasm                                                  | PostScript                                       |
| POV                                                    | Prolog                                           |
| Promela                                                | PSTricks                                         |
| Python                                                 | R                                                |
| Reduce                                                 | Rexx                                             |
| RSL                                                    | Ruby                                             |
| S (empty, PLUS)                                        | SAS                                              |
| Scilab                                                 | sh                                               |
| SHELXL                                                 | Simula (*67*, CII, DEC, IBM)                     |
| SPARQL                                                 | SQL                                              |
| tcl (empty, tk)                                        | TeX (AlLaTeX, common, LaTeX, *plain*, primitive) |
| VBScript                                               | Verilog                                          |
| VHDL (empty, AMS)                                      | VRML (*97*)                                      |
| XML                                                    | XSLT                                             |

### Kod listeleme stillerini özelleştirmek için seçenekler

* **backgroundcolor** - arka plan rengi. Harici ***color*** ya da ***xcolor*** paketi gerekir.
* **commentstyle** - kaynak dildeki yorumların stili.
* **basicstyle** - kaynak için yazı tipi boyutu/aile vb. (örn. `basicstyle=\ttfamily\small`)
* **keywordstyle** - kaynak dildeki anahtar sözcüklerin stili (örn. `keywordstyle=\color{red}`)
* **numberstyle** - satır numaraları için kullanılan stil
* **numbersep** - satır numaralarının koda uzaklığı
* **stringstyle** - kaynak dildeki dizelerin stili
* **showspaces** - koddaki boşlukları vurgular (true/false)
* **showstringspaces** - dizelerdeki boşlukları vurgular (true/false)
* **showtabs** - koddaki sekmeleri vurgular (true/false)
* **numaralar** - satır numaralarının konumu (left/right/none, yani satır numarası yok)
* **prebreak** - kırılan satırın sonunda gösterilen işaret (örn. `prebreak=\raisebox{0ex}[0ex][0ex]{\ensuremath{\hookleftarrow}}`)
* **captionpos** - başlığın konumu (t/b)
* **çerçeve** - kodun dışında çerçeve gösterimi (none/leftline/topline/bottomline/lines/single/shadowbox)
* **breakatwhitespace** - otomatik satır kırılmasının yalnızca boşluklarda gerçekleşip gerçekleşmeyeceğini belirler
* **breaklines** - otomatik satır kırma
* **keepspaces** - koddaki boşlukları korur, girintileme için kullanışlıdır
* **tabsize** - varsayılan sekme boyutu
* **escapeinside** - kaynak koddan LaTeX'e kaçış için kullanılacak karakterleri belirtir (örn. `escapeinside={\%*}{*)}`)
* **rulecolor** - çerçeve kutusunun rengini belirtin

## Daha fazla okuma

Daha fazla bilgi için bakın:

* [minted ile Kod Vurgulama](/latex/tr/bicimlendirme/12-code-highlighting-with-minted.md)
* [LaTeX'te renk kullanımı](/latex/tr/bicimlendirme/13-using-colors-in-latex.md)
* [İçindekiler](/latex/tr/belge-yapisi/02-table-of-contents.md)
* [Büyük bir projede yönetim](/latex/tr/belge-yapisi/07-management-in-a-large-project.md)
* [Çok dosyalı LaTeX projeleri](/latex/tr/belge-yapisi/08-multi-file-latex-projects.md)
* [Yazı tipi boyutları, aileleri ve stilleri](/latex/tr/yazi-tipleri/01-font-sizes-families-and-styles.md)
* [Yazı tipi karakterleri](/latex/tr/yazi-tipleri/02-font-typefaces.md)
* [**listings** paket dokümantasyonu](https://texdoc.org/serve/listings/0)
* [**listings** CTAN web sitesi](http://www.ctan.org/pkg/listings)


---

# 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/tr/bicimlendirme/11-code-listing.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.