> 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/struttura-del-documento/09-hyperlinks.md). # Collegamenti ipertestuali LaTeX è un ottimo strumento per documenti professionali stampabili, ma può essere usato anche per generare file PDF con eccellenti strumenti di navigazione. Questo articolo descrive come creare collegamenti ipertestuali nel tuo documento e come impostare documenti LaTeX da visualizzare con un lettore PDF. ## Introduzione Iniziamo con un esempio minimo funzionante, semplicemente importando il **hyperref** il pacchetto fa sì che tutti [gli elementi con riferimenti incrociati](/latex/it/struttura-del-documento/03-cross-referencing-sections-equations-and-floats.md) diventano collegamenti ipertestuali. ```latex \documentclass{book} \usepackage{blindtext} \usepackage{hyperref} \title{Esempio di collegamenti ipertestuali} \author{Overleaf} \begin{document} \frontmatter \tableofcontents \clearpage \addcontentsline{toc}{chapter}{Prefazione} {\huge {\bf Prefazione}} \Blindtext \clearpage \addcontentsline{toc}{chapter}{Voce fittizia} {\huge {\bf Voce fittizia}} \Blindtext \mainmatter \chapter{Primo capitolo} Questo sarà un capitolo vuoto \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} L'equazione \ref{eq:1} mostra una somma divergente. Questa formula verrà usata in seguito nella pagina \pageref{second}. \Blindtext \clearpage \section{Seconda sezione} \label{second} \blindtext \Blinddocument \end{document} ``` [Apri questo `hyperref` esempio in Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+hyperref+example\&snip=%5Cdocumentclass%7Bbook%7D%0A%5Cusepackage%7Bblindtext%7D%0A%5Cusepackage%7Bhyperref%7D%0A%0A%5Ctitle%7BExample+of+Hyperlinks%7D%0A%5Cauthor%7BOverleaf%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cfrontmatter%0A%5Ctableofcontents%0A%5Cclearpage%0A%0A%5Caddcontentsline%7Btoc%7D%7Bchapter%7D%7BForeword%7D%0A%7B%5Chuge+%7B%5Cbf+Foreword%7D%7D%0A%0A%5CBlindtext%0A%5Cclearpage%0A%0A%5Caddcontentsline%7Btoc%7D%7Bchapter%7D%7BDummy+entry%7D%0A%7B%5Chuge+%7B%5Cbf+Dummy+entry%7D%7D%0A%0A%5CBlindtext%0A%5Cmainmatter%0A%0A%5Cchapter%7BFirst+Chapter%7D%0A%0AThis+will+be+an+empty+chapter%0A%0A%5Cbegin%7Bequation%7D%0A%5Clabel%7Beq%3A1%7D%0A%5Csum_%7Bi%3D0%7D%5E%7B%5Cinfty%7D+a_i+x%5Ei%0A%5Cend%7Bequation%7D%0A%0AThe+equation+%5Cref%7Beq%3A1%7D+shows+a+sum+that+is+divergent.+This+formula+will+be+used+later+on+page+%5Cpageref%7Bsecond%7D.%0A%0A%5CBlindtext%0A%5Cclearpage%0A%0A%5Csection%7BSecond+section%7D+%5Clabel%7Bsecond%7D%0A%0A%5Cblindtext%0A%5CBlinddocument%0A%5Cend%7Bdocument%7D) ![Documento di esempio di hyperref](/files/0c8fee1f66395ef6c3419b369be3e8e798d37576) Le voci nell'indice diventano collegamenti alle pagine corrispondenti nel documento semplicemente aggiungendo nel preambolo del documento la riga ```latex \usepackage{hyperref} ``` Bisogna fare attenzione quando si importa `hyperref`: di solito deve essere l'ultimo pacchetto da importare, ma potrebbero esserci alcune eccezioni a questa regola. ## Stili e colori La formattazione predefinita dei collegamenti può essere modificata così che le informazioni nei documenti siano presentate in modo più chiaro. Qui sotto puoi vedere un esempio: ```latex \documentclass{book} \usepackage{hyperref} \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Overleaf Example}, pdfpagemode=FullScreen, } \urlstyle{same} \begin{document} \tableofcontents \chapter{Primo capitolo} Questo sarà un capitolo vuoto e inserirò qui del testo \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} L'equazione \ref{eq:1} mostra una somma divergente. Questa formula sarà usata in seguito nella pagina \pageref{second}. Per ulteriori riferimenti vedi \href{http://www.overleaf.com}{Something Linky} oppure vai all'URL successivo: \url{http://www.overleaf.com} oppure apri il file successivo \href{run:./file.txt}{File.txt} È anche possibile collegare direttamente qualsiasi parola o \hyperlink{thesentence}{qualsiasi frase} nel tuo documento. \end{document} ``` [Apri un esempio del `hyperref` pacchetto in Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Another+hyperref+example\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ![HyperrefEx2OverleafVa.png](/files/b7a8f7bda163fd8dbce21ccc6e927ab800dace0e) ![HyperrefEx2OverleafVb.png](/files/5b49034dc3d75a9a4b1e771827118c2316745c46) Questo è un esempio completo, verrà spiegato in modo approfondito nel resto dell'articolo. Qui sotto c'è una descrizione dei comandi relativi al colore e allo stile dei collegamenti. **\hypersetup{ ... }** Questo imposterà le opzioni per configurare il comportamento dei collegamenti all'interno del documento. Ogni parametro deve essere separato da virgole e la sintassi deve essere nel formato parametro=valore. **colorlinks=true** I collegamenti saranno colorati, il colore predefinito è rosso. **linkcolor=blue** I collegamenti interni, quelli generati da elementi con riferimenti incrociati, vengono mostrati in blu. **filecolor=magenta** I collegamenti ai file locali verranno mostrati in colore magenta (vedi collegamento ai file locali). **urlcolor=cyan** I collegamenti ai siti web sono impostati sul colore ciano (vedi collegamento degli indirizzi web). **urlstyle{same}** Le impostazioni predefinite stampano i collegamenti con font monospaziati, questo comando modifica il comportamento e visualizza i collegamenti con lo stesso stile del resto del testo. ## Collegamento di indirizzi web È possibile aggiungere a un file LaTeX collegamenti a un indirizzo web o a un'e-mail usando il `\url` comando per visualizzare il collegamento effettivo oppure `\href` per usare un collegamento nascosto e mostrare invece una parola/frase. ```latex Per ulteriori riferimenti vedi \href{http://www.overleaf.com}{Something Linky} oppure vai all'URL successivo: \url{http://www.overleaf.com} ``` ![HyperlinkExampleUpdatedMore.png](/files/b8c2a9dfc106642258cbee5506ad3212aaff5515) Ci sono due comandi nell'esempio che generano un collegamento nel documento finale: **\href{ Linky}** Ci sono due parametri passati a questo comando: il primo è l'URL del collegamento, in questo caso , e il secondo è il testo cliccabile da mostrare, Something Linky. **\url{** Questo comando mostrerà l'URL passato come parametro e lo trasformerà in un collegamento, utile se stamperai il documento. [Apri un esempio del pacchetto hyperref in Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Collegamento di file locali I comandi `\href` e `\url` presentati nella sezione precedente possono essere usati per aprire file locali ```latex Per ulteriori riferimenti vedi \href{http://www.overleaf.com}{Something Linky} oppure vai all'URL successivo: \url{http://www.overleaf.com} oppure apri il successivo file \href{run:./file.txt}{File.txt} ``` ![HyperlinkExampleUpdatedMoreNext.png](/files/0af44ba0f62fb6d6e117ca36a6469141f6eeb6f2) Il comando `\href{run:./file.txt}{File.txt}` stampa il testo `File.txt` che punta a un file locale chiamato `file.txt` situato nella directory di lavoro corrente. Nota il testo `run:` prima del percorso del file. Il percorso del file segue le convenzioni dei sistemi UNIX, usando `.` per fare riferimento alla directory corrente e `..` per la directory precedente. Il comando `\url{}` può anche essere usato, con la stessa sintassi descritta per il percorso, ma sono stati segnalati alcuni problemi. [Apri un esempio del pacchetto hyperref in Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Inserimento manuale di collegamenti È stato detto in precedenza che tutti gli elementi con riferimenti incrociati diventano collegamenti una volta che **hyperref** è importato, quindi possiamo usare `\label` in qualsiasi punto del documento e richiamare in seguito queste etichette per creare collegamenti. Questo non è l'unico modo per inserire manualmente collegamenti ipertestuali. ```latex È anche possibile collegare direttamente qualsiasi parola o \hyperlink{thesentence}{qualsiasi frase} nel tuo documento. Se leggi questo testo, non riceverai alcuna informazione. Davvero? Non c'è alcuna informazione? Per esempio \hypertarget{thesentence}{questa frase}. ``` ![HyperlinkExampleUpdatedMoreNextAgain.png](/files/d007f792d35730ebc8c5c2e63e800f3d0e21b2a0) Ci sono due comandi per creare collegamenti definiti dall'utente. **\hypertarget{thesentence}{questa frase}** Il primo parametro passato tra parentesi graffe a questo comando è un identificatore univoco per questa frase. Il secondo parametro è il testo "questa frase" e verrà stampato normalmente (a seconda del valore di anchorcolor, vedi la guida di riferimento), ma quando si fa clic su un collegamento che punta all'identificatore "thesentence" il file PDF scorrerà fino a questo punto. **\hyperlink{thesentence}{qualsiasi frase}** Questo comando stampa il testo "qualsiasi frase" come elemento cliccabile che reindirizza al punto il cui identificatore è "thesentence". [Apri un esempio del pacchetto hyperref in Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=\&mainFile=main.tex) ## Opzioni specifiche per PDF I collegamenti in un documento vengono creati pensando a un documento che sarà letto in formato PDF. Il file PDF può essere ulteriormente personalizzato per aggiungere informazioni aggiuntive e modificare il modo in cui il visualizzatore PDF lo mostra. Di seguito un esempio: ```latex \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Overleaf Example}, pdfpagemode=FullScreen, } ``` ![Pdftitle.png](/files/107062ee53677f6c83bdafc60d40725161e1a89c) Usando il comando `\hypersetup`, descritto nella sezione [stili e colori](#styles-and-colours), accetta parametri aggiuntivi per configurare il file PDF finale. **pdftitle={Overleaf Example}** È il titolo del file PDF di output, da visualizzare nella barra del titolo della finestra. Nell'esempio è "Overleaf Example". **pdfpagemode=FullScreen** Il documento verrà aperto in modalità a schermo intero dal lettore PDF. Vedi la [guida di riferimento](#reference-guide) per un elenco completo delle opzioni che possono essere passate a `\hypersetup`. [Apri un esempio del pacchetto hyperref in Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Guida di riferimento **Opzioni di stile dei collegamenti** | Opzione | Valore predefinito | Descrizione | | ------------- | ------------------ | ----------------------------------------------------------------------------------------------------- | | `hyperindex` | true | Trasforma i numeri di pagina delle voci dell'indice in collegamenti ipertestuali | | `linktocpage` | false | Fa sì che siano i numeri di pagina, invece del testo, a essere collegati nell'indice. | | `breaklinks` | false | Consente ai collegamenti di essere spezzati su più righe. | | `colorlinks` | false | Colora il testo dei collegamenti e degli ancoraggi; questi colori appariranno nella versione stampata | | `linkcolor` | red | Colore per i collegamenti interni normali | | `anchorcolor` | black | Colore per il testo dell'ancora (destinazione) | | `citecolor` | green | Colore per le citazioni bibliografiche | | `filecolor` | cyan | Colore per i collegamenti che aprono file locali | | `urlcolor` | magenta | Colore per gli URL collegati | | `frenchlinks` | false | Usa il maiuscoletto invece dei colori per i collegamenti | **Opzioni specifiche per PDF** | Opzione | Valore predefinito | Descrizione | | ----------------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------- | | `bookmarks` | true | Vengono scritti i segnalibri di Acrobat, in modo simile all'indice. | | `bookmarksopen` | false | I segnalibri vengono mostrati con tutti i sottoalberi espansi. | | `citebordercolor` | 0 1 0 | Colore del riquadro attorno alle citazioni in formato RGB. | | `filebordercolor` | 0 .5 .5 | Colore del riquadro attorno ai collegamenti ai file in formato RGB. | | `linkbordercolor` | 1 0 0 | Colore del riquadro attorno ai collegamenti normali in formato RGB. | | `menubordercolor` | 1 0 0 | Colore del riquadro attorno ai collegamenti del menu in formato RGB. | | `urlbordercolor` | 0 1 1 | Colore del riquadro attorno ai collegamenti agli URL in formato RGB. | | `pdfpagemode` | empty | Determina come viene aperto il file. Le possibilità sono UseThumbs (miniature), UseOutlines (segnalibri) e FullScreen. | | `pdftitle` | | Imposta il titolo del documento. | | `pdfauthor` | | Imposta l'autore del documento. | | `pdfstartpage` | 1 | Determina su quale pagina viene aperto il file PDF. | ## Approfondimenti Per maggiori informazioni vedi * [Indice](/latex/it/struttura-del-documento/02-table-of-contents.md) * [Sezioni e capitoli](/latex/it/struttura-del-documento/01-sections-and-chapters.md) * [Riferimenti incrociati tra sezioni ed equazioni](/latex/it/struttura-del-documento/03-cross-referencing-sections-equations-and-floats.md) * [Uso dei colori in LaTeX](/latex/it/formattazione/13-using-colors-in-latex.md) * [Gestione in un grande progetto](/latex/it/struttura-del-documento/07-management-in-a-large-project.md) * [Manuale di Hyperref](http://repositorios.cpai.unb.br/ctan/macros/latex/contrib/hyperref/doc/manual.pdf) * [Articolo sui collegamenti ipertestuali su Wikibooks](http://en.wikibooks.org/wiki/LaTeX/Hyperlinks) --- # 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/struttura-del-documento/09-hyperlinks.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.