> 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/da/figurer-og-tabeller/02-positioning-images-and-tables.md).

# Placering af billeder og tabeller

LaTeX er et redigeringsværktøj, der tager sig af formatet, så du kun behøver at bekymre dig om indholdet af dit dokument; ikke desto mindre er bedre kontrol over flydende elementer nogle gange nødvendig. Denne artikel forklarer, hvordan man placerer billeder og tabeller i et LaTeX-dokument.

## Introduktion

Standardjusteringen for billeder og tabeller er sat til *left*

```latex
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisis sem. Nullam nec mi et neque pharetra
sollicitudin.

\includegraphics[width=0.5\textwidth]{overleaf-logo}

Praesent imperdiet mi nec
ante. Donec ullamcorper, felis non sodales commodo, lectus velit
ultrices augue, a dignissim nibh lectus placerat pede.
 Vivamus nunc nunc, molestie ut, ultricies
vel, semper in, velit. Ut porttitor.
```

![PositioningTnIEX1OverleafV2.png](/files/64c940c6f0e9996d9ac8c093ffa6090da3174033)

Dette er et simpelt eksempel; for en beskrivelse af dette og andre måder at inkludere billeder i din LaTeX-fil på, se artiklen [Indsættelse af billeder](/latex/da/flere-emner/27-inserting-images.md).

&#x20;[Åbn et eksempel i Overleaf](https://www.overleaf.com/project/new/template/19663?id=66518064\&templateName=Example+of+positioning+tables+and+figures\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

## Placering af billeder

### Grundlæggende placering

For at ændre standardjusteringen af et billede fra *left* eller *right*, er en nem mulighed at tilføje

```latex
\usepackage[export]{adjustbox}
```

til præamblen i din fil og derefter bruge en ekstra mulighed i din billedimportkommando

```latex
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisis sem. Nullam nec mi et neque
pharetra sollicitudin.

\includegraphics[width=0.5\textwidth, right]{overleaf-logo}

Praesent imperdiet mi necante. Donec ullamcorper, felis
non sodales commodo, lectus velit ultrices augue,
a dignissim nibh lectus placerat pede. Vivamus nunc nunc,
molestie ut, ultriciesvel, semper in, velit. Ut porttitor.
```

![PositioningTnIEx2OLV2.png](/files/791974b98dbd7a882638534c59da3770378b38dd)

Pakken **adjustbox** aktiverer en ekstra mulighed i `\includegraphics` kommandoen; i eksemplet er billedet justeret til `right`. De tilgængelige værdier er: *left*, *right*, *center*, *ydre* og *indre*, de sidste to er beregnet til dobbeltsidede dokumenter.

&#x20;[Åbn et eksempel i Overleaf](https://www.overleaf.com/project/new/template/19663?id=66518064\&templateName=Example+of+positioning+tables+and+figures\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

### Figurmiljøet

Figurmiljøet (se [Indsættelse af billeder](/latex/da/flere-emner/27-inserting-images.md)) er beregnet til at give automatisk placering.

```latex
Praesent in sapien. Lorem ipsum dolor sit amet, consectetuer adipiscing
elit. Duis fringilla tristique neque. Sed interdum libero ut metus.
Pellentesque placerat. Nam rutrum augue a leo. Morbi sed elit sit amet
ante lobortis sollicitudin.

\begin{figure}[h]
\includegraphics[width=0.5\textwidth, inner]{overleaf-logo}
\caption{Caption}
\label{fig:figure2}
\\end{figure}
```

![PositioningTnIEx3OLV2.png](/files/42e34cf6243e686901bfbfe65b69018aa15e28eb)

Dette miljø bruger en placeringsparameter, der gives i kantede parenteser; den kan have følgende værdier:

| Parameter | Placering                                                                                                           |
| --------- | ------------------------------------------------------------------------------------------------------------------- |
| h         | Placer floaten *her*, dvs., *omtrent* på samme sted, som den optræder i kildeteksten (dog ikke *præcist* på stedet) |
| t         | Placer ved *toppen* af siden.                                                                                       |
| b         | Placer ved *bunden* af siden.                                                                                       |
| p         | Placér på en særlig *page* kun til floats.                                                                          |
| !         | Tilsidesæt interne parametre, som LaTeX bruger til at bestemme "gode" float-placeringer.                            |
| H         | Placerer floaten på præcis den placering i LaTeX-koden. Kræver `float` pakken. Dette svarer nogenlunde til h!.      |

Du kan angive mere end én værdi i parameteren; hvis du f.eks. skriver `[ht]` vil LaTeX forsøge at placere figuren **her**, men hvis det ikke er muligt (der er muligvis ikke plads nok), vil figuren blive vist **toppen** på siden. Det anbefales at bruge mere end én placeringsparameter for at undgå uventede resultater.

&#x20;[Åbn et eksempel i Overleaf](https://www.overleaf.com/project/new/template/19663?id=66518064\&templateName=Example+of+positioning+tables+and+figures\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

### Flere billeder i én figur

Det er muligt at indsætte flere billeder i én figur, hver med sin egen reference og etiket

```latex
Praesent in sapien. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Duis fringilla tristique neque...

\begin{figure}[h]

\begin{subfigure}{0.5\textwidth}
\includegraphics[width=0.9\linewidth, height=6cm]{overleaf-logo}
\caption{Caption1}
\label{fig:subim1}
\end{subfigure}
\begin{subfigure}{0.5\textwidth}
\includegraphics[width=0.9\linewidth, height=6cm]{mesh}
\caption{Caption 2}
\label{fig:subim2}
\end{subfigure}

\caption{Caption for this figure with two images}
\label{fig:image2}
\\end{figure}

Praesent blandit blandit mauris. Praesent lectus tellus, aliquet aliquam, luctus a, egestas a, turpis. Mauris lacinia lorem sit amet ipsum. Nunc quis urna dictum turpis accumsan semper.
```

![PositioningTnIEx4OLV2.png](/files/8b67dd513070bd696c4f668929b8c6ae7fa3e3a0)

Først skal du importere pakken **subcaption** ved at tilføje til præamblen

```latex
\usepackage{subcaption}
```

derefter kan du bruge miljøet `\subfigure` som tager én parameter, figurens bredde. Dette miljø skal bruges inde i et `figure` miljø, og billedtekster og etiketter kan angives for hver *underfigur*.

&#x20;[Åbn et eksempel i Overleaf](https://www.overleaf.com/project/new/template/19663?id=66518064\&templateName=Example+of+positioning+tables+and+figures\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

### Omløb af tekst omkring en figur

Pakken **wrapfig** giver en nyttig funktion: tekst kan flyde omkring billederne.

```latex
Praesent in sapien. Lorem ipsum dolor sit amet, consectetuer
adipiscing elit. Duis fringilla tristique neque. Sed interdum
libero ut metus. Pellentesque placerat.

\begin{wrapfigure}{l}{0.25\textwidth}
\includegraphics[width=0.9\linewidth]{overleaf-logo}
\caption{Caption1}
\label{fig:wrapfig}
\end{wrapfigure}

Praesent in sapien. Lorem ipsum dolor sit amet, consectetuer
adipiscing elit. Duis fringilla tristique neque. Sed interdum
```

![PositioningTnIEx5OLV2.png](/files/2ec31132aec372322f96252e581635f62923a255)

Først importerer du pakken *wrapfig* ved at tilføje

```latex
\usepackage{wrapfig}
```

til præamblen.

Derefter kan du bruge miljøet `wrapfig`, det tager to parametre, som gives i klammer: justeringen, som kan være *l*, *r*, *c*, *i* eller *eller*; disse bogstaver står for venstre, højre, centreret, indre og ydre (de sidste to er beregnet til dobbeltsidede dokumenter). Den anden parameter er figurens bredde; i eksemplet er 0,25 bredden af teksten. Se [referencevejledningen](#reference-guide) for en liste over mulige længdeenheder.

&#x20;[Åbn et eksempel i Overleaf](https://www.overleaf.com/project/new/template/19663?id=66518064\&templateName=Example+of+positioning+tables+and+figures\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

## Placering af tabeller

Valgmulighederne for tabelplacering ligner dem, der er tilgængelige for figurer.

### Grundlæggende placering

Standardplaceringen for tabular-miljøet er *centreret*.

```latex
Praesent in sapien. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Duis fringilla tristique neque.
Sed interdum libero ut metus. Pellentesque placerat. Nam rutrum augue a leo. Morbi sed elit sit amet
ante lobortis sollicitudin.

\arrayrulecolor[HTML]{DB5800}
\begin{tabular}{ |s|p{2cm}|p{2cm}|  }
\hline
\rowcolor{lightgray} \multicolumn{3}{|c|}{Landsliste} \\
\hline
Landsnavn eller områdenavn& ISO ALFA 2-kode &ISO ALFA 3 \\
\hline
Afghanistan & AF &AFG \\
\rowcolor{gray}
Ålandsøerne & AX  & ALA \\
Albanien    &AL & ALB \\
Algeriet   &DZ & DZA \\
Amerikansk Samoa & AS & ASM \\
Andorra & AD & \cellcolor[HTML]{AA0044} AND \\
Angola & AO & AGO \\
\hline
\end{tabular}

Praesent in sapien. Lorem ipsum dolor sit amet, consectetuer adipiscing
elit. Duis fringilla tristique neque. Sed interdum libero ut metus.
Pellentesque placerat. Nam rutrum augue a leo. Morbi sed elit sit
amet ante lobortis sollicitudin.
```

&#x20;[Åbn dette kodefragment i Overleaf](https://www.overleaf.com/docs?engine=\&snip_name=Default+position+of+tabular\&snip=%5Cdocumentclass%7Barticle%7D%0A%25Table-related+commands%0A%5Cusepackage%7Barray%7D%0A%5Cusepackage%5Btable%5D%7Bxcolor%7D%0A%5Csetlength%7B%5Carrayrulewidth%7D%7B1mm%7D%0A%5Csetlength%7B%5Ctabcolsep%7D%7B18pt%7D%0A%5Crenewcommand%7B%5Carraystretch%7D%7B1.5%7D%0A%5Cnewcolumntype%7Bs%7D%7B%3E%7B%5Ccolumncolor%5BHTML%5D%7BAAACED%7D%7D+p%7B3cm%7D%7D%0A%0A%5Cbegin%7Bdocument%7D%0APraesent+in+sapien.+Lorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.+Duis+fringilla+tristique+neque.+%0ASed+interdum+libero+ut+metus.+Pellentesque+placerat.+Nam+rutrum+augue+a+leo.+Morbi+sed+elit+sit+amet+%0Aante+lobortis+sollicitudin.%0A%0A%5Carrayrulecolor%5BHTML%5D%7BDB5800%7D%0A%5Cbegin%7Btabular%7D%7B+%7Cs%7Cp%7B2cm%7D%7Cp%7B2cm%7D%7C++%7D%0A%5Chline%0A%5Crowcolor%7Blightgray%7D+%5Cmulticolumn%7B3%7D%7B%7Cc%7C%7D%7BCountry+List%7D+%5C%5C%0A%5Chline%0ACountry+Name+or+Area+Name%26+ISO+ALPHA+2+Code+%26ISO+ALPHA+3+%5C%5C%0A%5Chline%0AAfghanistan+%26+AF+%26AFG+%5C%5C%0A%5Crowcolor%7Bgray%7D%0AAland+Islands+%26+AX++%26+ALA+%5C%5C%0AAlbania++++%26AL+%26+ALB+%5C%5C%0AAlgeria+++%26DZ+%26+DZA+%5C%5C%0AAmerican+Samoa+%26+AS+%26+ASM+%5C%5C%0AAndorra+%26+AD+%26+%5Ccellcolor%5BHTML%5D%7BAA0044%7D+AND+%5C%5C%0AAngola+%26+AO+%26+AGO+%5C%5C%0A%5Chline%0A%5Cend%7Btabular%7D%0A%0APraesent+in+sapien.+Lorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+%0Aelit.+Duis+fringilla+tristique+neque.+Sed+interdum+libero+ut+metus.+%0APellentesque+placerat.+Nam+rutrum+augue+a+leo.+Morbi+sed+elit+sit+%0Aamet+ante+lobortis+sollicitudin.%0A%5Cend%7Bdocument%7D)

Den følgende grafik viser resultatet af kodefragmentet ovenfor:

![PositioningTnIEx6.png](/files/b9b815e454fc4efd0f3143926bb8f6ffca26154b)

Du kan også  [åbn et komplet projekteksempel i Overleaf.](https://www.overleaf.com/project/new/template/19663?id=66518064\&templateName=Example+of+positioning+tables+and+figures\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

For at lære, hvordan man opretter tabeller, se [Tabeller](/latex/da/figurer-og-tabeller/01-tables.md) artiklen.

### Tabelmiljøet

Tabelmiljøet er beregnet til automatisk at placere tabeller, så de passer pænt ind i dokumentets forløb.

```latex
Praesent in sapien. Lorem ipsum dolor sit amet, consectetuer
adipiscing elit. Duis fringilla tristique neque. Sed interdum
libero ut metus. Pellentesque placerat. Nam rutrum augue a leo.
Morbi sed elit sit amet ante lobortis sollicitudin.

\begin{table}[ht]
\arrayrulecolor[HTML]{DB5800}
\\centering
\begin{tabular}{ |s|p{2cm}|p{2cm}|  }
\hline
\rowcolor{lightgray} \multicolumn{3}{|c|}{Landsliste} \\
\hline
Landsnavn eller områdenavn& ISO ALFA 2-kode &ISO ALFA 3 \\
\hline
Afghanistan & AF &AFG \\
\rowcolor{gray}
Ålandsøerne & AX  & ALA \\
Albanien    &AL & ALB \\
Algeriet   &DZ & DZA \\
Amerikansk Samoa & AS & ASM \\
Andorra & AD & \cellcolor[HTML]{AA0044} AND \\
Angola & AO & AGO \\
\hline
\end{tabular}
\caption{Table inside a floating element}
\label{table:ta}
\end{table}

Praesent in sapien. Lorem ipsum dolor sit amet, consectetuer
adipiscing elit. Duis fringilla tristique neque. Sed interdum
libero ut metus. Pellentesque placerat. Nam rutrum augue a leo.
Morbi sed elit sit amet ante lobortis sollicitudin.
```

&#x20;[Åbn dette kodefragment i Overleaf](https://www.overleaf.com/docs?engine=\&snip_name=Default+position+of+tabular\&snip=%5Cdocumentclass%7Barticle%7D%0A%25Table-related+commands%0A%5Cusepackage%7Barray%7D%0A%5Cusepackage%5Btable%5D%7Bxcolor%7D%0A%5Csetlength%7B%5Carrayrulewidth%7D%7B1mm%7D%0A%5Csetlength%7B%5Ctabcolsep%7D%7B18pt%7D%0A%5Crenewcommand%7B%5Carraystretch%7D%7B1.5%7D%0A%5Cnewcolumntype%7Bs%7D%7B%3E%7B%5Ccolumncolor%5BHTML%5D%7BAAACED%7D%7D+p%7B3cm%7D%7D%0A%0A%5Cbegin%7Bdocument%7D%0APraesent+in+sapien.+Lorem+ipsum+dolor+sit+amet%2C+consectetuer+%0Aadipiscing+elit.+Duis+fringilla+tristique+neque.+Sed+interdum+%0Alibero+ut+metus.+Pellentesque+placerat.+Nam+rutrum+augue+a+leo.%0AMorbi+sed+elit+sit+amet+ante+lobortis+sollicitudin.%0A%0A%5Cbegin%7Btable%7D%5Bht%5D%0A%5Carrayrulecolor%5BHTML%5D%7BDB5800%7D%0A%5Ccentering%0A%5Cbegin%7Btabular%7D%7B+%7Cs%7Cp%7B2cm%7D%7Cp%7B2cm%7D%7C++%7D%0A%5Chline%0A%5Crowcolor%7Blightgray%7D+%5Cmulticolumn%7B3%7D%7B%7Cc%7C%7D%7BCountry+List%7D+%5C%5C%0A%5Chline%0ACountry+Name+or+Area+Name%26+ISO+ALPHA+2+Code+%26ISO+ALPHA+3+%5C%5C%0A%5Chline%0AAfghanistan+%26+AF+%26AFG+%5C%5C%0A%5Crowcolor%7Bgray%7D%0AAland+Islands+%26+AX++%26+ALA+%5C%5C%0AAlbania++++%26AL+%26+ALB+%5C%5C%0AAlgeria+++%26DZ+%26+DZA+%5C%5C%0AAmerican+Samoa+%26+AS+%26+ASM+%5C%5C%0AAndorra+%26+AD+%26+%5Ccellcolor%5BHTML%5D%7BAA0044%7D+AND+%5C%5C%0AAngola+%26+AO+%26+AGO+%5C%5C%0A%5Chline%0A%5Cend%7Btabular%7D%0A%5Ccaption%7BTable+inside+a+floating+element%7D%0A%5Clabel%7Btable%3Ata%7D%0A%5Cend%7Btable%7D%0A%0APraesent+in+sapien.+Lorem+ipsum+dolor+sit+amet%2C+consectetuer+%0Aadipiscing+elit.+Duis+fringilla+tristique+neque.+Sed+interdum+%0Alibero+ut+metus.+Pellentesque+placerat.+Nam+rutrum+augue+a+leo.+%0AMorbi+sed+elit+sit+amet+ante+lobortis+sollicitudin.%0A%5Cend%7Bdocument%7D)

Den følgende grafik viser outputtet produceret af Overleaf-linket:

![PositioningTnIEx7.png](/files/02e32b1eb78c3ceb6b5a5850f7dadcc5f5207cf2)

En placeringsparameter i kantede parenteser kan gives til **table** miljøet. Denne parameter kan have følgende værdier:

| Parameter | Placering                                                                                                           |
| --------- | ------------------------------------------------------------------------------------------------------------------- |
| h         | Placer floaten *her*, dvs., *omtrent* på samme sted, som den optræder i kildeteksten (dog ikke *præcist* på stedet) |
| t         | Placer ved *toppen* af siden.                                                                                       |
| b         | Placer ved *bunden* af siden.                                                                                       |
| p         | Placér på en særlig *page* kun til floats.                                                                          |
| !         | Tilsidesæt interne parametre, som LaTeX bruger til at bestemme "gode" float-placeringer.                            |
| H         | Placerer floaten på præcis den placering i LaTeX-koden. Kræver `float` pakken. Dette svarer nogenlunde til h!.      |

Du kan angive mere end én værdi i parameteren; for eksempel, hvis du skriver `[ht]` vil LaTeX forsøge at placere tabellen **her**, men hvis det ikke er muligt (der er muligvis ikke plads nok), vil tabellen blive vist ved **toppen** på siden. Det anbefales at bruge mere end én placeringsparameter for at undgå uventede resultater.

Bemærk også kommandoen `\\centering`. Dette ændrer tabeljusteringen inden i dens beholder til *centreret* i stedet for standard *left*.

&#x20;[Åbn et eksempel i Overleaf](https://www.overleaf.com/project/new/template/19663?id=66518064\&templateName=Example+of+positioning+tables+and+figures\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

### Omløb af tekst omkring en tabel

Hvis din tabel ikke optager al den tilgængelige plads, og du ønsker at placere tekst ved siden af eller før den, er det muligt med pakken `wrapfig`.

Først importerer du pakken

```latex
\usepackage{wrapfig}
```

derefter kan du bruge miljøet `wraptable` som tager to parametre: Den første er justeringen, som kan være `l`, `r`, `c`, `i` eller `eller` for henholdsvis venstre, højre, centreret, indre og ydre. Den anden er bredden af tabelbeholderen; husk, at denne sidste parameter skal være den samme som tabelens bredde, ellers er det ikke sikkert, at tingene bliver justeret korrekt.

```latex
Praesent in sapien. Lorem ipsum dolor sit amet, consectetuer
adipiscing elit. Duis fringilla tristique neque. Sed interdum
libero ut metus. Pellentesque placerat. Nam rutrum augue a leo.
Morbi sed elit sit amet ante lobortis sollicitudin.

\begin{wraptable}{r}{8cm}
\arrayrulecolor[HTML]{DB5800}
\\centering
\begin{tabular}{ |s|p{2cm}|  }
\hline
\rowcolor{lightgray} \multicolumn{2}{|c|}{Landeliste} \\
\hline
Landenavn eller områdenavn& ISO ALPHA 2-kode \\
\hline
Afghanistan & AF \\
\rowcolor{gray}
Ålandsøerne & AX \\
Albanien    &AL  \\
Algeriet   &DZ \\
Amerikansk Samoa & AS \\
Andorra & \cellcolor[HTML]{AA0044} AD   \\
Angola & AO \\
\hline
\end{tabular}
\caption{Table inside a wraptable}
\label{table:ta2}
\end{wraptable}

Praesent in sapien. Lorem ipsum dolor sit amet, consectetuer
adipiscing elit. Duis fringilla tristique neque. Sed interdum
libero ut metus. Pellentesque placerat. Nam rutrum augue a leo.
Morbi sed elit sit amet ante lobortis sollicitudin...
```

&#x20;Åbn dette `wrapfig` kodefragment i Overleaf

Den følgende grafik viser outputtet produceret af Overleaf-linket:

![PositioningTnIEx8OLV2.png](/files/8f5cf401143d324c3d35afb66bac1a5a5a1c7f5a)

## Referencevejledning

**LaTeX-enheder og længder**

| Forkortelse  | Definition                                                |
| ------------ | --------------------------------------------------------- |
| pt           | Et punkt er standardenheden for længde. Omkring 0,3515 mm |
| mm           | en millimeter                                             |
| cm           | en centimeter                                             |
| i            | en tomme                                                  |
| ex           | højden af en **x** i den aktuelle skrifttype              |
| em           | bredden af en **m** i den aktuelle skrifttype             |
| \columnsep   | afstanden mellem kolonner                                 |
| \columnwidth | kolonnens bredde                                          |
| \linewidth   | linjens bredde i det aktuelle miljø                       |
| \paperwidth  | sidens bredde                                             |
| \paperheight | sidens højde                                              |
| \textwidth   | tekstens bredde                                           |
| \textheight  | tekstens højde                                            |
| \unitlength  | længdeenheder i *picture* miljøet.                        |

## Yderligere læsning

For mere information se:

* [Tabeller](/latex/da/figurer-og-tabeller/01-tables.md)
* [Indsættelse af billeder](/latex/da/flere-emner/27-inserting-images.md)
* [Lister over tabeller og figurer](/latex/da/figurer-og-tabeller/03-lists-of-tables-and-figures.md)
* [Længder i LaTeX](/latex/da/formatering/01-lengths-in-latex.md)
* [**floatrow** pakke til avanceret håndtering af billedtekster for flydende elementer (tabeller og figurer)](http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf)
* [**sidecap** pakke-dokumentation til billedtekster ved sidefigurer](ftp://ctan.tug.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf)


---

# 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/da/figurer-og-tabeller/02-positioning-images-and-tables.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.
