Il nuovo sito del GuIT e la pagina sulla documentazione

Ciao a tutti. Visto che sono co-autore di una guida a LaTeX, su questo argomento sono di parte. Vogliate accettare lo stesso le mie riflessioni.

http://www.guitex.org/home/index.php?option=com_content&view=article&id=4&Itemid=23&lang=it

1.

La documentazione è essenziale per i sistemi non visuali. In questa sezione troverete un elenco ragionato del materiale disponibile.

Trovo l’espressione “sistema non visuale ” inutilmente criptica: io direi più semplicemente che “la doc. è essenziale per un software come LaTeX”. Anche “il materiale disponibile” è fuorviante: di materiale disponibile su LaTeX ce n’è molto di più. Ammorbidirei in “alcune guide e manuali su questo programma”. Tommaso farebbe sicuramente meglio.

2.

Guide per iniziare

La Guida del GuIT

Più semplicemente: la Guida GuIT. È il riferimento per l’utente italiano del sistema di composizione LaTeX. La guida, curata dal Prof. Claudio Beccari, viene periodicamente aggiornata e quella che trovate qui è l’ultima versione di luglio 2011.

Qui per me ci sono tre errori.

a) Che la guida sia solo “curata” dal prof. Beccari mi sembra falso, e in ultima analisi ingeneroso nei confronti di Claudio, che ha (io credo) peccato di modestia: Claudio è l’autore di quella guida, altro che il (semplice) curatore! C’è qualcuno del Gruppo che si sente autore o co-autore della guida? Non credo di dire bestemmie affermando che l’ “Introduzione all’arte della composizione tipografica con LaTeX” sia farina (finissima e squisita) del sacco di Claudio. (Gli) va riconosciuto.

b) Che poi la guida sia “il riferimento per l’utente italiano del sistema di composizione LaTeX” mi pare non definisca bene lo status di quel lavoro, che, come dice lo stesso Claudio nella prefazione, presuppone che il lettore abbia già una certa dimestichezza con LaTeX. Io direi che l’Introduzione (di Claudio, non del GuIT) è un manuale su LaTeX in italiano che sviscera LaTeX in profondità, esaminandone (anche) gli aspetti più complessi.

c) Che la guida di Beccari sia “per iniziare” è smentito da quanto scrive l’autore stesso nella prefazione.

3.
Mettere l’Arte sotto “Le guide di Pantieri” è ingeneroso per Tommaso, con cui collaboro da anni; l’Arte è tanto mia quanto sua (ormai, è più sua che mia…) . Anche qui, non si tratta di riconoscere un merito: si tratta di dire la verità. Su questo punto non transigo: va corretto. 😉

Che cosa propongo? Di strutturare la pagina di documentazione come segue.

Guide e manuali in italiano

Guide di base, per iniziare:

• L’arte di scrivere con LaTeX (di Lorenzo Pantieri e Tommaso Gordini)
• LaTeX per l’impaziente (di Lorenzo Pantieri)

Per approfondire:

• Introduzione all’arte della composizione tipografica con LaTeX (di Claudio Beccari)
• Complementi all’Arte di scrivere con LaTeX (di Lorenzo Pantieri)
• LaTeX, breve guida ai pacchetti di uso più comune (di Enrico Gregorio)
• Introduzione a XeLaTeX (di Enrico Gregorio)
• Introduzione a TeXworks (di Enrico Gregorio)

Tutto qui.

Chiedo scusa per l’auto-citazione (che ho sempre considerato una pratica delle più sgradevoli): al di là della proposta, opinabilissima, credo che le inesattezze vadano corrette e i meriti più equamente distribuiti…

A presto,
L.