> 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/flere-emner/28-inserting-images-es.md). # Indsættelse af billeder es Billeder er vigtige elementer i de fleste videnskabelige dokumenter. LaTeX giver flere muligheder for at håndtere billeder og få dem til at se ud præcis, som du har brug for. Denne artikel forklarer, hvordan man indsætter billeder i de mest almindelige formater, hvordan man gør dem mindre eller større, og hvordan man tilføjer referencer til billederne i dokumentet. ## Introduktion Her er et eksempel på, hvordan man importerer et billede i LaTeX. ```latex \documentclass{article} \usepackage{graphicx} \graphicspath{ {images/} } \begin{document} Universet er enormt, og det ser ud til at være homogent, i stor skala, overalt hvor vi kigger. \includegraphics{universe} Der er et billede af en galakse ovenfor \end{document} ``` ![InsertingImagesEx1.png](/files/a7c4e2651e2460f0ece8b22f2463023669491262) LaTeX kan ikke selv håndtere billeder, derfor skal pakken **graphicx**. For at bruge den pågældende pakke skal du tilføje følgende linje i præamblen til dit dokument ```latex \usepackage{graphicx} ``` Kommandoen `\graphicspath{ {images/} }` fortæller LaTeX, at billederne er gemt i en mappe kaldet *images* under den aktuelle mappe. Kommandoen `\includegraphics{universe}` er den, der står for at indsætte billedet i dokumentet. Her, *universe* er navnet på billedfilen uden filendelse; så *universe.PNG* bliver til *universe*. Billedfilens navn må ikke indeholde mellemrum eller flere tegnsætningstegn. Bemærk: *Man kan angive filendelsen, men det anbefales* at udelade den. Hvis filendelsen udelades, får LaTeX til opgave at søge efter alle understøttede formater. For flere detaljer, se afsnittet [Generering af billeder i høj og lav opløsning](#generando-imgenes-en-alta-y-baja-resolucin). [Åbn et eksempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Stien til billedmappen Når man arbejder på et dokument, der indeholder flere billeder, er en mulighed for at holde projektet organiseret at gemme dem i en separat mappe. I eksemplet fra introduktionen opnås dette med kommandoen `\graphicspath{ {images/} }` som fortæller LaTeX, at billederne skal søges i mappen *images*. Stien er *relativ* til den aktuelle arbejdsmappe. Stien til mappen kan være ***relativ*** (anbefalet), hvis mappen ligger i den samme mappe som den primære .tex-fil eller i en af undermapperne, eller den kan være ***absolut*** hvis det er nødvendigt at angive den præcise sti. For eksempel: ```latex %Absolut sti i Windows-format: \graphicspath{ {c:/user/images/} } %Absolut sti i Unix-lignende format (Linux, OsX) \graphicspath{ {/home/user/images/} } ``` Bemærk, at denne kommando kræver en højre skråstreg `/` i slutningen, og at stien skal skrives mellem to sæt klammer. Det er også muligt at angive flere stier, hvis du har gemt billederne i mere end én mappe for bedre organisering. Hvis der for eksempel er to mapper, en kaldet *images1* og den anden *images2*, bruges kommandoen ```latex \graphicspath{ {images1/}{images2/} } ``` Hvis der ikke angives nogen sti, søger LaTeX efter billederne i den aktuelle mappe, hvor .tex-filen er gemt. [Åbn eksempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Ændring af størrelse og rotation af et billede Hvis man vil angive ekstra parametre, når man importerer et billede i LaTeX for at ændre billedets bredde, højde, placering osv., er dette muligt ved hjælp af følgende syntaks: ```latex Overleaf er et fantastisk professionelt værktøj til at redigere online, dele og sikkerhedskopiere dine \LaTeX-projekter. Det tilbyder også omfattende hjælpedokumentation. \includegraphics[scale=1.5]{lion-logo} ``` ![InsertingImagesEx2.png](/files/458f9d53908ea28f9cfae683e7b41041d7ac2842) Kommandoen `\includegraphics[scale=1.5]{lion-logo}` inkluderer billedet *lion-logo* i dokumentet, den ekstra parameter `scale=1.5` skalerer billedet til 1,5 gange dets oprindelige størrelse. Det er også muligt at ændre billedets størrelse til en given højde og bredde. ```latex Overleaf er et fantastisk professionelt værktøj til at redigere online, dele og sikkerhedskopiere dine \LaTeX-projekter. Det tilbyder også omfattende hjælpedokumentation. \includegraphics[width=3cm, height=4cm]{lion-logo} ``` ![InsertingImagesEx3.png](/files/a31e1af247dbef866ede9099292a4a8a2c845e6c) Som du sikkert allerede har gættet, definerer parametrene inden i firkantede parenteser `[width=3cm, height=4cm]` billedets bredde og højde. Der kan bruges [forskellige måleenheder](#gua-de-referencia) i disse parametre. Hvis kun værdien af *width*, angives, skaleres højden proportionalt for at bevare billedets proportioner. Det er også muligt at angive billedets længde i forhold til andre elementer i dokumentet. Hvis du for eksempel vil have, at billedet skal have samme bredde som teksten: ```latex Overleaf er et fantastisk professionelt værktøj til at redigere online, dele og sikkerhedskopiere dine \LaTeX-projekter. Det tilbyder også omfattende hjælpedokumentation. \includegraphics[width=\textwidth]{universe} ``` ![InsertingImagesEx5.png](/files/e00cdebc7a3389960ec5539856cbbfc910ab6991) I stedet for `\textwidth` kan du bruge enhver anden af de enheder, som LaTeX inkluderer som standard: *\columnsep, \linewidth, \textheight, \paperheight, osv*. Se [referenceguiden](#gua-de-referencia) for en bedre beskrivelse af enhederne. Der er også en meget almindelig mulighed, når man inkluderer billeder i et dokument: at kunne rotere dem. Dette er meget nemt i LaTeX: ```latex Overleaf er et fantastisk professionelt værktøj til at redigere online, dele og sikkerhedskopiere dine \LaTeX-projekter. Det tilbyder også omfattende hjælpedokumentation. \includegraphics[scale=1.2, angle=45]{lion-logo} ``` ![InsertingImagesEx4.png](/files/da5cb1526dd3da162df07a55c8d349876cc0606b) Parameteren `angle=45` roterer billedet 45 grader mod uret. For at rotere billedet med uret skal du bruge et negativt tal. [Åbn et eksempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Placering af billedet I det forrige afsnit blev det forklaret, hvordan man indsætter et billede i dokumentet, men nogle gange bliver kombinationen af billeder og tekst i dokumentet måske ikke, som du havde forventet. For at ændre dette er det nødvendigt at bruge et nyt miljø: ```latex I det næste eksempel vil figuren blive placeret lige under denne sætning. \begin{figure}[h] \includegraphics[width=8cm]{Plot} \\end{figure} ``` ![InsertingImagesEx6.png](/files/12135e9718be1e2810c63756b2727a9e4a39072f) Miljøet `figure` bruges til at vise billeder som flydende elementer i dokumentet. Dette betyder, at det er nok at inkludere dit billede i miljøet *figure* og du behøver ikke længere bekymre dig om, hvor det kommer til at vises; LaTeX vil placere det, så det passer perfekt ind i dokumentets flow. Selvom dette i princippet lyder rigtig godt, vil man nogle gange have mere kontrol over, hvor billederne vises. En ekstra parameter kan bruges til at bestemme figurens placering. I eksemplet, `begin{figure}[h]`, angiver parameteren i firkantede parenteser figurens placering *her* (her, på engelsk). Nedenfor er en tabel med en liste over mulige placeringsværdier. | Parameter | Placering | | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | h | Angiver det flydende elements placering som «her». Det vil sige omtrent på samme sted, som det optræder i koden (dog er placeringen ikke altid helt præcis) | | t | Indsætter figuren øverst på siden. | | b | Indsætter figuren nederst på siden. | | p | Indsætter de flydende elementer på en separat side, som kun indeholder figurer. | | ! | Overskriver de parametre, som LaTeX bruger til at bestemme en «god» placering for billedet. | | H | Angiver det flydende element præcis det samme sted, som det vises i koden; det kræver import af pakken `float`. Det svarer til en vis grad til h!. | I det følgende eksempel kan man se et billede, der vises i begyndelsen af dokumentet, selvom koden, der genererer det, findes i slutningen af dokumentet. ```latex På dette billede kan du se et søjlediagram, som viser resultaterne af en undersøgelse, der omfattede nogle vigtige data, der blev studeret, mens tiden gik. \begin{figure}[t] \includegraphics[width=8cm]{Plot} \\centering \\end{figure} ``` ![InsertingImagesEx7.png](/files/02d2ef2c7fe652fd195de243d2839eed0d00b9a5) Den ekstra kommando `\\centering` står for at centrere billedet. Standardjusteringen er til venstre. Det er også muligt at lade teksten løbe rundt om figuren. Når dokumentet indeholder små billeder, får dette teksten til at se bedre ud. ```latex \begin{wrapfigure}{r}{0.25\textwidth} %this figure will be at the right \\centering \includegraphics[width=0.25\textwidth]{mesh} \end{wrapfigure} Der er flere måder at plotte en funktion af to variabler på, afhængigt af den information, du er interesseret i. For eksempel, hvis du vil se gitteret af en funktion, så det er lettere at se afledte, kan du bruge et plot som det til venstre. \begin{wrapfigure}{l}{0.25\textwidth} \\centering \includegraphics[width=0.25\textwidth]{contour} \end{wrapfigure} På den anden side, hvis du kun er interesseret i bestemte værdier, kan du bruge konturplottet, du kan bruge konturplottet, du kan bruge konturen plottet, du kan bruge konturplottet, du kan bruge konturplottet, du kan bruge konturplottet, du kan bruge konturplottet, ligesom det til venstre. På den anden side, hvis du kun er interesseret i bestemte værdier, kan du bruge konturplottet, du kan bruge konturplottet, du kan bruge konturen plottet, du kan bruge konturplottet, du kan bruge konturplottet, du kan bruge konturplottet, du kan bruge konturplottet, ligesom det til venstre. ``` ![InsertingImagesEx8.png](/files/b0cd1d5c504da58a2981694136b042dffa0bc93e) For at kommandoerne i eksemplet skal fungere, skal pakken **wrapfig**. Tilføj følgende linje i præamblen ```latex \usepackage{wrapfig} ``` Når pakken er importeret, kan man bruge miljøet *wrapfigure* ved hjælp af kommandoen `\begin{wrapfigure}{l}{0.25\textwidth} \end{wrapfigure}`. Bemærk, at miljøet har to ekstra parametre mellem klammerne. Nedenfor forklares koden mere detaljeret. **{l}** Angiver figurens justering. Brug l for venstre og r for højre. Desuden, hvis man bruger klassen book eller en lignende, kan man i stedet for l og r bruge o for den ydre kant og i for den indre kant af siden. **{0.25\textwidth}** Dette angiver bredden på boksen, der indeholder billedet. Det er ikke selve billedets bredde; den skal angives i kommandoen includegraphics. I eksemplet bruges relative enheder, men almindelige enheder (cm, mm, in osv.) kan også bruges. Se referenceguiden for en liste over mulige enheder. **\\\centering** Som forklaret tidligere, men i det forrige eksempel vil billedet blive centreret i forhold til boksen, der indeholder det, i stedet for i forhold til siden. For mere fuldstændig information om billedplacering, se artiklen [Placering af billeder og tabeller](/latex/da/figurer-og-tabeller/02-positioning-images-and-tables.md) [Åbn eksempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Tilføj etiketter, billedtekster og referencer At kunne tilføje billedtekster med en kort beskrivelse af billedet og etiketter, som senere kan bruges til at henvise til billedet, er meget nyttige værktøjer, når man arbejder med meget lange dokumenter. ### Billedtekster Lad os starte med et eksempel på, hvordan man tilføjer en billedtekst: ```latex \begin{figure}[h] \caption{Eksempel på et parametrisk plot ($\sin (x), \cos(x), x$)} \\centering \includegraphics[width=0.5\textwidth]{spiral} \\end{figure} ``` ![InsertingImagesEx9.png](/files/141541503b5f694bb97b0129017263ee5bf5bbee) Det er meget nemt, man skal blot tilføje kommandoen `\caption{En billedtekst}` og skrive teksten, der skal vises, mellem klammerne. Hvor billedteksten udskrives, afhænger af, hvor kommandoen indsættes; hvis den står over kommandoen *includegraphics* så vises billedteksten over billedet; hvis den står under den kommando, vises billedteksten nederst i figuren. Billedtekster kan også placeres ved siden af figurerne. Pakken **sidecap** gør det muligt at bruge en meget lignende kode som i det forrige eksempel til at tilføje teksten. ```latex \documentclass{article} \usepackage[rightcaption]{sidecap} \usepackage{graphicx} %pakke til håndtering af billeder \graphicspath{ {images/} } \begin{SCfigure}[0.5][h] \caption{Eksempel på et parametrisk plot. Denne billedtekst vil være til højre} \includegraphics[width=0.6\textwidth]{spiral} \end{SCfigure} ``` ![InsertingImagesEx10.png](/files/e7925eb6f9f5c9e70bb2ef0a29102d437bf9929a) Der er to nye kommandoer i dette eksempel: **\usepackage\[rightcaption]{sidecap}** Som du måske allerede ved, importerer denne kommando pakken kaldet sidecap, men der er en ekstra parameter: rightcaption. Denne parameter angiver det sted, hvor billedteksten udskrives. I dette tilfælde til højre for billedet; det er også muligt at bruge leftcaption til at flytte billedteksten til venstre. I dokumenter, der bruger bogklasser, kan man desuden bruge outercaption og innercaption til at udskrive billedteksten på den ydre eller indre side i forhold til sidens kant. **\begin{SCfigure}\[0.5]\[h] \end{SCfigure}** Definerer et miljø, der ligner figure. Den første parameter er billedteksternes bredde i forhold til billedets størrelse. Den anden parameter h har samme funktion som i figure-miljøet. Se afsnittet om placering af billeder for mere information. Man kan opnå en mere avanceret håndtering af billedteksternes format, hvis man ønsker det. Se de [yderligere læsninger](#lecturas-adicionales) for flere referencer. ### Etiketter og krydsreferencer Figurer, ligesom mange andre elementer i et LaTeX-dokument (ligninger, tabeller, grafer osv.), kan henvises til inde fra teksten. Det er meget let at gøre dette, man skal blot tilføje en etiket til miljøet *figure* eller *SCfigure*, og derefter bruge den etiket til at henvise til figuren. ```latex \begin{figure}[h] \\centering \includegraphics[width=0.25\textwidth]{mesh} \caption{en pæn graf} \label{fig:mesh1} \\end{figure} Som du kan se i figur \ref{fig:mesh1}, vokser funktionen nær 0. Også på side \pageref{fig:mesh1} er det samme eksempel. ``` ![InsertingImagesEx11.png](/files/9ad3f39e2c3a5535fcc91c80c4392f5a0289d926) Der er tre kommandoer i dette eksempel, som genererer krydsreferencer. **\label{fig:mesh1}** Angiver etiketten for figuren. Da etiketter kan bruges i forskellige typer elementer i dokumentet, er det god praksis at bruge et præfiks, såsom fig: i eksemplet. **\ref{fig:mesh1}** Denne kommando udskriver det nummer, som figuren fik tildelt. Numrene genereres automatisk og opdateres, hvis der senere indsættes en figur før den, der henvises til. **\pageref{fig:mesh1}** Udskriver sidenummeret, hvor det billede, der henvises til via etiketten, vises. Kommandoen `\caption` som tilføjer en billedtekst, er obligatorisk for at kunne tilføje en etiket og henvise til figuren. En anden vigtig funktion i LaTeX er muligheden for automatisk at generere en *liste over figurer*. Dette gøres let med: ```latex \listoffigures ``` ![InsertingImagesEx12.png](/files/710080fec97c0df68df6a420c99c970aca4aee77) Denne kommando fungerer kun med figurer, der har en billedtekst, da den bruger den til at generere tabellen. Det forrige eksempel lister de billeder, der bruges i denne artikel. Vigtig bemærkning: *Når man bruger krydsreferencer i LaTeX, skal projektet kompileres to gange, ellers vil referencerne, sidereferencerne og figurlisten ikke fungere*. [Åbn et eksempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Generering af billeder i høj og lav opløsning Foreløbig, når vi angiver filnavnet til billedet i kommandoen *\includegraphics* udelader vi filendelsen. Det er dog ikke nødvendigt, selvom det kan være meget nyttigt. Hvis filendelsen udelades, vil LaTeX søge efter enhver understøttet billedtype i den forudindstillede billedmappe; søgningen udføres i en bestemt rækkefølge, som kan ændres. Dette er meget nyttigt, når man skal gå fra dokumentets kladdeversion til den endelige version. I kladden (mens du skriver din artikel, bog, rapport osv.) er det ønskeligt at kunne bruge billeder i lav opløsning (typisk i .png-format), så dokumentet kompileres hurtigere. I den endelige version foretrækker man derimod at inkludere billeder i høj opløsning for at få et dokument af høj kvalitet. Dette kan opnås ved: * Ikke at angive filendelsen i kommandoen *\includegraphics*, og * Angivelse af rækkefølgen af filendelserne i præamblen Så hvis man har to versioner af det samme billede, for eksempel venndiagram.pdf (i høj opløsning) og venndiagram.png (i lav opløsning), kan man tilføje følgende linje i præamblen, mens dokumentet skrives og fejlrettes - ```latex \DeclareGraphicsExtensions{.png,.pdf} ``` Den ovenstående kommando sikrer, at hvis der findes to billeder med samme navn men med forskellige filendelser, så bruges .png-filen, og hvis denne fil af en eller anden grund forsvinder, bliver pdf-versionen næste valg. Når dokumentet er skrevet færdigt, og kun højopløsningsversionen skal bruges, skal den linje, der bestemmer filendelsen, ændres til: ```latex \DeclareGraphicsExtensions{.pdf,.png} ``` Man kan endda forbedre den teknik, der er beskrevet ovenfor; man kan bede LaTeX om at generere .png-billeder i lav opløsning, mens dokumentet kompileres, hvis PDF'en ikke tidligere er blevet konverteret til PNG. For at opnå dette skal følgende inkluderes i præamblen efter `\usepackage{graphicx}`. ```latex \usepackage{epstopdf} \epstopdfDeclareGraphicsRule{.pdf}{png}{.png}{convert #1 \OutputFile} \DeclareGraphicsExtensions{.png,.pdf} ``` Hvis venndiagram2.pdf findes, men ikke venndiagram2.png, vil filen vendiagramm2-pdf-converted-to.png blive oprettet og indlæst i stedet. Kommandoen *convert #1* er ansvarlig for konverteringen Der er et par ting, man skal have i baghovedet, hvis man vælger denne metode: * For at den automatiske konvertering skal fungere, skal man køre *pdflatex* med optionen `--shell-escape`. * For den endelige version må man ikke glemme at kommentere linjen `\epstopdfDeclareGraphicsRule`, så kun højopløsningsbillederne indlæses. Man skal også huske at ændre præcedensrækkefølgen. [Åbn eksempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Referenceguide **Enheder og mål i LaTeX** | Forkortelse | Definition | | ------------ | --------------------------------------------------- | | pt | Et punkt er standard længdeenheden. Cirka 0,3515 mm | | mm | en millimeter | | cm | en centimeter | | i | en tomme | | ex | højden af en **x** med den aktuelle skrifttype | | em | bredden af en **m** med den aktuelle skrifttype | | \columnsep | afstand mellem kolonnerne | | \columnwidth | bredden af en kolonne | | \linewidth | linjebredden i det aktuelle miljø | | \paperwidth | papirets bredde | | \paperheight | papirets højde | | \textwidth | tekstbredden | | \textheight | teksthøjden | | \unitlength | længdeenheder i miljøet *picture* | **Om de billedtyper, der kan bruges i LaTeX** **LaTeX** Hvis dokumentet kompileres med kommandoen latex, kan der kun bruges billeder i EPS-format, som er et vektorformat. **pdflatex** Hvis dokumentet kompileres med kommandoen pdflatex for at producere en PDF, kan der bruges flere billede-typer- ``` JPG: Det bedste valg til indsættelse af fotografier PNG: Det bedste valg til indsættelse af diagrammer (hvis du af en eller anden grund ikke kan bruge en vektorgrafik) og skærmbilleder PDF: På trods af vanen med at bruge PDF til dokumenter kan en PDF i almindelighed bestå af blot ét billede, som derefter kan importeres. EPS: EPS-billeder kan inkluderes ved hjælp af pakken epstopdf (pakken skal kun installeres på computeren; når den først er installeret, er der ikke brug for nogen ekstra kommando i .tex-filen) ``` **Vektorgrafik eller bitmapgrafik?** Billeder kan inkluderes enten i bitmapformat eller som vektorgrafik. Generelt behøver man ikke bekymre sig om det, men hvis man har mulighed for at vælge et format, skal man huske, at for vektorgrafik er det bedst at gemme den i PDF- eller EPS-format, mens JPG- eller PNG-formaterne anbefales til bitmapgrafik. Dette skyldes, at en bitmap i en fil i PDF- eller EPS-format kræver meget plads til lagring. [Åbn eksempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Yderligere læsning For mere information, se: * [Placering af billeder og tabeller](/latex/da/figurer-og-tabeller/02-positioning-images-and-tables.md) * [Lister over tabeller og figurer](/latex/da/figurer-og-tabeller/03-lists-of-tables-and-figures.md) * [Ensidede og dobbeltsidede dokumenter](/latex/da/formatering/08-single-sided-and-double-sided-documents.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) * [**epstopdf** pakke-dokumentation (PDF-til-EPS-konvertering)](https://www.google.com/url?sa=t\&rct=j\&q=\&esrc=s\&source=web\&cd=3\&cad=rja\&ved=0CEEQFjAC\&url=http%3A%2F%2Fmirror.hmc.edu%2Fctan%2Fmacros%2Flatex%2Fcontrib%2Foberdiek%2Fepstopdf.pdf\&ei=N4v2UpK7D4eHqQHz2IDACg\&usg=AFQjCNG9CxIXjrbc22kl-8QweEXeEauFew\&sig2=qamKo3qpid8CEqzsHhpIrQ\&bvm=bv.60983673,d.aWM) --- # 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/flere-emner/28-inserting-images-es.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.