> 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/it/altri-argomenti/28-inserting-images-es.md). # Inserire immagini es Le immagini sono elementi essenziali nella maggior parte dei documenti scientifici. LaTeX offre varie opzioni per gestire le immagini e farle apparire esattamente come ti servono. In questo articolo si spiega come includere immagini nei formati più comuni, come renderle più piccole o più grandi, e come aggiungere riferimenti alle immagini all'interno del documento. ## Introduzione Di seguito un esempio su come importare un'immagine in LaTeX. ```latex \documentclass{article} \usepackage{graphicx} \graphicspath{ {images/} } \begin{document} L'universo è immenso e sembra essere omogeneo, su larga scala, ovunque guardiamo. \includegraphics{universe} C'è un'immagine di una galassia sopra \end{document} ``` ![InsertingImagesEx1.png](/files/d76dd10d107559de71c3f9b027a6ceb6a74eecda) Latex non ha la capacità di manipolare le immagini da solo, per questa ragione si deve importare il pacchetto **graphicx**. Per usare tale pacchetto aggiungi la seguente riga nel preambolo del tuo documento ```latex \usepackage{graphicx} ``` Il comando `\graphicspath{ {images/} }` indica a LaTeX che le immagini sono salvate in una cartella chiamata *images* sotto la directory corrente. Il comando `\includegraphics{universe}` è quello che si occupa di includere l'immagine nel documento. Qui, *universe* è il nome del file immagine, senza l'estensione; quindi *universe.PNG* diventa *universe*. Il nome del file immagine non deve contenere spazi vuoti né più segni di punteggiatura. Nota: *Si può inserire l'estensione del file, ma è consigliabile* ometterla. Se l'estensione viene omessa, ciò fa sì che LaTeX cerchi tutti i formati supportati. Per maggiori dettagli consulta la sezione [Generazione di immagini ad alta e bassa risoluzione](#generando-imgenes-en-alta-y-baja-resolucin). [Apri un esempio in Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Il percorso della cartella delle immagini Quando si lavora in un documento che include varie immagini, una possibilità per mantenere organizzato il tuo progetto è salvarle in una cartella separata. Nell'esempio dell'introduzione questo si ottiene mediante il comando `\graphicspath{ {images/} }` che dice a LaTeX che le immagini devono essere cercate nella cartella *images*. Il percorso è *relativo* alla directory di lavoro corrente. Il percorso verso la cartella può essere ***relativo*** (consigliato) se la cartella si trova nella stessa directory del file .tex principale o in una delle sottocartelle, oppure può essere ***assoluto*** se è necessario specificare esattamente il percorso. Per esempio: ```latex %Percorso assoluto nel formato Windows: \graphicspath{ {c:/user/images/} } %Percorso assoluto in formato Unix (Linux, OsX) \graphicspath{ {/home/user/images/} } ``` Si noti che questo comando richiede una barra finale `/` e che il percorso deve essere racchiuso tra due coppie di parentesi graffe. È anche possibile impostare percorsi multipli se hai salvato le immagini in più di una cartella per maggiore organizzazione. Per esempio, se ci sono due cartelle, una chiamata *images1* e l'altra *images2*, usa il comando ```latex \graphicspath{ {images1/}{images2/} } ``` Se non viene specificato alcun percorso, LaTeX cercherà le immagini nella cartella corrente, dove è salvato il file .tex. [Apri esempio in Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Cambiare le dimensioni e ruotare un'immagine Se si vogliono specificare parametri aggiuntivi quando si importa un'immagine in LaTeX per modificare la larghezza, l'altezza, la posizione, ecc. dell'immagine, ciò è possibile tramite la seguente sintassi: ```latex Overleaf è un ottimo strumento professionale per modificare online, condividere e fare il backup dei tuoi progetti \LaTeX. Offre anche una documentazione di aiuto piuttosto ampia. \includegraphics[scale=1.5]{lion-logo} ``` ![InsertingImagesEx2.png](/files/2a12a984ea1f11794a38c649eca68e1802106e6f) Il comando `\includegraphics[scale=1.5]{lion-logo}` include l'immagine *lion-logo* nel documento, il parametro aggiuntivo `scale=1.5` scala l'immagine a 1.5 della sua dimensione originale. È anche possibile ridimensionare l'immagine a un'altezza e a una larghezza determinate. ```latex Overleaf è un ottimo strumento professionale per modificare online, condividere e fare il backup dei tuoi progetti \LaTeX. Offre anche una documentazione di aiuto piuttosto ampia. \includegraphics[width=3cm, height=4cm]{lion-logo} ``` ![InsertingImagesEx3.png](/files/313e0243b6f0185c0d9e15a799c677940f749673) Come probabilmente hai già indovinato, i parametri tra le parentesi quadre `[width=3cm, height=4cm]` definiscono la larghezza e l'altezza dell'immagine. Possono essere usate [unità di misura diverse](#gua-de-referencia) in questi parametri. Se viene impostato solo il valore di *width*, l'altezza verrà scalata proporzionalmente per mantenere le proporzioni dell'immagine. È anche possibile impostare la lunghezza dell'immagine rispetto ad altri elementi del documento. Per esempio, se vuoi che l'immagine abbia la stessa larghezza del testo: ```latex Overleaf è un ottimo strumento professionale per modificare online, condividere e fare il backup dei tuoi progetti \LaTeX. Offre anche una documentazione di aiuto piuttosto ampia. \includegraphics[width=\textwidth]{universe} ``` ![InsertingImagesEx5.png](/files/4e3b7d52357a52f4af9bc68115bbb015d824be0b) Invece di `\textwidth` puoi usare qualsiasi altra delle unità che LaTeX include per impostazione predefinita: *\columnsep, \linewidth, \textheight, \paperheight, ecc*. Consulta la [guida di riferimento](#gua-de-referencia) per una migliore descrizione delle unità. C'è un'altra opzione molto comune quando si includono immagini in un documento: poterle ruotare. Questo è molto facile in LaTeX: ```latex Overleaf è un ottimo strumento professionale per modificare online, condividere e fare il backup dei tuoi progetti \LaTeX. Offre anche una documentazione di aiuto piuttosto ampia. \includegraphics[scale=1.2, angle=45]{lion-logo} ``` ![InsertingImagesEx4.png](/files/f295abeef8451f9d0ac7ab351c66cd585b8b1f37) Il parametro `angle=45` ruota l'immagine di 45 gradi in senso antiorario. Per ruotare l'immagine nello stesso senso delle lancette di un orologio usa un numero negativo. [Apri un esempio in Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Posizionare l'immagine Nella sezione precedente è stato spiegato come inserire un'immagine nel tuo documento, ma a volte la combinazione di immagini e testo nel tuo documento potrebbe non risultare come ti aspettavi. Per cambiare questo è necessario usare un nuovo ambiente: ```latex Nel prossimo esempio la figura verrà posizionata proprio sotto questa frase. \begin{figure}[h] \includegraphics[width=8cm]{Plot} \end{figure} ``` ![InsertingImagesEx6.png](/files/e2167d3fbd978f32b52f09ef1284b8c05419e73d) L'ambiente `ambiente figure` si usa per mostrare le immagini come elementi flottanti all'interno del documento. Questo significa che basta includere la tua immagine all'interno dell'ambiente *ambiente figure* e non devi più preoccuparti di dove apparirà; LaTeX la posizionerà in modo tale che si adatti perfettamente al flusso del documento. Anche se in linea di principio questo suona molto bene, a volte si vuole avere più controllo su dove appariranno le immagini. Un parametro aggiuntivo può essere usato per impostare il posizionamento della figura. Nell'esempio, `begin{figure}[h]`, il parametro tra parentesi quadre stabilisce la posizione della figura *qui* (qui, in inglese). Di seguito una tabella con un elenco di possibili valori di posizionamento. | Parametro | Posizione | | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | h | Imposta la posizione dell'elemento flottante «qui». Cioè, approssimativamente nello stesso punto in cui appare nel codice (tuttavia, il posizionamento non è sempre esatto) | | t | Inserisce la figura all'inizio della pagina. | | b | Inserisce la figura alla fine della pagina. | | p | Inserisce gli elementi flottanti in una pagina separata, che contiene solo figure. | | ! | Sovrascrive i parametri che LaTeX usa per determinare una posizione «buona» per l'immagine. | | H | Imposta l'elemento flottante precisamente nello stesso punto in cui appare nel codice, è necessario importare il pacchetto `pacchetto float`. È in qualche misura equivalente a h!. | Nel seguente esempio si può vedere un'immagine che appare all'inizio del documento, nonostante il codice che la produce si trovi alla fine del documento. ```latex In questa immagine puoi vedere un grafico a barre che mostra i risultati di un sondaggio che ha coinvolto alcuni dati importanti studiati col passare del tempo. \begin{figure}[t] \includegraphics[width=8cm]{Plot} \centering \end{figure} ``` ![InsertingImagesEx7.png](/files/d04f8dc1db2e29c4b278bc38a29773240428b0ef) Il comando aggiuntivo `\centering` si occupa di centrare l'immagine. Il valore di allineamento predefinito è a sinistra. È anche possibile far scorrere il testo attorno alla figura. Quando il documento contiene immagini piccole, questo rende il testo più gradevole. ```latex \begin{wrapfigure}{r}{0.25\textwidth} %questa figura sarà a destra \centering \includegraphics[width=0.25\textwidth]{mesh} \end{wrapfigure} Esistono diversi modi per tracciare una funzione di due variabili, a seconda delle informazioni a cui sei interessato. Per esempio, se vuoi vedere la mesh di una funzione così più facile vedere la derivata, puoi usare un grafico come quello a sinistra. \begin{wrapfigure}{l}{0.25\textwidth} \centering \includegraphics[width=0.25\textwidth]{contour} \end{wrapfigure} D'altra parte, se sei interessato solo a certi valori, puoi usare il grafico di contorno, puoi usare il grafico di contorno, puoi usare il grafico di contorno, puoi grafico di contorno, puoi usare il grafico di contorno, puoi usare il grafico di contorno, puoi usare il grafico di contorno, puoi usare il grafico di contorno, come quello a sinistra. D'altra parte, se sei interessato solo a certi valori, puoi usare il grafico di contorno, puoi usare il grafico di contorno, puoi usare il grafico di contorno, puoi grafico di contorno, puoi usare il grafico di contorno, puoi usare il grafico di contorno, puoi usare il grafico di contorno, puoi usare il grafico di contorno, come quello a sinistra. ``` ![InsertingImagesEx8.png](/files/5a3c3cae28316fc44f4ce08cf8494cd88e3e46d8) Per far funzionare i comandi nell'esempio, si deve importare il pacchetto **wrapfig**. Aggiungi nel preambolo la riga ```latex \usepackage{wrapfig} ``` Una volta importato il pacchetto si può usare l'ambiente *wrapfigure* per mezzo del comando `\begin{wrapfigure}{l}{0.25\textwidth} \end{wrapfigure}`. Si noti che l'ambiente ha due parametri aggiuntivi tra parentesi graffe. Di seguito il codice è spiegato più in dettaglio. **{l}** Imposta l'allineamento della figura. Usa l per sinistra e r per destra. Inoltre, se si sta usando la classe book o un'altra simile, invece di l e r si possono usare o per il bordo esterno e i per il bordo interno della pagina. **{0.25\textwidth}** Questo stabilisce la larghezza della casella che contiene l'immagine. Non è la larghezza dell'immagine in sé, quella deve essere impostata nel comando includegraphics. Nell'esempio si usano unità relative, ma si possono usare unità normali (cm, mm, in, ecc). Consulta la guida di riferimento per vedere un elenco delle possibili unità. **\centering** Già spiegato in precedenza, ma nell'esempio precedente l'immagine verrà centrata rispetto alla casella che la contiene, invece che rispetto alla pagina. Per informazioni più complete sul posizionamento delle immagini consulta l'articolo [Posizionamento di immagini e tabelle](/latex/it/figure-e-tabelle/02-positioning-images-and-tables.md) [Apri esempio in Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Aggiungere etichette, didascalie e riferimenti La possibilità di aggiungere didascalie con una breve descrizione dell'immagine e etichette che poi si possono usare per riferirsi all'immagine è uno strumento molto utile quando si lavora con documenti molto lunghi. ### Didascalie Iniziamo con un esempio su come aggiungere una didascalia: ```latex \begin{figure}[h] \caption{Esempio di un grafico parametrico ($\sin (x), \cos(x), x$)} \centering \includegraphics[width=0.5\textwidth]{spiral} \end{figure} ``` ![InsertingImagesEx9.png](/files/3f95c7bbd871224e8d619583636036834837ab08) È molto facile, basta aggiungere il comando `\caption{Una didascalia}` e dentro le parentesi graffe scrivere il testo da mostrare. Il punto in cui verrà stampata la didascalia dipende da dove viene inserito il comando; se questo è sopra il comando *includegraphics* allora la didascalia apparirà sopra l'immagine, se è sotto quel comando allora la didascalia apparirà nella parte inferiore della figura. Le didascalie possono anche essere posizionate accanto alle figure. Il pacchetto **sidecap** permette di usare un codice molto simile a quello dell'esempio precedente per aggiungere il testo. ```latex \documentclass{article} \usepackage[rightcaption]{sidecap} \usepackage{graphicx} %pacchetto per gestire le immagini \graphicspath{ {images/} } \begin{SCfigure}[0.5][h] \caption{Esempio di un grafico parametrico. Questa didascalia sarà a destra} \includegraphics[width=0.6\textwidth]{spiral} \end{SCfigure} ``` ![InsertingImagesEx10.png](/files/22ff8fd2157bf8e4b775d3dadd29a916918facc6) Ci sono due nuovi comandi in questo esempio: **\usepackage\[rightcaption]{sidecap}** Come probabilmente già sai, questo comando importa il pacchetto chiamato sidecap, ma c'è un parametro aggiuntivo: rightcaption. Questo parametro è quello che stabilisce il luogo in cui viene stampata la didascalia. In questo caso, a destra dell'immagine; è anche possibile usare leftcaption per spostare la didascalia a sinistra. Nei documenti che usano classi di tipo libro, inoltre, si possono usare le opzioni outercaption e innercaption per stampare la didascalia nella parte esterna o interna rispetto al bordo della pagina. **\begin{SCfigure}\[0.5]\[h] \end{SCfigure}** Definisce un ambiente simile a figure. Il primo parametro è la larghezza della didascalia relativa alla dimensione dell'immagine. Il secondo parametro h ha la stessa funzione che nell'ambiente figure. Consulta la sezione sul posizionamento delle immagini per maggiori informazioni. È possibile ottenere una gestione più avanzata del formato delle didascalie, se lo si desidera. Consulta le [letture aggiuntive](#lecturas-adicionales) per vedere più riferimenti. ### Etichette e riferimenti incrociati Le figure, così come molti altri elementi in un documento LaTeX (equazioni, tabelle, grafici, ecc.) possono essere richiamati dal testo. Farlo è molto facile, basta aggiungere un'etichetta all'ambiente *ambiente figure* o *SCfigure*, poi usare quell'etichetta per riferirsi alla figura. ```latex \begin{figure}[h] \centering \includegraphics[width=0.25\textwidth]{mesh} \caption{un bel grafico} \label{fig:mesh1} \end{figure} Come puoi vedere nella figura \ref{fig:mesh1}, la funzione cresce vicino a 0. Inoltre, nella pagina \pageref{fig:mesh1} c'è lo stesso esempio. ``` ![InsertingImagesEx11.png](/files/a9885612deabf9a17ffc5f04a376bc6631b3bca4) Ci sono tre comandi in questo esempio che generano riferimenti incrociati. **\label{fig:mesh1}** Imposta l'etichetta per la figura. Poiché le etichette possono essere usate in diversi tipi di elementi nel documento, è una buona pratica usare un prefisso, come fig: nell'esempio. **\ref{fig:mesh1}** Questo comando stampa il numero assegnato alla figura. I numeri sono generati automaticamente e vengono aggiornati se in seguito viene inserita una figura prima di quella a cui si fa riferimento. **\pageref{fig:mesh1}** Stampa il numero di pagina in cui appare l'immagine richiamata dall'etichetta. Il comando `\caption` che aggiunge una didascalia è obbligatorio per poter aggiungere un'etichetta e riferire la figura. Un'altra caratteristica importante in LaTeX è la possibilità di generare automaticamente una *elenco delle figure*. Questo si ottiene facilmente con: ```latex \listoffigures ``` ![InsertingImagesEx12.png](/files/3daa3df48673d56d01b60ea485703db72164fc2a) Questo comando funziona solo con le figure che hanno una didascalia, dato che la usa per generare l'elenco. L'esempio precedente elenca le immagini usate nel presente articolo. Nota importante: *Quando si usano riferimenti incrociati in LaTeX il progetto deve essere compilato due volte, altrimenti i riferimenti, i riferimenti alle pagine e l'elenco delle figure non funzioneranno*. [Apri un esempio in Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Generazione di immagini ad alta e bassa risoluzione Per il momento, quando inseriamo il nome del file immagine nel comando *\includegraphics* omettiamo l'estensione del file. Tuttavia, ciò non è necessario, anche se può essere molto utile. Se l'estensione viene omessa, LaTeX cercherà qualsiasi tipo di immagine supportata nella directory delle immagini preimpostata; la ricerca avverrà in un certo ordine, che può essere modificato. Questo è molto utile per passare dalla versione in bozza del tuo documento alla versione finale. Nella bozza (mentre scrivi il tuo articolo, libro, rapporto, ecc.), è auspicabile poter usare immagini a bassa risoluzione (tipicamente in formato .png) così che il documento compili più rapidamente. Nella versione finale, invece, si preferisce includere immagini ad alta risoluzione, per avere un documento di qualità. Questo si può ottenere mediante: * Non specificare l'estensione del file nel comando *\includegraphics*, e * Specificare l'ordine delle estensioni nel preambolo Così, se si hanno due versioni della stessa immagine, per esempio venndiagram.pdf (ad alta risoluzione) e venndiagram.png (a bassa risoluzione), si può inserire la seguente riga nel preambolo mentre si scrive e si depura il documento - ```latex \DeclareGraphicsExtensions{.png,.pdf} ``` Il comando precedente si assicura che, se si trovano due immagini con lo stesso nome ma con estensioni diverse, allora verrà usato il file .png, e se per qualche motivo questo file scompare, la versione pdf sarà la successiva opzione. Una volta che il documento è stato scritto, per usare solo la versione ad alta risoluzione si deve cambiare la riga che determina l'estensione in: ```latex \DeclareGraphicsExtensions{.pdf,.png} ``` Si può persino migliorare la tecnica descritta sopra: possiamo chiedere a LaTeX di generare immagini .png a bassa risoluzione mentre compila il documento, se il PDF non è stato convertito in PNG in precedenza. Per ottenere ciò, si deve includere quanto segue nel preambolo dopo `\usepackage{graphicx}`. ```latex \usepackage{epstopdf} \epstopdfDeclareGraphicsRule{.pdf}{png}{.png}{convert #1 \OutputFile} \DeclareGraphicsExtensions{.png,.pdf} ``` Se venndiagram2.pdf esiste ma non venndiagram2.png, il file vendiagramm2-pdf-converted-to.png verrà creato e caricato al suo posto. Il comando *convert #1* è responsabile della conversione Ci sono un paio di cose da tenere a mente se si sceglie questo metodo: * Perché la conversione automatica funzioni si deve eseguire *pdflatex* con l'opzione `--shell-escape`. * Per la versione finale non si deve dimenticare di commentare la riga `\epstopdfDeclareGraphicsRule`, così che vengano caricate solo le immagini ad alta risoluzione. Bisogna anche ricordarsi di cambiare l'ordine di precedenza. [Apri esempio in Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Guida di riferimento **Unità e misure in LaTeX** | Abbreviazione | Definizione | | ------------- | ------------------------------------------------------------------------- | | pt | Un punto è l'unità di lunghezza predefinita. Approssimativamente 0.3515mm | | mm | un millimetro | | cm | un centimetro | | in | un pollice | | ex | l'altezza di una **x** con il font attuale | | em | la larghezza di una **m** con il font attuale | | \columnsep | distanza tra le colonne | | \columnwidth | larghezza di una colonna | | \linewidth | ampiezza di linea nell'ambiente corrente | | \paperwidth | larghezza della carta | | \paperheight | altezza della carta | | \textwidth | larghezza del testo | | \textheight | altezza del testo | | \unitlength | unità di lunghezza nell'ambiente *picture* | **Informazioni sui tipi di immagini che si possono usare in LaTeX** **latex** Se si compila il documento con il comando latex, si possono usare solo immagini in formato EPS, che è un formato vettoriale. **pdflatex** Se si compila il documento con il comando pdflatex per produrre un PDF, allora si possono usare diversi tipi di immagini- ``` JPG: La scelta migliore per inserire fotografie PNG: La scelta migliore per inserire diagrammi (se per qualche motivo non puoi usare un grafico vettoriale) e schermate PDF: Nonostante l'abitudine di usare PDF per i documenti, in generale un PDF può consistere in una sola immagine che può poi essere importata. EPS: Le immagini EPS possono essere incluse usando il pacchetto epstopdf (il pacchetto deve essere installato solo sul computer; una volta installato non è necessario alcun comando aggiuntivo nel file .tex) ``` **Grafici vettoriali o mappe di bit?** Le immagini possono essere incluse sia in formato bitmap sia come grafici vettoriali. In generale non ci si deve preoccupare di ciò, ma se si ha la possibilità di scegliere un formato bisogna tenere presente che per un grafico vettoriale è meglio salvarlo in formato PDF o EPS, mentre per un bitmap i formati JPG o PNG sono quelli consigliati. Questo perché un bitmap all'interno di un file in formato PDF o EPS richiede molto spazio di archiviazione. [Apri esempio in Overleaf](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## Letture aggiuntive Per ulteriori informazioni consultare: * [Posizionamento di immagini e tabelle](/latex/it/figure-e-tabelle/02-positioning-images-and-tables.md) * [Elenchi di tabelle e figure](/latex/it/figure-e-tabelle/03-lists-of-tables-and-figures.md) * [Documenti a facciata singola e doppia](/latex/it/formattazione/08-single-sided-and-double-sided-documents.md) * [Lunghezze in LaTeX](/latex/it/formattazione/01-lengths-in-latex.md) * [**floatrow** pacchetto per la gestione avanzata delle didascalie degli elementi flottanti (tabelle e figure)](http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf) * [**sidecap** documentazione del pacchetto, per le didascalie delle figure laterali](ftp://ctan.tug.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf) * [**epstopdf** documentazione del pacchetto (conversione da PDF a 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/it/altri-argomenti/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.