> 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/formattazione/15-margin-notes.md). # Note a margine ## Introduzione Questo articolo spiega come creare note a margine, una popolare alternativa alle note a piè di pagina come strumento per aggiungere informazioni supplementari a supporto del testo principale di un documento. Abbiamo anche una [pagina di aiuto su `todonotes` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](/latex/it/domande-e-risposte/04-can-i-add-inline-or-margin-comments-to-the-pdf.md) che offre soluzioni alternative a quelle presentate in questo articolo. ## Il comando \marginpar Senza caricare pacchetti aggiuntivi, puoi usare il comando LaTeX integrato `\marginpar` per aggiungere note a margine al tuo documento. La forma generale del `\marginpar` comando è `\marginpar[*testo a sinistra*]{*testo a destra*}` dove `*testo a sinistra*` sarà usato se la nota a margine appare a sinistra di una pagina del documento e `*testo a destra*` se appare a destra. Più precisamente, le note marginali sono normalmente collocate sul “lato esterno” della pagina—anche se il significato di “esterno” dipende dalla classe di documento che stai usando e dal fatto che tu abbia specificato l `twoside` opzione del pacchetto: * `libro` classe (`\documentclass{book})` i documenti sono a due facciate per impostazione predefinita (design) * `relazione` classe (`\documentclass{report}`) e `article` classe (`\documentclass{article}`) i documenti sono, per impostazione predefinita, monofacciali. Per renderli bifacciali devi specificare l `twoside` opzione: * `\documentclass[twoside]{report}`, oppure * `\documentclass[twoside]{article}` Per i documenti monofacciali, escludendo le lingue da destra a sinistra, come l'arabo, il “lato esterno” è sempre il bordo destro del testo e, per i documenti bifacciali, è il bordo sinistro del testo per le pagine sinistre e il bordo destro del testo per le pagine destre. ### Invertire la posizione delle note a margine Il comando `\reversemarginpar` inverte il lato su cui vengono composte le note a margine; il suo effetto può essere annullato dal comando `\normalmarginpar`. Come indicato nella documentazione del codice sorgente LaTeX, “Questi comandi non hanno alcun effetto per l'output a due colonne.” ### Comandi che influenzano la composizione delle note a margine La composizione delle `\marginpar` note si avvale di diversi comandi di dimensione che memorizzano valori che possono essere modificati, se necessario: * `\marginparwidth`: determina la larghezza delle note a margine e quindi la lunghezza delle righe composte nella nota a margine. * `\marginparsep`: imposta lo spazio (distanza) tra le note a margine e il testo del documento. * `\marginparpush`: definisce la distanza minima di separazione (verticale) tra `\marginpar` le note. ### Modificare la composizione delle note a margine: allineamento a destra e a sinistra irregolari Per impostazione predefinita, il testo di una nota a margine è composto in un riquadro che produce righe di larghezza `\marginparwidth`. Questo può causare spazi antiestetici tra le parole composte, mentre il motore TeX cerca di trovare le interruzioni di riga “migliori”. Puoi usare i comandi `\raggedright` e `\raggedleft` per modificare lo stile di composizione del testo. ### Esempio Ecco un esempio che usa diversi `\marginpar` comandi per mostrare alcune delle funzionalità elencate sopra. L'esempio carica anche il [`pacchetto geometry`](https://ctan.org/pkg/geometry) pacchetto per creare una dimensione di pagina ridotta e il [`hyperref`](https://ctan.org/pkg/hyperref) pacchetto che fornisce il `\url` comando usato per citare la fonte del testo (nella nota a piè di pagina). ```latex \documentclass[twoside]{article} % Note: uses twoside option \usepackage[a4paper, marginparwidth=75pt, total={10cm, 10cm}]{geometry} % To create a small page \usepackage{hyperref} % To use the \url command (in the footnote) \usepackage{marginnote} \begin{document} \section{Lorem Ipsum} \footnote{Testo sorgente: Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}Ma devo spiegarti come nacque tutta questa errata idea di condannare il piacere ed esaltare il dolore. Per farlo, ti darò un resoconto completo del sistema ed esporrò i veri insegnamenti del grande esploratore della verità, l'artefice della felicità umana. \marginpar[Nota 1: testo per il lato sinistro]{Nota 1: testo per il lato destro delle pagine, è giustificato.} Nessuno rifiuta, detesta o evita il piacere in sé, perché è piacere, ma perché coloro che non sanno perseguire razionalmente il piacere si imbattono in conseguenze estremamente dolorose. Né c'è qualcuno che ami o insegua o desideri ottenere il dolore in quanto tale, perché è dolore, ma talvolta si verificano circostanze in cui la fatica e il dolore possono procurargli un grande piacere. \marginpar[Nota 2: testo per il lato sinistro]{\raggedright Nota 2: testo per il lato destro delle pagine, non è giustificato, ma usa \texttt{\string\raggedright}.} Per fare un esempio banale, quale di noi intraprende mai un esercizio fisico faticoso, se non per trarne qualche vantaggio? Ma chi ha il diritto di criticare un uomo che sceglie di godere di un piacere che non ha conseguenze fastidiose, o di uno che evita un dolore che non produce alcun piacere risultante? [33] D'altra parte, condanniamo con giusta indignazione e disprezzo gli uomini che sono così sedotti e demoralizzati dalle lusinghe del piacere del momento, così accecati dal desiderio, che non possono prevedere il dolore e i problemi che inevitabilmente seguiranno; e uguale colpa ricade su coloro che falliscono nel loro dovere per debolezza di volontà, il che equivale a dire per il rifuggire dalla fatica e dal dolore. Questi casi sono perfettamente semplici e facili da distinguere. In un'ora di libertà, quando il nostro potere di scelta è senza ostacoli e nulla impedisce di fare ciò che preferiamo di più, ogni piacere va accolto e ogni dolore evitato. \marginpar[\raggedleft Nota 3: testo per il lato sinistro delle pagine, non è giustificato, ma usa \texttt{\string\raggedleft}]{Nota 3: testo per il lato sinistro delle pagine}Ma in determinate circostanze e a causa delle esigenze del dovere o degli obblighi di lavoro, spesso accade che i piaceri debbano essere respinti e le seccature accettate. Il saggio quindi, in queste materie, si attiene sempre a questo principio di scelta: rifiuta i piaceri per assicurarsi altri piaceri più grandi, oppure sopporta dolori per evitare dolori peggiori. \end{document} ``` Apri questo `\marginpar` esempio in Overleaf Questo esempio produce il seguente output (due pagine): Pagina 1: ![Esempio del comando \marginpar](/files/94681647a9f677289408051f86b7efd637333ed2) Pagina 2: ![Esempio del comando \marginpar](/files/488e2685f90514b2175a74bd1877c24f4c6db34b) ### Il pacchetto mparhack: correggere il margine sbagliato Internamente, LaTeX elabora le note a margine come una sorta di componente “flottante” del documento—simile al modo in cui LaTeX gestisce figure e tabelle flottanti. Essendo "float", le note a margine prodotte da `\marginpar` possono occasionalmente apparire nel margine sbagliato. Il [`mparhack` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/mparhack/mparhack.pdf) è stato scritto per risolvere questo problema, quindi potrebbe valere la pena usarlo se lo incontri. ## Un'alternativa a \marginpar: il pacchetto marginnote Il [`marginnote` che fornisce i comandi e le funzionalità necessarie per includere file grafici esterni. L'esempio sopra carica il](https://www.ctan.org/pkg/marginnote) offre un'alternativa versatile a `\marginpar` comando. `marginnote` implementa le note a margine usando un meccanismo non flottante, che è diverso da come `\marginpar` funziona: `marginnote` risolve alcuni problemi ma, come nota la sua documentazione, può introdurne altri. ### Esempio L'esempio seguente mostra il `\marginnote` comando fornito dal `marginnote` pacchetto: ```latex \documentclass{article} \usepackage[a5paper, total={3in, 6in}]{geometry} % to create a small page \usepackage{hyperref} % To use the \url command (in the footnote) \usepackage{marginnote} \begin{document} \section{Lorem Ipsum} \footnote{Testo sorgente: Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}Ma devo spiegarti come nacque tutta questa errata idea di condannare il piacere ed esaltare il dolore. Per farlo, ti darò un resoconto completo del sistema ed esporrò i veri insegnamenti del grande esploratore della verità, l'artefice della felicità umana. \marginnote{Questa è una nota a margine spostata di 2 cm, \textit{verso il basso} nella pagina, rispetto alla riga in cui è composta.}[2cm] Nessuno rifiuta, detesta o evita il piacere in sé, perché è piacere, ma perché coloro che non sanno perseguire razionalmente il piacere si imbattono in conseguenze estremamente dolorose. Né c'è qualcuno che ami o insegua o desideri ottenere il dolore in quanto tale, perché è dolore, ma talvolta si verificano circostanze in cui la fatica e il dolore possono procurargli un grande piacere. \reversemarginpar\marginnote{Questa è un'altra nota a margine, ma spostata di 2 cm \textit{verso l'alto} nella pagina, rispetto alla riga in cui è composta. È anche nel margine sinistro.}[-2cm] Per fare un esempio banale, quale di noi intraprende mai un esercizio fisico faticoso, se non per trarne qualche vantaggio? Ma chi ha il diritto di criticare un uomo che sceglie di godere di un piacere che non ha conseguenze fastidiose, o di uno che evita un dolore che non produce alcun piacere risultante? [33] D'altra parte, condanniamo con giusta indignazione e disprezzo gli uomini che sono così sedotti e demoralizzati dalle lusinghe del piacere del momento, così accecati dal desiderio, che non possono prevedere il dolore e i problemi che inevitabilmente seguiranno; e uguale colpa ricade su coloro che falliscono nel loro dovere per debolezza di volontà, il che equivale a dire per il rifuggire dalla fatica e dal dolore. Questi casi sono perfettamente semplici e facili da distinguere. In un'ora di libertà, quando il nostro potere di scelta è senza ostacoli e nulla impedisce di fare ciò che preferiamo di più, ogni piacere va accolto e ogni dolore evitato. Ma in determinate circostanze e a causa delle esigenze del dovere o degli obblighi di lavoro, spesso accade che i piaceri debbano essere respinti e le seccature accettate. Il saggio quindi, in queste materie, si attiene sempre a questo principio di scelta: rifiuta i piaceri per assicurarsi altri piaceri più grandi, oppure sopporta dolori per evitare dolori peggiori. \end{document} ``` Apri questo esempio in Overleaf Questo esempio produce il seguente output: ![Uso del pacchetto marginnote](/files/d81212dd3eb72b541c32d52f456fd79411c7cf0f) L'esempio sopra carica anche il `pacchetto geometry` pacchetto per creare una dimensione di pagina ridotta e il `hyperref` pacchetto che fornisce il `\url` comando usato per citare la fonte del testo (nella nota a piè di pagina). Dopo aver importato il `marginnote` pacchetto scrivendo `\usepackage{marginnote}` puoi usare il `\marginnote` comando come mostrato dalle due istanze nel testo di esempio: * `\marginnote{Questa è una nota a margine spostata di 2 cm, \textit{verso il basso} nella pagina, rispetto alla riga in cui è composta.}[2cm]` * `\marginnote{Questa è un'altra nota a margine, ma spostata di 2 cm \textit{verso l'alto} nella pagina, rispetto alla riga in cui è composta. È anche nel margine sinistro.}[-2cm]` In questi esempi usiamo un secondo parametro tra parentesi quadre `[ ]` che determina l'allineamento verticale rispetto alla riga in cui viene usato il comando. Il primo `\margingnote` comando usa `[2cm]` per spostare la nota a margine di 2 cm *verso il basso nella pagina*, il secondo usa `[-2cm]` per spostare la nota a margine di 2 cm *verso l'alto nella pagina*. Il secondo `\marginnote` comando agisce dopo che è stato usato un `\reversemarginpar` è stato usato, facendolo collocare nel margine sinistro di questo documento monofacciale: ```latex \reversemarginpar\marginnote{Questa è un'altra nota a margine, ma spostata di 2 cm \textit{verso l'alto} nella pagina, rispetto alla riga in cui è composta. È anche nel margine sinistro.}[-2cm] ``` ## Approfondimenti Per maggiori informazioni vedi * [Il `marginnote` documentazione del pacchetto](http://www.ctan.org/pkg/marginnote) * [Il `mparhack` documentazione del pacchetto](http://www.ctan.org/pkg/mparhack) * [Dimensione della pagina e margini](/latex/it/formattazione/07-page-size-and-margins.md) * [Note a piè di pagina](/latex/it/formattazione/14-footnotes.md) * [Lunghezze in LaTeX](/latex/it/formattazione/01-lengths-in-latex.md) * [Documenti a facciata singola e doppia](/latex/it/formattazione/08-single-sided-and-double-sided-documents.md) * [Colonne multiple](/latex/it/formattazione/09-multiple-columns.md) * [Intestazioni e piè di pagina](/latex/it/formattazione/02-headers-and-footers.md) * [Formattazione dei paragrafi](/latex/it/formattazione/04-articles-how-to-change-paragraph-spacing-in-latex.md) * [Grassetto, corsivo e sottolineatura](/latex/it/concetti-di-base-di-latex/03-bold-italics-and-underlining.md) * [Dimensioni, famiglie e stili dei caratteri](/latex/it/caratteri/01-font-sizes-families-and-styles.md) --- # 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/formattazione/15-margin-notes.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.