Compilare il sorgente

I programmi TeX sono a riga di comando. Compilare un sorgente significa eseguire il compositore in un terminale passandogli il nome del file.

Il file sorgente non viene mai modificato dal compositore. L’effetto della compilazione è quello di creare il file del documento composto in PDF e altri file secondari o ausiliari.

Il comando di compilazione va dato in un terminale scrivendo di seguito:

1. il nome del compositore, generalmente lualatex
2. uno spazio di separazione
3. il nome del file con o senza estensione
4. il tasto invio per eseguirlo

lualatex primodocumento.tex

Il processo di compilazione è accompagnato dalla stampa in console di numerosi messaggi informativi che si succedono rapidamente a schermo: pacchetti caricati, numero di pagine composte, font utilizzati, avvertimenti o messaggi di errore.

Al primo errore che incontra il compilatore si ferma e attende istruzioni dall’utente dal terminale. Per esempio premendo H e invio verranno stampate informazioni più dettagliate sull’errore. Per interrompere la compilazione e indagare su quanto è successo premere CTRL + Z + Invio.

Estensione e codifica

L’estensione dei file sorgente è .tex e la loro codifica Unicode UTF-8. In questo modo il sorgente viene compilato allo stesso modo su diversi sistemi operativi. Possiamo editare e compilare lo stesso sorgente in ufficio con Windows, a casa con Linux e da un amico con macOS.

Compilare con TeXworks

Gli editor di testo dedicati a LaTeX hanno molte facilitazioni tra cui la compilazione con un click. Di più, spesso il PDF è mostrato a fianco del testo sorgente ed è possibile fare click in un punto per spostarsi nel corrispondente codice.

Uno degli editor più utilizzati è TeXworks. Per impostarlo a compilare con lualatex basta scrivere come prima riga del file sorgente questo commento:

% !TeX program = lualatex

Queste righe di commento vengono chiamate righe magiche e influenzano l’editor su diversi aspetti uno dei quali è appunto stabilire quale deve essere il compilatore al click sul bottone nella barra degli strumenti o alla pressione della combinazione di tasti CTRL + T.

Anche in TeXWorks dal menù Finestra > Mostra il pannello di output possono essere consultati i messaggi di output della compilazione.