> 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/cs/dalsi-temata/28-inserting-images-es.md). # Vkládání obrázků es Obrázky jsou základními prvky ve většině vědeckých dokumentů. LaTeX poskytuje několik možností pro práci s obrázky a jejich zobrazení přesně tak, jak potřebujete. Tento článek vysvětluje, jak vkládat obrázky v nejběžnějších formátech, jak je zmenšovat nebo zvětšovat a jak do dokumentu přidávat odkazy na obrázky. ## Úvod Níže je příklad, jak importovat obrázek do LaTeXu. ```latex \documentclass{article} \usepackage{graphicx} \graphicspath{ {images/} } \begin{document} Vesmír je nesmírný a zdá se být homogenní, ve velkém měřítku, všude, kam se podíváme. \includegraphics{universe} Nahoře je obrázek galaxie \end{document} ``` ![InsertingImagesEx1.png](/files/0cdb2d2ac399ef5432274718c1eabd73116f8994) LaTeX sám nemá schopnost pracovat s obrázky, proto je třeba importovat balíček **graphicx**. Pro použití tohoto balíčku přidejte do preambule dokumentu následující řádek ```latex \usepackage{graphicx} ``` Příkaz `\graphicspath{ {images/} }` říká LaTeXu, že obrázky jsou uloženy ve složce nazvané *images* v rámci aktuálního adresáře. Příkaz `\includegraphics{universe}` je ten, který zahrne obrázek do dokumentu. Zde, *universe* je název obrazového souboru bez přípony; takže *universe.PNG* se změní na *universe*. Název obrazového souboru nesmí obsahovat mezery ani více interpunkčních znamének. Poznámka: *Příponu souboru lze zadat, ale doporučuje se* ji vynechat. Pokud se přípona vynechá, LaTeX vyhledá všechny podporované formáty. Pro více podrobností viz sekci [Generování obrázků ve vysokém a nízkém rozlišení](#generando-imgenes-en-alta-y-baja-resolucin). [Otevřít příklad v Overleafu](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Cesta ke složce s obrázky Při práci s dokumentem, který obsahuje několik obrázků, je jednou z možností, jak udržet projekt uspořádaný, uložit je do samostatné složky. V úvodním příkladu se toho dosáhne pomocí příkazu `\graphicspath{ {images/} }` který LaTeXu říká, že obrázky má hledat ve složce *images*. Cesta je *relativní* vůči aktuálnímu pracovnímu adresáři. Cesta ke složce může být ***relativní*** (doporučeno), pokud je složka ve stejném adresáři jako hlavní soubor .tex nebo v některé z podsložek, nebo může být ***absolutní*** pokud je třeba přesně zadat cestu. Například: ```latex %Absolutní cesta ve formátu Windows: \graphicspath{ {c:/user/images/} } %Absolutní cesta ve formátu typu Unix (Linux, OS X) \graphicspath{ {/home/user/images/} } ``` Všimněte si, že tento příkaz vyžaduje lomítko `/` na konci a že cesta musí být zapsána mezi dvěma páry složených závorek. Je také možné nastavit více cest, pokud jste obrázky pro lepší organizaci uložili do více než jedné složky. Například, pokud jsou tam dvě složky, jedna nazvaná *images1* a druhá *images2*, použijte příkaz ```latex \graphicspath{ {images1/}{images2/} } ``` Pokud není zadána žádná cesta, LaTeX bude hledat obrázky v aktuální složce, kde je uložen soubor .tex. [Otevřít příklad v Overleafu](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Změna velikosti a otočení obrázku Pokud chcete při importu obrázku do LaTeXu zadat další parametry pro úpravu šířky, výšky, polohy atd. obrázku, je to možné pomocí následující syntaxe: ```latex Overleaf je skvělý profesionální nástroj pro online úpravy, sdílení a zálohování vašich projektů v \LaTeXu. Také nabízí poměrně rozsáhlou nápovědu a dokumentaci. \includegraphics[scale=1.5]{lion-logo} ``` ![InsertingImagesEx2.png](/files/c63fbece613f6e6ec4891560633b150a6d619ece) Příkaz `\includegraphics[scale=1.5]{lion-logo}` zahrne obrázek *lion-logo* do dokumentu a dodatečný parametr `scale=1.5` zmenší nebo zvětší obrázek na 1,5násobek původní velikosti. Obrázek je také možné změnit na určitou výšku a šířku. ```latex Overleaf je skvělý profesionální nástroj pro online úpravy, sdílení a zálohování vašich projektů v \LaTeXu. Také nabízí poměrně rozsáhlou nápovědu a dokumentaci. \includegraphics[width=3cm, height=4cm]{lion-logo} ``` ![InsertingImagesEx3.png](/files/22911ceae0be32da4a2feedc80c9f1f4d1ce31a4) Jak jste už pravděpodobně uhodli, parametry v hranatých závorkách `[width=3cm, height=4cm]` definují šířku a výšku obrázku. Lze použít [různé jednotky](#gua-de-referencia) míry v těchto parametrech. Pokud se nastaví pouze hodnota *width*, výška se bude měnit proporcionálně, aby byl zachován poměr stran obrázku. Je také možné nastavit velikost obrázku vzhledem k ostatním prvkům v dokumentu. Například pokud chcete, aby měl obrázek stejnou šířku jako text: ```latex Overleaf je skvělý profesionální nástroj pro online úpravy, sdílení a zálohování vašich projektů v \LaTeXu. Také nabízí poměrně rozsáhlou nápovědu a dokumentaci. \includegraphics[width=\textwidth]{universe} ``` ![InsertingImagesEx5.png](/files/b70d7ef2d74851b64a502508045dc9de59251495) Místo `\textwidth` můžete použít kteroukoli jinou z jednotek, které LaTeX standardně obsahuje: *\columnsep, \linewidth, \textheight, \paperheight, etc*. Podívejte se do [referenční příručce](#gua-de-referencia) pro lepší popis jednotek. Další velmi běžnou možností při vkládání obrázků do dokumentu je možnost je otáčet. V LaTeXu je to velmi snadné: ```latex Overleaf je skvělý profesionální nástroj pro online úpravy, sdílení a zálohování vašich projektů v \LaTeXu. Také nabízí poměrně rozsáhlou nápovědu a dokumentaci. \includegraphics[scale=1.2, angle=45]{lion-logo} ``` ![InsertingImagesEx4.png](/files/89839d79feaea8ffa0bcd160bccc08fcc44e6749) Parametr `angle=45` otočí obrázek o 45 stupňů proti směru hodinových ručiček. Chcete-li obrázek otočit ve směru hodinových ručiček, použijte záporné číslo. [Otevřete příklad v Overleafu](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Umístění obrázku V předchozí části bylo vysvětleno, jak vložit obrázek do dokumentu, ale někdy nemusí kombinace obrázků a textu v dokumentu dopadnout tak, jak jste očekávali. Ke změně toho je třeba použít nové prostředí: ```latex V následujícím příkladu bude obrázek umístěn přímo pod touto větou. \begin{figure}[h] \includegraphics[width=8cm]{Plot} \end{figure} ``` ![InsertingImagesEx6.png](/files/c0621dec0589bc0c735b43d93ad30c0d28ed49f3) Prostředí `figure` se používá k zobrazování obrázků jako plovoucích objektů v dokumentu. To znamená, že stačí vložit obrázek do prostředí *figure* a už se nemusíte starat o to, kde se objeví; LaTeX jej umístí tak, aby dokonale zapadl do toku dokumentu. Ačkoli to na první pohled zní velmi dobře, někdy chcete mít větší kontrolu nad tím, kde se obrázky objeví. Další parametr lze použít k nastavení umístění figury. V příkladu, `begin{figure}[h]`, parametr v hranatých závorkách určuje umístění figury *zde* (zde, anglicky). Následuje tabulka se seznamem možných hodnot umístění. | Parametr | Umístění | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | h | Nastavuje umístění plovoucího objektu „zde“. Tedy přibližně na tom samém místě, kde se objevuje v kódu (umístění však není vždy přesné) | | t | Vloží figuru na začátek stránky. | | b | Vloží figuru na konec stránky. | | p | Vloží plovoucí objekty na samostatnou stránku, která obsahuje pouze figury. | | ! | Přepíše parametry, které LaTeX používá k určení „vhodného“ umístění obrázku. | | H | Umístí plovoucí objekt přesně na stejné místo, kde se objevuje v kódu; je třeba importovat balíček `float`. Do určité míry je ekvivalentní k h!. | V následujícím příkladu je vidět obrázek, který se objeví na začátku dokumentu, přestože kód, který jej vytváří, se nachází na konci dokumentu. ```latex Na tomto obrázku můžete vidět sloupcový graf, který ukazuje výsledky průzkumu, který zahrnoval některá důležitá data sledovaná v průběhu času. \begin{figure}[t] \includegraphics[width=8cm]{Plot} \centering \end{figure} ``` ![InsertingImagesEx7.png](/files/ee5ff0e2fcfdc63660abaf482692f268498ca50a) Dodatečný příkaz `\centering` zajistí vycentrování obrázku. Výchozí hodnota zarovnání je vlevo. Text lze také obtékat kolem figury. Když dokument obsahuje malé obrázky, text pak vypadá lépe. ```latex \begin{wrapfigure}{r}{0.25\textwidth} %tento obrázek bude vpravo \centering \includegraphics[width=0.25\textwidth]{mesh} \end{wrapfigure} Existuje několik způsobů, jak vykreslit funkci dvou proměnných, v závislosti na informacích, které vás zajímají. Například, chcete-li vidět síť funkce, aby bylo snadnější vidět derivaci, můžete použít graf, jako je ten vlevo. \begin{wrapfigure}{l}{0.25\textwidth} \centering \includegraphics[width=0.25\textwidth]{contour} \end{wrapfigure} Na druhou stranu, pokud vás zajímají pouze určité hodnoty, můžete použít konturový graf, můžete použít konturový graf, můžete použít konturový graf, můžete použít konturový graf, můžete použít konturový graf, můžete použít konturový graf, můžete použít konturový graf, jako je ten vlevo. Na druhou stranu, pokud vás zajímají pouze určité hodnoty, můžete použít konturový graf, můžete použít konturový graf, můžete použít konturový graf, můžete použít konturový graf, můžete použít konturový graf, můžete použít konturový graf, můžete použít konturový graf, jako je ten vlevo. ``` ![InsertingImagesEx8.png](/files/fb980055102ea079c38f02fd63d0aeb3125de0d8) Aby příkazy v příkladu fungovaly, je třeba importovat balíček **wrapfig**. Přidejte do preambule řádek ```latex \usepackage{wrapfig} ``` Jakmile je balíček importován, lze použít prostředí *wrapfigure* pomocí příkazu `\begin{wrapfigure}{l}{0.25\textwidth} \end{wrapfigure}`. Všimněte si, že prostředí má dva další parametry ve složených závorkách. Níže je kód vysvětlen podrobněji. **{l}** Nastavuje zarovnání figury. Použijte l pro levou stranu a r pro pravou. Navíc, pokud se používá třída book nebo podobná, místo l a r lze použít o pro vnější okraj a i pro vnitřní okraj stránky. **{0.25\textwidth}** Tímto se nastavuje šířka rámečku, který obsahuje obrázek. Nejde o šířku samotného obrázku; tu je třeba nastavit v příkazu includegraphics. V příkladu jsou použity relativní jednotky, ale lze použít i běžné jednotky (cm, mm, in atd.). Podívejte se do referenční příručky pro seznam možných jednotek. **\centering** To už bylo vysvětleno dříve, ale v předchozím příkladu bude obrázek vycentrován vzhledem k rámečku, který jej obsahuje, místo vzhledem ke stránce. Pro podrobnější informace o umisťování obrázků se podívejte na článek [Umísťování obrázků a tabulek](/latex/cs/obrazky-a-tabulky/02-positioning-images-and-tables.md) [Otevřít příklad v Overleafu](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Přidávání štítků, popisků a odkazů Možnost přidávat popisky s krátkým popisem obrázku a štítky, které lze později použít k odkazování na obrázek, je velmi užitečná při práci s velmi dlouhými dokumenty. ### Popisky Začněme příkladem, jak přidat popisek: ```latex \begin{figure}[h] \caption{Příklad parametrického grafu ($\sin (x), \cos(x), x$)} \centering \includegraphics[width=0.5\textwidth]{spiral} \end{figure} ``` ![InsertingImagesEx9.png](/files/64d587cf491701f5cafd9d395aa2568d162efd9a) Je to velmi snadné, stačí přidat příkaz `\caption{Some caption}` a do složených závorek napsat zobrazovaný text. Místo, kde se popisek vypíše, závisí na tom, kam se příkaz vloží; pokud je nad příkazem *includegraphics* pak se popisek objeví nad obrázkem; pokud je pod tímto příkazem, popisek se objeví ve spodní části figury. Popisky lze také umístit vedle figur. Balíček **sidecap** umožňuje použít kód velmi podobný předchozímu příkladu k přidání textu. ```latex \documentclass{article} \usepackage[rightcaption]{sidecap} \usepackage{graphicx} %balíček pro správu obrázků \graphicspath{ {images/} } \begin{SCfigure}[0.5][h] \caption{Příklad parametrického grafu. Tento popisek bude vpravo} \includegraphics[width=0.6\textwidth]{spiral} \end{SCfigure} ``` ![InsertingImagesEx10.png](/files/be46f38f76b321c333657779e864ed2a7fc93ee7) V tomto příkladu jsou dva nové příkazy: **\usepackage\[rightcaption]{sidecap}** Jak už možná víte, tento příkaz importuje balíček s názvem sidecap, ale má navíc parametr: rightcaption. Tento parametr určuje místo, kde se popisek vypíše. V tomto případě napravo od obrázku; je také možné použít leftcaption pro přesun popisku doleva. V dokumentech používajících knižní třídy lze navíc použít volby outercaption a innercaption pro vypsání popisku na vnější nebo vnitřní straně vzhledem k okraji stránky. **\begin{SCfigure}\[0.5]\[h] \end{SCfigure}** Definuje prostředí podobné figure. První parametr je šířka popisku vzhledem k velikosti obrázku. Druhý parametr h má stejnou funkci jako v prostředí figure. Další informace najdete v části o umisťování obrázků. Pokud chcete, lze dosáhnout pokročilejšího zacházení s formátem popisků. Podívejte se na [doplňující materiály](#lecturas-adicionales) pro další odkazy. ### Štítky a křížové odkazy Na figury lze, stejně jako na mnoho dalších prvků v dokumentu LaTeX (rovnice, tabulky, grafy atd.), odkazovat přímo z textu. Dosáhnout toho je velmi snadné, stačí přidat štítek do prostředí *figure* nebo *SCfigure*, a pak tento štítek použít k odkazu na figuru. ```latex \begin{figure}[h] \centering \includegraphics[width=0.25\textwidth]{mesh} \caption{a nice plot} \label{fig:mesh1} \end{figure} Jak můžete vidět na obrázku \ref{fig:mesh1}, funkce roste poblíž 0. Také na stránce \pageref{fig:mesh1} je tentýž příklad. ``` ![InsertingImagesEx11.png](/files/9e9d7334e2cead21796ac1230ac0c57675b614df) V tomto příkladu jsou tři příkazy, které vytvářejí křížové odkazy. **\label{fig:mesh1}** Nastavuje štítek pro figuru. Protože štítky lze použít pro různé typy prvků v dokumentu, je dobrým zvykem používat předponu, například fig: v příkladu. **\ref{fig:mesh1}** Tento příkaz vypíše číslo přiřazené figuře. Čísla se generují automaticky a aktualizují se, pokud je později před odkazovanou figurou vložena další figura. **\pageref{fig:mesh1}** Vypíše číslo stránky, kde se objevuje obrázek označený štítkem. Příkaz `\caption` který přidává popisek, je povinný pro možnost přidat štítek a odkazovat na figuru. Další důležitou vlastností LaTeXu je možnost automaticky generovat *seznam figur*. Toho lze snadno dosáhnout pomocí: ```latex \listoffigures ``` ![InsertingImagesEx12.png](/files/7033a79e1e2520bbaa996fb2026dceb2a561f07c) Tento příkaz funguje pouze s figurami, které mají popisek, protože jej používá k vytvoření seznamu. Předchozí příklad vypisuje obrázky použité v tomto článku. Důležitá poznámka: *Při použití křížových odkazů v LaTeXu je nutné projekt přeložit dvakrát, jinak nebudou fungovat odkazy, odkazy na stránky ani seznam figur.*. [Otevřít příklad v Overleafu](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Generování obrázků ve vysokém a nízkém rozlišení V tuto chvíli, když zadáváme název obrazového souboru do příkazu *\includegraphics* příponu souboru vynecháváme. To však není nutné, i když to může být velmi užitečné. Pokud se přípona vynechá, LaTeX bude v přednastaveném adresáři obrázků hledat jakýkoli podporovaný typ obrázku; vyhledávání proběhne v určitém pořadí, které lze změnit. To je velmi užitečné při přechodu z pracovní verze dokumentu na finální verzi. V pracovní verzi (zatímco píšete svůj článek, knihu, zprávu atd.) je žádoucí používat obrázky v nízkém rozlišení (typicky ve formátu .png), aby se dokument kompiloval rychleji. Ve finální verzi naopak člověk dává přednost obrázkům ve vysokém rozlišení, aby získal kvalitní dokument. Toho lze dosáhnout pomocí: * Nezadávat příponu souboru v příkazu *\includegraphics*, a * Zadáním pořadí přípon v preambuli Pokud tedy máte dvě verze téhož obrázku, například venndiagram.pdf (ve vysokém rozlišení) a venndiagram.png (v nízkém rozlišení), můžete do preambule během psaní a ladění dokumentu přidat následující řádek - ```latex \DeclareGraphicsExtensions{.png,.pdf} ``` Předchozí příkaz zajistí, že pokud existují dva obrázky se stejným názvem, ale různými příponami, použije se soubor .png, a pokud z nějakého důvodu tento soubor zmizí, verze v PDF bude další možností. Jakmile je dokument napsán, pro použití pouze verze ve vysokém rozlišení je třeba změnit řádek určující příponu na: ```latex \DeclareGraphicsExtensions{.pdf,.png} ``` Výše popsanou techniku lze dokonce ještě vylepšit: můžeme požádat LaTeX, aby při kompilaci dokumentu generoval obrázky .png v nízkém rozlišení, pokud PDF nebylo dříve převedeno na PNG. K tomu je třeba do preambule po `\usepackage{graphicx}`. ```latex \usepackage{epstopdf} \epstopdfDeclareGraphicsRule{.pdf}{png}{.png}{convert #1 \OutputFile} \DeclareGraphicsExtensions{.png,.pdf} ``` Pokud venndiagram2.pdf existuje, ale venndiagram2.png ne, soubor vendiagramm2-pdf-converted-to.png se vytvoří a načte se místo něj. Příkaz *convert #1* je zodpovědný za převod Pokud zvolíte tuto metodu, je třeba mít na paměti několik věcí: * Aby automatický převod fungoval, je třeba spustit *pdflatex* s volbou `--shell-escape`. * Pro finální verzi se nesmí zapomenout zakomentovat řádek `\epstopdfDeclareGraphicsRule`, aby se načítaly pouze obrázky ve vysokém rozlišení. Je také třeba pamatovat na změnu pořadí přednosti. [Otevřít příklad v Overleafu](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Referenční příručka **Jednotky a míry v LaTeXu** | Zkratka | Definice | | ------------ | ------------------------------------------------------ | | pt | Bod; je to výchozí jednotka délky. Přibližně 0,3515 mm | | mm | milimetr | | cm | centimetr | | v | palec | | ex | výška **x** s aktuálním písmem | | em | šířka **m** s aktuálním písmem | | \columnsep | vzdálenost mezi sloupci | | \columnwidth | šířka sloupce | | \linewidth | šířka řádku v aktuálním prostředí | | \paperwidth | šířka papíru | | \paperheight | výška papíru | | \textwidth | šířka textu | | \textheight | výška textu | | \unitlength | jednotky délky v prostředí *picture* | **O typech obrázků, které lze v LaTeXu použít** **latex** Pokud se dokument překládá příkazem latex, lze použít pouze obrázky ve formátu EPS, což je vektorový formát. **pdflatex** Pokud se dokument překládá příkazem pdflatex za účelem vytvoření PDF, lze použít několik typů obrázků- ``` JPG: Nejlepší volba pro vkládání fotografií PNG: Nejlepší volba pro vkládání diagramů (pokud z nějakého důvodu nemůžete použít vektorovou grafiku) a snímků obrazovky PDF: Ačkoli se PDF běžně používá pro dokumenty, obecně může PDF obsahovat pouze jeden obrázek, který lze následně importovat. EPS: Obrázky EPS lze zahrnout pomocí balíčku epstopdf (balíček je třeba pouze nainstalovat v systému; po instalaci není v souboru .tex potřeba žádný další příkaz) ``` **Vektorová grafika nebo bitmapy?** Obrázky lze vkládat buď ve formátu bitmap, nebo jako vektorovou grafiku. Obecně se tím člověk nemusí zabývat, ale pokud má možnost zvolit formát, je třeba mít na paměti, že pro vektorovou grafiku je nejlepší ji uložit ve formátu PDF nebo EPS, zatímco pro bitmapy jsou doporučeny formáty JPG nebo PNG. Je to proto, že bitmapa uvnitř souboru ve formátu PDF nebo EPS vyžaduje mnoho místa pro uložení. [Otevřít příklad v Overleafu](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Další čtení Pro více informací viz: * [Umísťování obrázků a tabulek](/latex/cs/obrazky-a-tabulky/02-positioning-images-and-tables.md) * [Seznamy tabulek a obrázků](/latex/cs/obrazky-a-tabulky/03-lists-of-tables-and-figures.md) * [Jednostranné a oboustranné dokumenty](/latex/cs/formatovani/08-single-sided-and-double-sided-documents.md) * [Délky v LaTeXu](/latex/cs/formatovani/01-lengths-in-latex.md) * [**floatrow** balíček pro pokročilou správu popisků plovoucích objektů (tabulek a figur)](http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf) * [**sidecap** dokumentace balíčku, pro popisky u obrázků na boku](ftp://ctan.tug.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf) * [**epstopdf** dokumentace balíčku (převod PDF na 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/cs/dalsi-temata/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.