Guida di base a LaTeX

Questo è il repository dei sorgenti della Guida di base a LaTeX pubblicata dal GuIT. Lo scopo della guida è facilitare gli utenti alle prime armi a prendere confidenza con il sistema nel modo più efficace possibile.

L'associazione GuIT promuove l'uso di LaTeX in qualsiasi contesto: scolastico, accademico, professionale, aziendale e istituzionale. LaTeX è un sofisticato strumento software libero e gratuito per comporre documenti digitali di elevata qualità tipografica.

La guida è consultabile a questo indirizzo.

Contribuire alla guida

La guida è prodotta con mdbook a partire da file testuali in formato Markdown contenuti nella directory src.

Denominato guidalatex questo progetto è libero e Open Source.

Opinioni, suggerimenti, segnalazioni, proposte o contributi sono benvenuti. Per contribuire sono previste queste modalità:

• via email all'indirizzo webteam at GuITeX.

• via Pull Request verso il repository ufficiale della guida che si trova al link repository guidalatex.

Considera che i file nel formato Markdown sono nativi dei sorgenti della guida.

Contributori

Questa è la lista delle persone che hanno contribuito o che contribuiscono a questa guida su LaTeX, con materiale, osservazioni o nuove idee.

Un grande ringraziamento a loro!

• Claudio Beccari
• Giovanni Nuccetelli
• Agostino De Marco
• Grazia Messineo
• Salvatore Vassallo
• Roberto Giacomelli robitex

Note per preparare il rilascio della guida

Il rilascio di una nuova versione della guida segue una sequenza precisa che è descritta di seguito.

build.ps1

Esiste lo script build.ps1 scritto per PowerShell 7 che fa tutto tranne che le operazioni di commit, normalmente svolte internamente all'editor VSC.

Sintassi del comando:

• > .\build.ps1: compila la guida per HTML, PDF, eBook
• > .\build.ps1 -Version 0.1.12: compila la guida con cambio di versione prendendo la data odierna
• > .\build.ps1 -Version 0.1.12 -Date "20 luglio 2026": stessa cosa del precedente ma con la data di rilascio specificata
• opzione --Nocmd o -x esegue solo il cambio dei dati nei file senza compilare la guida

Si può quindi aggiornare solo la data senza compilare nulla con:

build.ps1 -x -Date "20 luglio 2026"

Se invece il numero di versione è già stato incrementato, si può prepareare al rilascio la guida modificando solo la data:

build.ps1 -Date "20 luglio 2026"

Di seguito i passaggi manuali completi (solo in parte coperti dallo script).

Passo 1: i file di rilascio

Sistemare questi file per i dati di rilascio.

• version.info - aggiornare il numero di versione
• date.info - aggiornare la data del rilescio nel formato "1 gennaio 2026"
• biblatex.info - aggiornare con i dati precedenti il record bibliografico

Passo 2: compila la versione a stampa

Per il momento essendo i sorgenti in Markdown si è scelto di usare Typst con il pacchetto cmarker in grado di convertire da quel formato i sorgenti.

Dalla directory printed-version compila la versione a stampa con Typst con il comando:

typst compile guidalatex.typ

controlla il risultato e poi copia il file PDF nella cartella src/91-misc/images/guidalatex.pdf

Passo 3: compila l'eBook

pandoc -d defaults.yaml

Copia poi il file guidalatex.epub nella cartella src/91-misc/images/guidalatex.pdf

Passo 4: compilare la guida in HTML

Dalla directoru home, quella che contiene il file book.toml, lancia il comando:

mdbook build

e controlla che tutto sia a posto leggendo con un browser il file index.html nella cartella guidalatex.

Passo 5: commit

Esegui il commit e il push con la chiave crittografica. La guida sarà automaticamente online dopo uno o due minuti.

Tag

Di seguito i comandi per generare i tag di versione in git

Da completare

Per il link simbolico (Windows PowerShell)

In PowerShell con diritti di amministratore per creare il symlink necessario a Typst per leggere i file Markdown al di fuori della cartella del progetto printed-version:

New-Item -Path
"C:\Users\giaco\Documents\workingfiles\project\guidalatex-home\printed-version\src"
-ItemType SymbolicLink -Target
"C:\Users\giaco\Documents\workingfiles\project\guidalatex-home\src"