La struttura del documento: introduzione

Riepilogo

Questa lezione apre la terza unità del corso, dedicata alla struttura del documento. Spiega a che cosa serve l’unità: passare dal testo ben composto dell’unità precedente a un documento lungo con un’architettura propria, le cui parti si numerano, si elencano in un indice, rinviano le une alle altre e si distribuiscono in più file; presenta le sue cinque lezioni e il filo che le unisce, dalla classe del documento e dalla pagina fino al preambolo personale; precisa che cosa si dà per scontato delle unità precedenti; ricorda da dove provengono le forme dei documenti accademici; formula il problema che l’unità risolve, cioè che un documento i cui rinvii e numeri sono scritti a mano comincia a mentire non appena cambia; e mostra che questa architettura serve tanto a una tesi di fisica quanto a una di storia.

Obiettivi di apprendimento

Descrivere la sequenza dei contenuti dell’unità e spiegare che cosa ogni lezione apporta alla successiva.
Riconoscere che cosa l’unità dà per scontato delle precedenti e ripassarlo se necessario.
Spiegare, con un esempio, perché i rinvii interni non si scrivono a mano.
Riconoscere nei generi accademici di diverse discipline la struttura che l’unità insegna a comporre.

Valutazione d’ingresso

Prima di percorrere l’unità conviene misurare il punto di partenza. Questa valutazione è un’autovalutazione: non riceve voto, e il suo unico scopo è orientare lo studio. Le prime due domande ripassano ciò che l’unità dà per scontato delle precedenti; le dieci successive toccano, a due a due e in ordine, le cinque lezioni dell’unità. Chi non ha mai composto un documento lungo non deve aspettarsi di rispondere correttamente: ogni risposta, giusta o no, spiega il punto e indica la lezione che lo tratta. Le stesse abilità si misurano di nuovo alla fine, nella lezione di sintesi.

Valutazione d’ingresso

Prima di iniziare l’unità, misura il tuo punto di partenza. È un’autovalutazione breve: non riceve voto e il risultato resta solo nel tuo browser.

Domanda 1Dalle unità precedentiDopo la prima compilazione di un documento, un rinvio fatto con \ref appare come due punti interrogativi, e il log chiede di compilare di nuovo. Che cosa succede?
Nel primo passaggio il motore ha annotato i numeri nel file ausiliario, ma può usarli solo nel passaggio successivo; basta compilare di nuovo, o compilare con latexmk.
L’etichetta è scritta male, e bisogna correggerla.
Manca un pacchetto per i riferimenti.
Il file ausiliario è danneggiato e bisogna cancellarlo.
Domanda 2Dalle unità precedentiUn saggio marca i titoli delle opere con \opera{…}, definita nel preambolo come \newcommand{\opera}[1]{\emph{#1}}, invece di scrivere \textit{…} in ogni punto. Che cosa ci guadagna?
L’aspetto di tutti i titoli si cambia in una sola riga, senza toccare altri corsivi che svolgono altre funzioni.
Niente, perché il risultato è lo stesso.
La compilazione è più rapida.
I titoli entrano da soli nell’indice.
Domanda 3Uno studente scrive la tesi con \documentclass{article} e divide il testo con \chapter{…}. Che cosa succede alla compilazione?
Il motore produce l’errore «Undefined control sequence», perché la classe article non ha capitoli.
I capitoli vengono composti come sezioni.
I capitoli vengono composti correttamente, perché tutte le classi hanno le stesse divisioni.
Vengono ignorati senza avviso.
Domanda 4Un’università richiede margini di 2,5 centimetri su carta A4. Qual è il modo adeguato di fissarli?
Con il pacchetto geometry, per esempio \usepackage[a4paper, margin=2.5cm]{geometry} nel preambolo.
Con l’opzione di classe a4paper, che fissa i margini.
Con \hspace all’inizio di ogni riga.
Riducendo la dimensione del carattere con \small.
Domanda 5In un documento di classe article si scrive \setcounter{tocdepth}{1} prima di \tableofcontents. Che cosa mostra l’indice?
Solo le sezioni, senza le sottosezioni.
Solo le sottosezioni.
Niente, perché l’indice resta vuoto.
Tutte le divisioni, ma senza numeri.
Domanda 6In un documento di classe article, dopo il comando \appendix, si scrivono due \section. Come vengono numerate?
Con lettere: A e B.
Proseguono la numerazione precedente, come sezioni ordinarie.
Senza numero, come le sezioni con asterisco.
Con numeri romani: I e II.
Domanda 7Un autore scrive \label{sec:metodi} nella riga che precede \section{Metodi}, che è la sezione 2. Quale numero stampa \ref{sec:metodi}?
Quello della divisione precedente, 1, perché l’etichetta prende l’ultimo numero assegnato prima di essa.
Il 2, perché l’etichetta è vicina alla sezione.
Due punti interrogativi, in tutte le compilazioni.
Un errore, perché l’etichetta deve stare dentro il titolo.
Domanda 8Che cosa cambia in un documento quando si carica il pacchetto hyperref?
I rinvii, le voci dell’indice e i richiami delle note diventano collegamenti del PDF, e il PDF riceve i segnalibri.
I numeri delle sezioni e delle pagine.
I rinvii smettono di richiedere due passaggi.
La lingua delle diciture come «Indice» o «Figura».
Domanda 9Nel documento principale di una tesi, che cosa distingue \include{capitolo1} da \input{capitolo1}?
\include comincia il contenuto in una pagina nuova e permette di compilare solo alcuni capitoli con \includeonly; \input inserisce il file così com’è, nel punto in cui è scritto.
Niente: sono sinonimi.
\input ammette solo file del preambolo.
\include copia il file dentro quello principale al salvataggio.
Domanda 10Il preambolo di una tesi contiene \includeonly{capitolo3}, e il corpo include i cinque capitoli con \include. Che cosa produce la compilazione, se la tesi era già stata compilata per intero?
Un PDF con il solo capitolo 3, che conserva i suoi numeri di pagina, di capitolo e di rinvio, presi dai file ausiliari degli altri.
Un PDF con i cinque capitoli, perché \includeonly riguarda solo l’indice.
Un PDF con il solo capitolo 3, numerato come capitolo 1 e a partire da pagina 1.
Un errore, perché mancano gli altri capitoli.
Domanda 11Un preambolo contiene \newcommand{\emph}[1]{\textbf{#1}}. Che cosa succede?
Il motore produce l’errore «Command \emph already defined»: \newcommand non ridefinisce comandi esistenti, e per questo esiste \renewcommand.
Tutte le enfasi passano in grassetto.
Si crea un secondo comando \emph, che convive con l’originale.
Niente, perché il preambolo non compone testo.
Domanda 12Con \newcommand{\grandezza}[2]{#1~#2} nel preambolo, che cosa stampa \grandezza{5}{km}?
«5 km», con uno spazio in cui la riga non può essere spezzata.
«km 5».
«5~km», con la tilde stampata.
Un errore, perché un comando ammette un solo argomento.