> 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/01-sections-and-chapters.md). # Sezioni e capitoli ## Introduzione I documenti di solito hanno una qualche forma di “struttura logica”: divisione in capitoli, sezioni, sottosezioni, ecc. per organizzare il contenuto. LaTeX supporta la creazione di una struttura del documento e consente anche di personalizzare la suddivisione in sezioni e la numerazione. I comandi disponibili per organizzare un documento dipendono dalla classe del documento utilizzata, anche se la forma più semplice di organizzazione, la suddivisione in sezioni, è disponibile in tutti i formati. ## Esempio di base Cominciamo con un esempio di base per dimostrare il `\section{*section title*}` comando, che segna l'inizio di una nuova sezione chiamata `*section title*`. La numerazione delle sezioni è automatica e può essere personalizzata o disattivata. ```latex \documentclass{article} \usepackage{blindtext} \title{Sections and Chapters} \author{Overleaf} \date{\today} \begin{document} \maketitle \section{Introduction} Questa è la prima sezione. \blindtext \section{Second Section} Questa è la seconda sezione \blindtext \end{document} ``` [Apri questo esempio in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+document+structure+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bblindtext%7D%0A%0A%5Ctitle%7BSections+and+Chapters%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A%5Csection%7BIntroduction%7D%0A%0AThis+is+the+first+section.%0A%0A%5Cblindtext%0A%0A%5Csection%7BSecond+Section%7D%0AThis+is+the+second+section%0A%0A%5Cblindtext%0A%5Cend%7Bdocument%7D) Questo esempio produce il seguente output: ![Esempio di sezioni e capitoli](/files/ff9b4228fa4e0ecb25d0bdda224c3d21b059659b) ## Divisione del documento in sezioni LaTeX può organizzare, numerare e indicizzare capitoli e sezioni di un documento. Ci sono fino a 7 livelli di profondità per definire le sezioni a seconda della classe del documento: | | | | -- | ------------------------------- | | -1 | `\part{part}` | | 0 | `\chapter{chapter}` | | 1 | `\section{section}` | | 2 | `\subsection{subsection}` | | 3 | `\subsubsection{subsubsection}` | | 4 | `\paragraph{paragraph}` | | 5 | `\subparagraph{subparagraph}` | Di solito, `\section` è il comando di livello superiore nella maggior parte dei documenti. Tuttavia, nei report o nei libri e in documenti lunghi simili, questo sarebbe `\chapter` oppure `\part`. ## Sezioni numerate e non numerate Per ottenere un capitolo, una sezione, una sottosezione, ecc. non numerati, aggiungi un asterisco (`*`) alla fine del comando, prima della parentesi graffa aperta. Questi non verranno inseriti nell'indice. Ecco il nostro primo esempio (sopra) ma questa volta usando `\section*` al posto di `\section`: ```latex \documentclass{article} \usepackage{blindtext} \title{Sections and Chapters} \author{Overleaf} \date{\today} \begin{document} \maketitle \section*{Introduction} Questa è la prima sezione. \blindtext \section*{Second Section} Questa è la seconda sezione \blindtext \end{document} ``` [Apri questo esempio in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+with+unnumbered+sections\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bblindtext%7D%0A%0A%5Ctitle%7BSections+and+Chapters%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A%5Csection%2A%7BIntroduction%7D%0A%0AThis+is+the+first+section.%0A%0A%5Cblindtext%0A%0A%5Csection%2A%7BSecond+Section%7D%0AThis+is+the+second+section%0A%0A%5Cblindtext%0A%5Cend%7Bdocument%7D) Questo esempio produce il seguente output: ![Esempio di sezioni non numerate](/files/ed089159a257cc4eb0e111862cb864b9ac5547c7) ### Sezioni non numerate nell'indice Per aggiungere una sezione non numerata all'indice, usa il `\addcontentsline` comando in questo modo: ```latex \addcontentsline{toc}{section}{Title of the section} ``` Ecco un esempio che usa `\addcontentsline` ma consulta l'articolo [Indice](/latex/it/struttura-del-documento/02-table-of-contents.md) per ulteriori informazioni ed esempi. ```latex \documentclass{article} \title{Sections and Chapters} \author{Overleaf} \date{\today} \begin{document} \maketitle \tableofcontents \newcommand\shortlorem{Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.} \section{Introduction} Questa è la prima sezione (numerata). \shortlorem \addcontentsline{toc}{section}{Unnumbered Section} \section*{Unnumbered Section} Una sezione non numerata \shortlorem \section{Second section} La seconda sezione numerata. \shortlorem \end{document} ``` [Apri questo esempio in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+unnumbered+sections+in+the+TOC\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BSections+and+Chapters%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A%5Ctableofcontents%0A%0A%5Cnewcommand%5Cshortlorem%7BLorem+ipsum+dolor+sit+amet%2C+consectetur+adipiscing+elit%2C+sed+do+eiusmod+tempor+incididunt+ut+labore+et+dolore+magna+aliqua.+Ut+enim+ad+minim+veniam%2C+quis+nostrud+exercitation+ullamco+laboris+nisi+ut+aliquip+ex+ea+commodo+consequat.%7D%0A%0A%5Csection%7BIntroduction%7D%0AThis+is+the+first+section+%28numbered%29.%0A%0A%5Cshortlorem%0A%5Caddcontentsline%7Btoc%7D%7Bsection%7D%7BUnnumbered+Section%7D%0A%5Csection%2A%7BUnnumbered+Section%7D%0AAn+unnumbered+section%0A%0A%5Cshortlorem%0A%0A%5Csection%7BSecond+section%7D%0AThe+second+numbered+section.%0A%0A%5Cshortlorem%0A%5Cend%7Bdocument%7D) Questo esempio produce il seguente output: ![Sezioni non numerate nell'indice](/files/fbf45060ae0019ca41d98b9bb48b5aeaa1943a19) ## Capitoli e sezioni di un documento in un libro/report Come detto in precedenza, `\chapter` può essere usato in libri e report. ### La classe report Qui sotto puoi vedere un esempio `report` che usa testo tratto dall'articolo di Overleaf [Un'introduzione a LuaTeX (Parte 1): che cos'è — e cosa lo rende così diverso?](/latex/it/articoli-approfonditi/07-an-introduction-to-luatex-part-1-what-is-it-and-what-makes-it-so-different.md) ```latex \documentclass{report} \title{Sections and Chapters} \author{Overleaf} \date{\today} \begin{document} \maketitle \tableofcontents \chapter{An Introduction to Lua\TeX} \section{What is it—and what makes it so different?} Lua\TeX{} è un \textit{toolkit}—contiene strumenti software sofisticati e componenti con cui puoi costruire (comporre) un'ampia gamma di documenti. Il sottotitolo di questo articolo pone anche due domande su Lua\TeX: che cos'è — e cosa lo rende così diverso? La risposta a “What is it?” può sembrare ovvia: “È un motore di composizione tipografica \TeX{}!” In effetti lo è, ma una visione più ampia, e a cui questo autore aderisce, è che Lua\TeX{} è un sistema di costruzione e ingegneria dei documenti estremamente versatile basato su \TeX{}. \subsection{Explaining Lua\TeX: Where to start?} L'obiettivo di questo primo articolo su Lua\TeX{} è offrire un contesto per capire cosa fornisce questo motore TeX e perché/in che modo il suo design consente agli utenti di costruire/progettare/creare un'ampia gamma di soluzioni a complessi problemi di composizione tipografica e di design—offrendo forse anche un certo grado di “a prova di futuro” \chapter{Lua\TeX: Background and history} \section{Introduction} Lua\TeX{} è, in termini di \TeX{}, “il nuovo arrivato” nonostante sia in sviluppo attivo da oltre 10 anni. \subsection{Lua\TeX: Opening up \TeX’s “black box”} Il programma \TeX{} originale di Knuth è l'antenato comune di tutti i moderni motori \TeX{} in uso oggi e Lua\TeX{} è, di fatto, l'ultimo passo evolutivo: derivato dal programma pdf\TeX{} ma con l'aggiunta di alcuni potenti componenti software che apportano molte funzionalità extra. \end{document} ``` [Apri questo esempio in Overleaf (usando `lualatex`)]() Questo esempio produce il seguente output—qui mostriamo le pagine 2–4, dove le immagini delle pagine sono state sovrapposte per facilitare la presentazione: ![Un report LaTeX tipico](/files/d0dede5500424ac6ce563f19c6fe6b6c69f70e8f) ### La classe book Il seguente esempio riproduce testo tratto dall' `report` esempio ma con `\documentclass{book}`, contenente parti, capitoli, sezioni, sottosezioni e sottosottosezioni. Se apri l'esempio in Overleaf dovresti vedere che le sottosottosezioni prodotte da `\subsubsection` sono *non* numerate. Questo è voluto dalla `book` class: se vuoi cambiare questo comportamento, aggiungi il seguente comando nel preambolo del documento: ```latex \setcounter{secnumdepth}{3} ``` ```latex \documentclass{book} \title{Sections and Chapters} \author{Overleaf} \date{\today} \begin{document} \maketitle \tableofcontents \part{History of Lua\TeX} \chapter{An Introduction to Lua\TeX} \section{What is it—and what makes it so different?} Lua\TeX{} è un \textit{toolkit}—contiene strumenti software sofisticati e componenti con cui puoi costruire (comporre) un'ampia gamma di documenti. Il sottotitolo di questo articolo pone anche due domande su Lua\TeX: che cos'è — e cosa lo rende così diverso? La risposta a “What is it?” può sembrare ovvia: “È un motore di composizione tipografica \TeX{}!” In effetti lo è, ma una visione più ampia, e a cui questo autore aderisce, è che Lua\TeX{} è un sistema di costruzione e ingegneria dei documenti estremamente versatile basato su \TeX{}. \subsection{Explaining Lua\TeX: Where to start?} L'obiettivo di questo primo articolo su Lua\TeX{} è offrire un contesto per capire cosa fornisce questo motore TeX e perché/in che modo il suo design consente agli utenti di costruire/progettare/creare un'ampia gamma di soluzioni a complessi problemi di composizione tipografica e di design—offrendo forse anche un certo grado di “a prova di futuro” \chapter{Lua\TeX: Background and history} \section{Introduction} Lua\TeX{} è, in termini di \TeX{}, “il nuovo arrivato” nonostante sia in sviluppo attivo da oltre 10 anni. \subsection{Lua\TeX: Opening up \TeX’s “black box”} Il programma \TeX{} originale di Knuth è l'antenato comune di tutti i moderni motori \TeX{} in uso oggi e Lua\TeX{} è, di fatto, l'ultimo passo evolutivo: derivato dal programma pdf\TeX{} ma con l'aggiunta di alcuni potenti componenti software che apportano molte funzionalità extra. \subsubsection{How Lua\TeX{} processes \texttt{\string\directlua}: A first look} Il ⟨code⟩ fornito a \verb|\directlua{}| viene prima convertito in token usando i processi e i calcoli discussi sopra; quella sequenza di token viene memorizzata in una lista di token. \end{document} ``` [Per vedere l'output, **apri questo esempio in Overleaf** (usa `**lualatex**`)](}|+is+first+converted+to+tokens+using+the+processes+and+calculations+discussed+above;+that+sequence+of+tokens+is+stored+in+a+token+list. \end{document}>) ## Personalizza capitoli e sezioni Puoi usare il [`titlesec`](https://ctan.org/pkg/titlesec?lang=en) pacchetto per personalizzare in modo semplice lo stile di capitoli, sezioni e sottosezioni. ```latex \documentclass[a4paper,12pt]{book} \usepackage[T1]{fontenc} \usepackage{titlesec} \titleformat {\chapter} % command [display] % shape {\bfseries\Large\itshape} % format {Story No. \ \thechapter} % label {0.5ex} % sep { \rule{\textwidth}{1pt} \vspace{1ex} \centering } % before-code [ \vspace{-0.5ex}% \rule{\textwidth}{0.3pt} ] % after-code \titleformat{\section}[wrap] {\normalfont\bfseries} {\thesection.}{0.5em}{} \titlespacing{\section}{12pc}{1.5ex plus .1ex minus .2ex}{1pc} \begin{document} \chapter{Let's begin} \section{First Attempt} Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris... \section{Second attempt} Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris... \end{document} ``` [Apri questo `titlesec` esempio in Overleaf.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=titlesec+example\&snip=%5Cdocumentclass%5Ba4paper%2C12pt%5D%7Bbook%7D%0A%5Cusepackage%5BT1%5D%7Bfontenc%7D%0A%5Cusepackage%7Btitlesec%7D%0A%0A%5Ctitleformat%0A%7B%5Cchapter%7D+%25+command%0A%5Bdisplay%5D+%25+shape%0A%7B%5Cbfseries%5CLarge%5Citshape%7D+%25+format%0A%7BStory+No.+%5C+%5Cthechapter%7D+%25+label%0A%7B0.5ex%7D+%25+sep%0A%7B%0A++++%5Crule%7B%5Ctextwidth%7D%7B1pt%7D%0A++++%5Cvspace%7B1ex%7D%0A++++%5Ccentering%0A%7D+%25+before-code%0A%5B%0A%5Cvspace%7B-0.5ex%7D%25%0A%5Crule%7B%5Ctextwidth%7D%7B0.3pt%7D%0A%5D+%25+after-code%0A%0A%0A%5Ctitleformat%7B%5Csection%7D%5Bwrap%5D%0A%7B%5Cnormalfont%5Cbfseries%7D%0A%7B%5Cthesection.%7D%7B0.5em%7D%7B%7D%0A%0A%5Ctitlespacing%7B%5Csection%7D%7B12pc%7D%7B1.5ex+plus+.1ex+minus+.2ex%7D%7B1pc%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cchapter%7BLet%27s+begin%7D%0A%5Csection%7BFirst+Attempt%7D%0A%0ALorem+ipsum+dolor+sit+amet%2C+consectetur+adipiscing+elit%2C+sed+do+%0Aeiusmod+tempor+incididunt+ut+labore+et+dolore+magna+aliqua.+Ut+%0Aenim+ad+minim+veniam%2C+quis+nostrud+exercitation+ullamco+laboris...%0A%0A%5Csection%7BSecond+attempt%7D%0A%0ALorem+ipsum+dolor+sit+amet%2C+consectetur+adipiscing+elit%2C+sed+do+%0Aeiusmod+tempor+incididunt+ut+labore+et+dolore+magna+aliqua.+Ut+%0Aenim+ad+minim+veniam%2C+quis+nostrud+exercitation+ullamco+laboris...%0A%0A%5Cend%7Bdocument%7D) Questo esempio produce il seguente output: ![Titlesecolv2.png](/files/3bef802413a5f63c994a6c9057a702c0ddfb5430) ### comandi titlesec Ci sono due comandi generali: ```latex \titleformat{}[]{}{