> 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/sv/fler-amnen/28-inserting-images-es.md).

# Infoga bilder es

Bilder är väsentliga element i de flesta vetenskapliga dokument. LaTeX erbjuder flera alternativ för att hantera bilder och få dem att se ut exakt som du behöver. I den här artikeln förklaras hur man inkluderar bilder i de vanligaste formaten, hur man gör dem mindre eller större och hur man lägger till referenser till bilderna i dokumentet.

## Introduktion

Här följer ett exempel på hur man importerar en bild i LaTeX.

```latex
\documentclass{article}
\usepackage{graphicx}
\graphicspath{ {images/} }

\begin{document}
Universum är enormt och det verkar vara homogent,
i stor skala, överallt där vi tittar.

\includegraphics{universe}

Det finns en bild av en galax ovanför
\end{document}
```

![InsertingImagesEx1.png](/files/26dd4359a2da18a0cd898271fce482b4362b9b4b)

LaTeX kan inte manipulera bilder på egen hand, därför måste paketet importeras **graphicx**. För att använda det paketet lägger du till följande rad i preamblen till ditt dokument

```latex
\usepackage{graphicx}
```

Kommandot `\graphicspath{ {images/} }` anger för LaTeX att bilderna är sparade i en mapp som heter *images* under den aktuella katalogen.

Kommandot `\includegraphics{universe}` är det som ansvarar för att infoga bilden i dokumentet. Här, *universe* är namnet på bildfilen, utan filändelsen; så *universe.PNG* blir till *universe*. Bildfilens namn får inte innehålla blanksteg eller flera skiljetecken.

Obs: *Filändelsen kan anges, men det rekommenderas* att utelämna den. Om filändelsen utelämnas kommer LaTeX att söka efter alla format som stöds. För mer information se avsnittet [Att generera bilder i hög och låg upplösning](#generando-imgenes-en-alta-y-baja-resolucin).

&#x20; [Öppna ett exempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex)

## Sökvägen till bildmappen

När man arbetar med ett dokument som innehåller flera bilder är ett sätt att hålla projektet organiserat att spara dem i en separat mapp.

I introduktionsexemplet uppnås detta med kommandot `\graphicspath{ {images/} }` som talar om för LaTeX att bilderna ska sökas i mappen *images*. Sökvägen är *relativ* till den aktuella arbetskatalogen.

Sökvägen till mappen kan vara ***relativ*** (rekommenderas) om mappen finns i samma katalog som huvud-.tex-filen eller i någon av undermapparna, eller så kan den vara ***absolut*** om man behöver ange sökvägen exakt. Till exempel:

```latex
%Absolut sökväg i Windows-format:
\graphicspath{ {c:/user/images/} }

%Absolut sökväg i Unix-liknande format (Linux, OsX)
\graphicspath{ {/home/user/images/} }
```

Observera att detta kommando kräver ett snedstreck `/` i slutet och att sökvägen ska skrivas mellan två par klammerparenteser.

Det är också möjligt att ange flera sökvägar om du sparade bilderna i mer än en mapp för bättre organisation. Till exempel, om det finns två mappar, en som heter *images1* och den andra *images2*, använd kommandot

```latex
\graphicspath{ {images1/}{images2/} }</code>
```

Om ingen sökväg anges kommer LaTeX att söka efter bilderna i den aktuella mappen där .tex-filen är sparad.

&#x20; [Öppna exempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex)

## Ändra storlek på och rotera en bild

Om man vill ange ytterligare parametrar när man importerar en bild i LaTeX för att ändra bildens bredd, höjd, position osv. är detta möjligt med följande syntax:

```latex
Overleaf är ett utmärkt professionellt verktyg för att redigera online,
dela och säkerhetskopiera dina \LaTeX-projekt. Det erbjuder också en
ganska omfattande hjälpdokumentation.

\includegraphics[scale=1.5]{lion-logo}
```

![InsertingImagesEx2.png](/files/13c8f884e09837f0af2097f4b6a3217f3a02f1f2)

Kommandot `\includegraphics[scale=1.5]{lion-logo}` inkluderar bilden *lion-logo* i dokumentet, den extra parametern `scale=1.5` skalar bilden till 1,5 gånger dess ursprungliga storlek.

Det är också möjligt att ändra bildens storlek till en bestämd höjd och bredd.

```latex
Overleaf är ett utmärkt professionellt verktyg för att redigera online,
dela och säkerhetskopiera dina \LaTeX-projekt. Det erbjuder också en
ganska omfattande hjälpdokumentation.

\includegraphics[width=3cm, height=4cm]{lion-logo}
```

![InsertingImagesEx3.png](/files/cf152f85cf01f15eb49b1e2359b2c632fee38ff9)

Som du säkert redan har gissat, definierar parametrarna inom hakparenteserna `[width=3cm, height=4cm]` bildens bredd och höjd. Man kan använda [olika enheter](#gua-de-referencia) i dessa parametrar. Om endast värdet för *width*, kommer höjden att skalas proportionellt för att bevara bildens proportioner.

Det är också möjligt att ange bildens längd i förhållande till andra element i dokumentet. Om du till exempel vill att bilden ska ha samma bredd som texten:

```latex
Overleaf är ett utmärkt professionellt verktyg för att redigera online,
dela och säkerhetskopiera dina \LaTeX-projekt. Det erbjuder också en
ganska omfattande hjälpdokumentation.

\includegraphics[width=\textwidth]{universe}
```

![InsertingImagesEx5.png](/files/b33ddbb7822a1aebe7bccc23500da73aa9614545)

I stället för `\textwidth` kan du använda någon av de andra enheter som LaTeX innehåller som standard: *\columnsep, \linewidth, \textheight, \paperheight, etc*. Se [referensguiden](#gua-de-referencia) för en bättre beskrivning av enheterna.

Ett annat mycket vanligt alternativ när man lägger till bilder i ett dokument är att kunna rotera dem. Detta är mycket enkelt i LaTeX:

```latex
Overleaf är ett utmärkt professionellt verktyg för att redigera online,
dela och säkerhetskopiera dina \LaTeX-projekt. Det erbjuder också en
ganska omfattande hjälpdokumentation.

\includegraphics[scale=1.2, angle=45]{lion-logo}
```

![InsertingImagesEx4.png](/files/ef2133bea9853b8de93345ad1af88ca9f807df83)

Parametern `angle=45` roterar bilden 45 grader moturs. För att rotera bilden medurs använder du ett negativt tal.

&#x20; [Öppna ett exempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex)

## Placera bilden

I föregående avsnitt förklarades hur man infogar en bild i dokumentet, men ibland kanske kombinationen av bilder och text i dokumentet inte blir som du förväntade dig. För att ändra detta behöver man använda en ny miljö:

```latex
I nästa exempel kommer figuren att placeras
precis under denna mening.

\begin{figure}[h]
\includegraphics[width=8cm]{Plot}
\end{figure}
```

![InsertingImagesEx6.png](/files/43015589873ee9d6ba90f37bd14065730a7ed41c)

Miljön `figure` används för att visa bilder som flytande objekt i dokumentet. Det betyder att det räcker att lägga in bilden i miljön *figure* och att du inte längre behöver oroa dig för var den kommer att hamna; LaTeX placerar den så att den passar perfekt in i dokumentets flöde.

Även om detta i princip låter mycket bra vill man ibland ha mer kontroll över var bilderna visas. En extra parameter kan användas för att ange figurens placering. I exemplet, `begin{figure}[h]`, anger parametern inom hakparenteserna figurens position *här* (här, på engelska). Nedan följer en tabell med en lista över möjliga placeringsvärden.

| Parameter | Position                                                                                                                                             |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| h         | Anger det flytande objektets position «här». Det vill säga ungefär på samma plats där det förekommer i koden (placeringen är dock inte alltid exakt) |
| t         | Infogar figuren i början av sidan.                                                                                                                   |
| b         | Infogar figuren i slutet av sidan.                                                                                                                   |
| p         | Infogar de flytande objekten på en separat sida som endast innehåller figurer.                                                                       |
| !         | Åsidosätter de parametrar som LaTeX använder för att bestämma en «bra» placering för bilden.                                                         |
| H         | Placerar det flytande objektet exakt på samma plats som det förekommer i koden; paketet `float`. Det är till viss del likvärdigt med h!.             |

I följande exempel kan man se en bild som visas i början av dokumentet, trots att koden som skapar den finns i slutet av dokumentet.

```latex
I denna bild kan du se ett stapeldiagram som visar
resultaten av en undersökning som omfattade några viktiga
data som studerades allt eftersom tiden gick.

\begin{figure}[t]
\includegraphics[width=8cm]{Plot}
\centering
\end{figure}
```

![InsertingImagesEx7.png](/files/ab0061eb3aac5386535c3bbfa77d06c6ab28d25f)

Det extra kommandot `\centering` ansvarar för att centrera bilden. Standardvärdet för justering är vänster.

Det är också möjligt att låta texten flyta runt figuren. När dokumentet innehåller små bilder gör detta att texten ser bättre ut.

```latex
\begin{wrapfigure}{r}{0.25\textwidth} %denna figur kommer att vara till höger
    \centering
    \includegraphics[width=0.25\textwidth]{mesh}
\end{wrapfigure}

Det finns flera sätt att plotta en funktion av två variabler,
beroende på vilken information du är intresserad av. Till
exempel, om du vill se nätet för en funktion så att det
är lättare att se derivatan kan du använda en graf som
den till vänster.

\begin{wrapfigure}{l}{0.25\textwidth}
    \centering
    \includegraphics[width=0.25\textwidth]{contour}
\end{wrapfigure}

Å andra sidan, om du bara är intresserad av
vissa värden kan du använda konturdiagrammet, du
kan använda konturdiagrammet, du kan använda kontur
diagrammet, du kan använda konturdiagrammet, du kan
använda konturdiagrammet, du kan använda konturdiagrammet,
du kan använda konturdiagrammet, som det till vänster.

Å andra sidan, om du bara är intresserad av
vissa värden kan du använda konturdiagrammet, du
kan använda konturdiagrammet, du kan använda kontur
diagrammet, du kan använda konturdiagrammet, du kan använda
konturdiagrammet, du kan använda konturdiagrammet,
du kan använda konturdiagrammet,
som det till vänster.
```

![InsertingImagesEx8.png](/files/c103cd34f82f9f1cc23d34ebe3618b869d8f17d7)

För att kommandona i exemplet ska fungera måste paketet importeras **wrapfig**. Lägg till raden i preamblen

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

När paketet har importerats kan miljön användas *wrapfigure* med kommandot `\begin{wrapfigure}{l}{0.25\textwidth} \end{wrapfigure}`. Observera att miljön har två ytterligare parametrar inom klamrar. Nedan förklaras koden mer i detalj.

**{l}**

Anger figurens justering. Använd l för vänster och r för höger. Dessutom, om bokklassen book eller en liknande klass används, kan man i stället för l och r använda o för sidans ytterkant och i för sidans innerkant.

**{0.25\textwidth}**

Detta anger bredden på lådan som innehåller bilden. Det är inte bildens egen bredd; den ska anges i kommandot includegraphics. I exemplet används relativa enheter, men vanliga enheter (cm, mm, in osv.) kan användas. Se referensguiden för en lista över möjliga enheter.

**\centering**

Som tidigare förklarats kommer bilden i föregående exempel att centreras i förhållande till den omgivande lådan, i stället för att centreras i förhållande till sidan.

För mer fullständig information om bildplacering, se artikeln [Placering av bilder och tabeller](/latex/sv/figurer-och-tabeller/02-positioning-images-and-tables.md)

&#x20; [Öppna exempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex)

## Lägg till etiketter, bildtexter och referenser

Att kunna lägga till bildtexter med en kort beskrivning av bilden och etiketter som senare kan användas för att hänvisa till bilden är mycket användbara verktyg när man arbetar med mycket långa dokument.

### Bildtexter

Låt oss börja med ett exempel på hur man lägger till en bildtext:

```latex
\begin{figure}[h]
\caption{Exempel på en parametrisk graf ($\sin (x), \cos(x), x$)}
\centering
\includegraphics[width=0.5\textwidth]{spiral}
\end{figure}
```

![InsertingImagesEx9.png](/files/7d8709754aadd760b9865b3a37813872a255c225)

Det är mycket enkelt, det enda man behöver göra är att lägga till kommandot `\caption{En bildtext}` och skriva texten som ska visas inom klamrarna. Var bildtexten skrivs ut beror på var kommandot infogas; om det står ovanför kommandot *includegraphics* kommer bildtexten att visas ovanför bilden, och om det står under det kommandot kommer bildtexten att visas längst ned i figuren.

Bildtexter kan också placeras bredvid figurerna. Paketet **sidecap** gör det möjligt att använda kod som är mycket lik den i föregående exempel för att lägga till texten.

```latex
\documentclass{article}
\usepackage[rightcaption]{sidecap}

\usepackage{graphicx} %paket för att hantera bilder
\graphicspath{ {images/} }

\begin{SCfigure}[0.5][h]
\caption{Exempel på en parametrisk graf.
         Denna bildtext kommer att vara till höger}
\includegraphics[width=0.6\textwidth]{spiral}
\end{SCfigure}
```

![InsertingImagesEx10.png](/files/fb6c509f1bf1ffe73000e05ffa33e60e7012903a)

Det finns två nya kommandon i detta exempel:

**\usepackage\[rightcaption]{sidecap}**

Som du kanske redan vet importerar detta kommando paketet sidecap, men det finns en extra parameter: rightcaption. Det är denna parameter som anger var bildtexten skrivs ut. I detta fall till höger om bilden. Det är också möjligt att använda leftcaption för att flytta bildtexten till vänster. I dokument som använder bokliknande klasser kan man dessutom använda alternativen outercaption och innercaption för att skriva bildtexten på utsidan eller insidan i förhållande till sidans kant.

**\begin{SCfigure}\[0.5]\[h] \end{SCfigure}**

Definierar en miljö liknande figure. Den första parametern är bildtextens bredd i förhållande till bildens storlek. Den andra parametern h har samma funktion som i miljön figure. Se avsnittet om bildplacering för mer information.

Man kan uppnå mer avancerad hantering av bildtextformat om så önskas. Se [ytterligare läsning](#lecturas-adicionales) för fler referenser.

### Etiketter och korsreferenser

Figurer, liksom många andra element i ett LaTeX-dokument (ekvationer, tabeller, grafer osv.), kan hänvisas till inifrån texten. Det är mycket enkelt att göra detta, det enda man behöver göra är att lägga till en etikett till miljön *figure* eller *SCfigure*, och sedan använda den etiketten för att hänvisa till figuren.

```latex
\begin{figure}[h]
    \centering
    \includegraphics[width=0.25\textwidth]{mesh}
    \caption{en fin graf}
    \label{fig:mesh1}
\end{figure}

Som du kan se i figur \ref{fig:mesh1} är
funktionen växer nära 0. Även på sidan \pageref{fig:mesh1}
finns samma exempel.
```

![InsertingImagesEx11.png](/files/af6ec1897dd1e8b3b7c1bc891e01205eec9992a4)

Det finns tre kommandon i detta exempel som genererar korsreferenser.

**\label{fig:mesh1}**

Anger etiketten för figuren. Eftersom etiketter kan användas på olika typer av element i dokumentet är det en god praxis att använda ett prefix, såsom fig: i exemplet.

**\ref{fig:mesh1}**

Detta kommando skriver ut numret som tilldelats figuren. Numren genereras automatiskt och uppdateras om en figur senare infogas före den som det hänvisas till.

**\pageref{fig:mesh1}**

Skriver ut sidnumret där bilden som etiketten hänvisar till förekommer.

Kommandot `\caption` som lägger till en bildtext är obligatoriskt för att kunna lägga till en etikett och hänvisa till figuren.

En annan viktig funktion i LaTeX är möjligheten att automatiskt generera en *figurlista*. Detta görs enkelt med:

```latex
\listoffigures
```

![InsertingImagesEx12.png](/files/c0c5356b7f2f44e2745d407231d1f8ecb8345799)

Detta kommando fungerar endast med figurer som har en bildtext, eftersom den används för att generera listan. Föregående exempel listar bilderna som används i denna artikel.

Viktig anmärkning: *När korsreferenser används i LaTeX måste projektet kompileras två gånger; annars kommer referenserna, sidreferenserna och figurlistan inte att fungera*.

&#x20; [Öppna ett exempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex)

## Att generera bilder i hög och låg upplösning

För tillfället, när vi anger bildfilens namn i kommandot *\includegraphics* utelämnar vi filändelsen. Det är dock inte nödvändigt, även om det kan vara mycket användbart. Om filändelsen utelämnas kommer LaTeX att söka efter alla bildtyper som stöds i den förinställda bildkatalogen; sökningen görs i en viss ordning, vilken kan ändras.

Detta är mycket användbart för att gå från utkastversionen av dokumentet till slutversionen. I utkastet (medan du skriver din artikel, bok, rapport osv.) är det önskvärt att kunna använda bilder med låg upplösning (typiskt i .png-format) så att dokumentet kompileras snabbare. I slutversionen föredrar man däremot att inkludera bilderna i hög upplösning för att få ett dokument av hög kvalitet.

Detta kan uppnås genom:

* Att inte ange filändelsen i kommandot *\includegraphics*, och
* Att ange ordningen på filändelserna i preamblen

Så om man har två versioner av samma bild, till exempel venndiagram.pdf (i hög upplösning) och venndiagram.png (i låg upplösning), kan följande rad läggas till i preamblen medan dokumentet skrivs och felsöks -

```latex
  \DeclareGraphicsExtensions{.png,.pdf}
```

Det föregående kommandot säkerställer att om två bilder med samma namn men olika filändelser hittas, så kommer .png-filen att användas, och om denna fil av någon anledning försvinner blir pdf-versionen nästa alternativ.

När dokumentet har skrivits färdigt ska man, för att endast använda versionen i hög upplösning, ändra raden som bestämmer filändelsen till:

```latex
  \DeclareGraphicsExtensions{.pdf,.png}
```

Man kan till och med förbättra tekniken som beskrivits ovan; vi kan be LaTeX att generera .png-bilder med låg upplösning medan dokumentet kompileras om PDF-filen inte redan har konverterats till PNG. För att göra detta ska följande inkluderas i preamblen efter `\usepackage{graphicx}`.

```latex
  \usepackage{epstopdf}
  \epstopdfDeclareGraphicsRule{.pdf}{png}{.png}{convert #1 \OutputFile}
  \DeclareGraphicsExtensions{.png,.pdf}
```

Om venndiagram2.pdf finns men inte venndiagram2.png, kommer filen vendiagramm2-pdf-converted-to.png att skapas och laddas i dess ställe. Kommandot *convert #1* ansvarar för konverteringen

Det finns ett par saker att ha i åtanke om man väljer denna metod:

* För att den automatiska konverteringen ska fungera måste man köra *pdflatex* med alternativet `--shell-escape`.
* För slutversionen får man inte glömma att kommentera raden `\epstopdfDeclareGraphicsRule`så att endast bilderna i hög upplösning laddas. Man måste också komma ihåg att ändra prioriteringsordningen.

&#x20; [Öppna exempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex)

## Referensguide

**Enheter och mått i LaTeX**

| Förkortning  | Definition                                             |
| ------------ | ------------------------------------------------------ |
| pt           | En punkt är standardenheten för längd. Cirka 0,3515 mm |
| mm           | en millimeter                                          |
| cm           | en centimeter                                          |
| i            | en tum                                                 |
| ex           | höjden på en **x** med det aktuella teckensnittet      |
| em           | bredden på en **m** med det aktuella teckensnittet     |
| \columnsep   | mellanrummet mellan kolumnerna                         |
| \columnwidth | bredden på en kolumn                                   |
| \linewidth   | radbredden i den aktuella miljön                       |
| \paperwidth  | pappersbredd                                           |
| \paperheight | pappershöjd                                            |
| \textwidth   | textens bredd                                          |
| \textheight  | textens höjd                                           |
| \unitlength  | längdenheter i miljön *bild*                           |

**Om vilka bildtyper som kan användas i LaTeX**

**latex**

Om dokumentet kompileras med kommandot latex kan endast bilder i EPS-format användas, vilket är ett vektorformat.

**pdflatex**

Om dokumentet kompileras med kommandot pdflatex för att skapa en PDF kan flera bildtyper användas-

```
   JPG: det bästa alternativet för att infoga fotografier
   PNG: det bästa alternativet för att infoga diagram (om du av någon anledning inte kan använda en vektorgrafik) och skärmbilder
   PDF: Trots vanan att använda PDF för dokument kan en PDF i allmänhet bestå av endast en bild som senare kan importeras.
   EPS: EPS-bilder kan inkluderas med paketet epstopdf (paketet behöver endast installeras på datorn; när det väl är installerat behövs inga extra kommandon i .tex-filen)
```

**Vektorgrafik eller bitmappsbilder?**

Bilder kan inkluderas antingen som bitmappsbilder eller vektorgrafik. I allmänhet behöver man inte oroa sig för detta, men om man har möjlighet att välja format bör man tänka på att en vektorgrafik bäst sparas i PDF- eller EPS-format, medan JPG- eller PNG-format rekommenderas för en bitmapp. Det beror på att en bitmapp i en fil i PDF- eller EPS-format kräver mycket lagringsutrymme.

&#x20; [Öppna exempel i Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex)

## Ytterligare läsning

För mer information, se:

* [Placering av bilder och tabeller](/latex/sv/figurer-och-tabeller/02-positioning-images-and-tables.md)
* [Förteckningar över tabeller och figurer](/latex/sv/figurer-och-tabeller/03-lists-of-tables-and-figures.md)
* [Ensidiga och dubbelsidiga dokument](/latex/sv/formatering/08-single-sided-and-double-sided-documents.md)
* [Längder i LaTeX](/latex/sv/formatering/01-lengths-in-latex.md)
* [**floatrow** paket för avancerad hantering av bildtexter för flytande element (tabeller och figurer)](http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf)
* [**sidecap** paketdokumentation för bildtexter till sidofigurer](ftp://ctan.tug.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf)
* [**epstopdf** paketdokumentation (konvertering från PDF till EPS)](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/sv/fler-amnen/28-inserting-images-es.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.
