Aggiornata la Guida GuIT

una bella guida complimenti e grazie a che l’ha scritta
Solo una curiosità
Leggendo ho trovato questo esempio all’inizio
`
\documentclass[a4paper]{book}
\usepackage[latin1]{inputenc}
\usepackage[T1]{fontenc}
\usepackage[italian]{babel}
\usepackage{guit}
`
mi aspettavo
`
\documentclass[a4paper]{book}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[italian]{babel}
\usepackage{guit}
`
lasciando perdere se fontenc va prima o dopo inputenc
è la codifica data come primo esempio che mi ha colpito, il forum è pieno infatti di problemi di conversione e di come rimediare a ciò
Non è che l’utf8 stia alle altre codifiche come l’inglese alle altre lingue?
Non ho la competenza di esprimere giudizi approfonditi ma leggendo velocemente la guida ho avuto l’impressione che non vi sia una
posizione definita in merito.
Comunque grazie di nuovo a chi a scritto la guida ed ha donato il suo tempo alla comunità
claudio

mi accodo esprimendo la mia. è da un annetto che uso
`
\documentclass[a4paper]{book}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[italian]{babel}
\usepackage{guit
`

sia su windows che su macos (anche su linux, ma lo uso poco). non uso più la codifica latin perchè obsoleta… e uso sempre utf8 per le lettere accentate sui vari os e tastiere…
se non uso utf8 su macos (a volte anche su windows) ci sono problemi di compilazione
credo sia il caso di o scegleire uno dei due codici scritti da claudio, oppure definire l’utilità di latin al giorno d’oggi

@claudio:
fontenc va prima di inputenc, per motivi che tra poco si potranno leggere in una guida, spero in modo chiaro. inputenc lavora meglio sapendo già quale codifica per i font d’uscita si è scelto d’usare. E con questo l’argomento è chiuso 🙂
I problemi di codifica o ricodifica lamentati nel forum non derivano certo dall’usare utf8 o latin1. Nascono perché l’editor è impostato per lavorare con una codifica diversa da quella del file sorgente, e l’utente non lo sa e lo apre e lo compila senza porsi troppe domande, rovinandolo, e a volte rovinando lavori importanti. Nella guida si spiegherà come rimediare.

@Spencer:
latin1 non è certo obsoleta, e per scrivere in italiano e in inglese va benissimo! Ti assicuro che se compili un sorgente nel quale hai assegnato latin1 a inputenc avendolo scritto con un editor impostato per lavorare con latin1 (a meno che tu non usi le righe magiche), non ci sono affatto problemi di compilazione, qualunque sia il sistema operativo installato. Entrambi i codici di Claudio sono perfettamente funzionanti: nel primo basta invertire le posizioni di fontenc e inputenc (ma funziona tutto lo stesso)

Ciao
Tommaso

Aggiungo che caricare inputenc con utf8 dopo gli altri pacchetti che gestiscono font è raccomandabile, ma non è necessario; tutte le impostazioni di inputenc con la codifica utf8 vengono automaticamente differite all’esecuzione di \begin{document} quando tutti i pacchetti che gestiscono sono già stati caricati.

Come apparirà su una guida tematica di prossima pubblicazione.

lancio qui la proposta … eventualmente aprirò un topic o lo aprirà chi di competenza (nel caso fosse competenza di guru o staff del forum): siccome ultimamente ci sono state soluzioni a vari problemi, non sarebbe bello aggiornare l’arte o comunque fare una guida aggiornata con le nuove soluzioni?
da un pò sono sul forum e vedo che tali problematiche sono risolte sul forum ma non su una guida!

inoltre sarebbe bello che i vari utenti pubblicassero cosa vorrebbero vedere sulla guida:
– suggerimenti, migliorie, maggiori spiegazioni e impaginatura per una facile consultazione
– problematiche comuni

Dr Spencer Reid” post=76345lancio qui la proposta … eventualmente aprirò un topic o lo aprirà chi di competenza (nel caso fosse competenza di guru o staff del forum): siccome ultimamente ci sono state soluzioni a vari problemi, non sarebbe bello aggiornare l’arte o comunque fare una guida aggiornata con le nuove soluzioni?
da un pò sono sul forum e vedo che tali problematiche sono risolte sul forum ma non su una guida!

inoltre sarebbe bello che i vari utenti pubblicassero cosa vorrebbero vedere sulla guida:
– suggerimenti, migliorie, maggiori spiegazioni e impaginatura per una facile consultazione
– problematiche comuni

Non credo che funzioni
cose come l’arte sono in continua revisione
ma hanno bisogno di una guida di una filosofia
credo “Troppi galli a cantar non fa mai giorno”
comunque vedo che le modifiche sono accettate un esempio per tutti l’introduzione a TIKZ
che ha comportato un bel lavoro di squadra
di cui la comunità a guadagnato
ciao
claudio

secondo me non si tratta di avere troppi galli, ma di rimboccarsi le maniche e scrivere qualche pagina in più.
mi spiego meglio: ci sono problemi per esempio come lo spazio bianco nella parentesi graffa che scompare con l’ingrandimento… potrebbe non essere un problema rilevante, ma inserirlo in un’appendice “problematiche comuni”; mentre l’aggiunta di pagine bianche oppure evitare la numerazione di pagine prima dell’indice potrebbe essere una richeista anche di altre persone … a prescindere dal buon senso latexiano. non si deve andare contro la filosofia di latex, ma molti utilizzatori vorrebbero fare questi accorgimenti e non lo fanno sia perchè nell’arte (o in altre guide) non è presente, sia perchè il forum non lo considerano un punto di soluzione …
secondo me si sbaglia in entrambi i casi… e, secondo me, questo comporta un utilizzo di latex sempre da parte di meno gente, in quanto poco personalizzabile e molto poco intuitivo a primo impatto…

Dr Spencer Reid” post=76347secondo me non si tratta di avere troppi galli, ma di rimboccarsi le maniche e scrivere qualche pagina in più.
mi spiego meglio: ci sono problemi per esempio come lo spazio bianco nella parentesi graffa che scompare con l’ingrandimento… potrebbe non essere un problema rilevante, ma inserirlo in un’appendice “problematiche comuni”; mentre l’aggiunta di pagine bianche oppure evitare la numerazione di pagine prima dell’indice potrebbe essere una richeista anche di altre persone … a prescindere dal buon senso latexiano. non si deve andare contro la filosofia di latex, ma molti utilizzatori vorrebbero fare questi accorgimenti e non lo fanno sia perchè nell’arte (o in altre guide) non è presente, sia perchè il forum non lo considerano un punto di soluzione …
secondo me si sbaglia in entrambi i casi… e, secondo me, questo comporta un utilizzo di latex sempre da parte di meno gente, in quanto poco personalizzabile e molto poco intuitivo a primo impatto…

Buongiorno, dico quello che penso:
per il discorso legato alla documentazione, nessuno ti vieta di elaborare del materiale che ritieni utile e metterlo a disposizione secondo varie modalità: invio contributo per guide già esistenti scrivendo all’autore, costruzione di una guida per la pubblicazione su sito personale o su quello del guit (per esempio come guida tematica), come articolo per ArsTeXnica, magari in collaborazione con altri autori.
Niente ti vieta di dare un contributo…
In fondo la tua esperienza è unica perché riguarda l’applicazione di TeX in un ambito particolare qualsiasi esso sia, e questo la rende preziosa.

Invece, per il discorso del primo impatto, credo che sia positivo che l’utente debba superarlo: se provengo da anni di utilizzo di word è chiaro che dovrò scontare un po’ di fatica per depurtarmi dalle abitudini sbagliate.
Un saluto.
R.

Per quanto riguarda gli spazietti bianchi nelle graffe, la comprensione del problema ha due facce; da una parte leggere attentamente e non frettolosamente quanto scritto nel capitolo 11, in vicinanza della figura 11.9, dove sono presentati i simboli estensibili. Tra le altre cose c’è scritto

Si notino anche i mezzi delimitatori e i pezzetti che permettono, sovrapponendoli in modo scalato, di disegnare qualunque delimitatore con qualsiasi dimensione sia in altezza per quelli che devono espandersi in verticale, sia in larghezza per quelli che devono espandersi in orizzontale.

Di qui si capisce che quei piccolissimi gap sono le giunzioni dei pezzetti componenti, ma si capisce anche che se ingrandendoli essi non si vedono più, la cosa dipende dalla risoluzione dello schermo (di solito dell’ordine di un punto al pixel, cioè 72 pixel al pollice, o poco più) e da come il visualizzatore del file gestisce la grafica a schermo, in particolare come esegue il filtraggio bidimensionale per rendere meglio l’idea di continuità della rasterizzazione a schermo.

Come vedi alcune cose sono già spiegate nella Guida GuIT, altre dipendono dalla conoscenza che l’utente ha del suo calcolatore personale; questa conoscenza è di solito molto bassa, per cui spiegare come funziona un visualizzatore PDF nella “Introduzione all’arte della composizione tipografica con LaTeX” a me sembra un “fuori tema” assoluto.

Anche gli altri problemini che proponi sono variamente spiegati nell’Arte e nella Guida; basta leggere, capire e agire. Poiché invece molti frequentatori del forum non sanno come accedere alla documentazione (eppure nella Home page del forum c’è chiaramente indicata la sezione di documentazione) e, se vi accedono, restano spaventati dalle 200 e più pagine dell’Arte e dalle 600 e più pagine della Guida, non leggono nemmeno l’indice, dove nove volte su dieci c’è indicato il paragrafo relativo al loro problema, allora capisci che anche una appendice sui problemini più diffusi diventerebbe una appendice inutile, perché non verrebbe letta; o verrebbe letta frettolosamente e superficialmente come nel caso dei gap nei grandi delimitatori.

Il suggerimento di @robitex è un ottimo suggerimento; il tuo contributo, più snello e di poche pagine, potrebbe essere un’ottima risposta ai problemi di intimorimento descritti sopra…

Un paio di considerazioni:

1) a mio modo di vedere:

inoltre sarebbe bello che i vari utenti pubblicassero cosa vorrebbero vedere sulla guida:
– suggerimenti, migliorie, maggiori spiegazioni e impaginatura per una facile consultazione
– problematiche comuni

è già pratica consolidata. Mi riferisco principalmente all’Arte in cui Lorenzo e Tommaso fanno un gran lavoro e prendono sempre in considerazione le idee lanciate dal forum (un filone recente ne è la prova migliore, ma, giusto per fare un secondo esempio, si pensi all’articolo su [tt]pgfplots[/tt]);

2) la proposta di @robitex è interessante: potrebbe venire fuori una guida tematica “Introduzione all problematiche comuni con LaTeX”.

Ciao
Claudio

Vorrei segnalare un piccolo typo. Spero sia la sezione giusta.
Nella presentazione, pagina XIII

si tratta di un meccanismo abbastanza complesso, me la sua comprensione aiuta a capire perché la composizione talvolta sia diversa da come ce la aspetteremmo.

me -> ma

Grazie mille; provvedo a raccogliere queste correzioni, ma non attivo subito il meccanismo di upload. Purtroppo il numero di questi erroretti è ancora grande, ma con l’aiuto di tutti si spera che questa opera collettiva possa non dico esserne esente, ma rimanere praticamente senza refusi.

Grazie ancora.
Claudio

Continuando a leggere la guida, paragrafo 3.1, ultimo capoverso a pagina 22:

L’installazione di TEX Live sulle macchine Windows avviene come per le macchine Linux; l’unica differenza che il file di installazione che bisogna scaricare dalla rete o che si trova nel DVD di installazione, è più grande, perché deve provvedere ad installare alcuni linguaggi, come per esempio Perl, di cui le macchine Windows non sono normalmente dotate; a parte questo dettaglio che è del tutto trasparente per l’utente, il resto procede esattamente come per le macchine Linux, a mano che non venga descritta qualche procedura particolare riferita a questa o a quella realizzazione particolare del sistema operativo Linux.

Credo che “l’unica differenza che” dovrebbe essere “l’unica differenza è che”
“a mano che” -> “a meno che”

Paragrafo 3.2, primo capoverso, pagina 23

; infatti per installare TEX Livesulle macchine Windows si usa lo stesso disco o si accede allo stesso indirizzo internet per scaricare il medesimo file ISO, oppure per scaricare solo il programma di installazione per una installazione interattiva direttamente dalla rete.

Manca uno spazio tra “Live” e “sulle”.

Edit:
Stessa pagina, ultimo capoverso:

Per altro anche la distribuzione “autoctona”, benché generalmente “datata”

“Per altro” -> “Peraltro”.

Paragrafo 3.3, pagina 24, primo capoverso:

Da quando esiste il sistema operativo Mac OS X e la macchina a sua volta usa un processore Intel Dual Core oppure PowerPC, esiste la versione universale di MacTEX, valida per entrambe le macchine dotate di quei processori; per la verià recentemente la distribuzione aggiornate serve per l’installazione solo su macchine dotate di sistema operativo con un numero di versione 10.5 o superiore; per le vecchie macchine con sistemi operativi della serie 15, ma precedenti alla 10.5, si possono scaricare dalla rete le “vecchie” versioni, che però non sono più aggiornate, benché siano ancora disponibili.

“aggiornate” -> “aggiornata”, al singolare
“della serie 15” -> forse doveva essere “della serie 10”?

Il file di installazione è:
http://www.ctan.org/tex-archive/systems/mac/mactex⟨aaaammgg⟩.zip
dove ⟨aaaammgg⟩ indica la data della costruzione del pacchetto; al momento di scrivere queste note essa vale 20100907, cioè 7 settembre 2010. Questo file è compresso secondo il codice ZIP, e contiene un pacchetto di installazione per MAC; estratto questo pacchetto, basta cliccarci sopra e si apre il solito dialogo di installazione; conviene rispondere che si vuole l’installazione completa.

Forse va aggiornata la sezione, ho dato un’occhiata al sito, quel tipo di link credo che non venga più usato.
Io ho scaricato di recente macTeX da questo link: http://mirror.ctan.org/systems/mac/mactex/MacTeX.pkg
Un file di tipo .pkg e non .zip

Paragrafo 3.4, pagina 27:

Ogni programma eseguibile del sistema TEX sa dove cercare i vari tipi di file di cui ha bisogno; per ogni tipo di file può eseguire la ricerca in diversi alberi, ma sempre con una precedenza: gli alberi alberi prioritari sono quelli dell’utente specifico,

C’è una ripetizione della parola “alberi”.

Grazie, grazie, grazie; provvedo.

Claudio

Link a pagine non più esistenti:
Pag 34:
http://www.virgilio.it/blog/2010/05/29/lettere-accentatemaiuscole-con-caps-lock-attivo-su-windows/
http://www.commentamarche.net/download/telecharger-34055570-clavier/

Ultimo punto di pag 34:

In un file di macro personali si inseriscono tutte le definizioni, le più mnemoniche possibile, per inserire i segni mancanti dalla tastiera; la definizione di nuovi comandi verrà visto molto più avanti, ma qui si indicano alcune definizioni il cui elenco può essere completato secondo le proprie necessità:

“visto” dovrebbe essere al femminile, “vista”

Paragrafo 3.6.4, penultimo capoverso di pag. 37:

Non è così. Anche se chi scrive non è la corrente di programmi di visualizza- zione di una tastiera virtuale interattiva sulle macchine Windows o Linux

“la corrente” dovrebbe essere “al corrente”.

Poco prima dell’inizio del paragrafo 3.7.1, pagina 40

Chi scrive consiglia di non prendere quelle informazioni per oro colato: si tratta di informazioni utilissime, ma talvolta incomplete. quindi il lettore si serva pura di quella tabella, ma con giudizio.

“pura” dovrebbe essere “pure”.

A pagina 41:

emacs consente di usare tutti le possibili codifiche dei font in entrata, anche se con le macchine Windows meno recenti converrebbe impostare l’encoding ansinew.

“tutti” dovrebbe essere “tutte”.

A pagina 44:

Per altro le funzionalità di LED sono simili a quelle degli altri programmi già descritti; purtroppo non dispone di un visore diretto di file in formato PDF, per cui bisogna ricorrere ad un programma esterno, per esempio Adobe Reader, che però non si integra perfettamente con il programma LED altrettanto bene del visore interno per i file in formato DVI

Andrebbe riformulata, forse sostituendo “del” con “come il”.

All’inizio di pagina 46:

grafiche che permettono di controllare gli ambienti testuali o matematici, in modo che si può essere sicuri che ogni apertura di ambiente abbia la corrispondente chiusura

al posto di “può” meglio “possa”.

Quasi alla fine di pagina 46, dove si parla di gedit-LaTeX-plugin gedit

permette di avere come Kile, Texmaker e TeXmakerX una finestra laterale con la struttura dei un documento complesso

“dei” da sostituire con “di”

A pagina 47 il link
http://www.michaels-website.de/gedit-latex-plugin/
non è più esistente. Può essere sostituito con questo:
http://michaels-website.de/?page_id=6

Poco più avanti, dopo il secondo link c’è un typo in questo testo:

Ovviamente questo plug-in dipende da altri pacchetti e altre li- brerie generalmente presenti su ogni macchina Linux; all’occorrenza on è difficile installare le librerie mancanti.

manca una “n”, “on” dovrebbe essere “non”.

A pagina 49:

TextWrangler e diversi altri editor testuali specifici per il sistema Mac OS X possono essere utili, ma non sono shell editor; quindi non sono così comodi per la lavorazione di un documento. TeXwrangler, per altro, può essere molto utile per aprire e leggere i file .log

“per altro” -> “peraltro”.

All’inizio di pagina 50:

È comodo che il pulsante per eseguire la composizione si presente sia nella finestra del file sorgente sia nella finestra del file composto.

“si presente” da sostituire co “sia presente” o forse con “si presenti“.

Poco dopo:

Texmaker presenta le stesse funzionalità descritte per i sistemi Windows, e le stesse limitazioni.Per altro è un ottimo shell-editor; esso è adatto anche alle macchine Mac, perché è contiene un suo visualizzatore interno predisposto per la sincronizzazione.

“Per altro” -> “Peraltro”.
c’è una “è” di troppo in “perché è contiene”.

Poi appena più sotto:

TeXmakerX ha gli stessi pregi già descritti come shell editor multipiattaforma; chi scrive non è riuscito a verificare se sia sincronizzabile con il visualizzatore di file in formato PDF Skim sulla macchine Mac

“sulla” -> “sulle”.

________________________________________
“per altro” vs. “peraltro”
Ho notato che “per altro” con lo spazio, utilizzato come congiunzione, viene incontrato ancora diverse volte nel testo. E’ inutile continuare a segnalarlo: basterà fare una ricerca se si vogliono modificare gli altri “per altro” nel resto del testo e tutto sommato, da una veloce ricerca su google, par che venga comunemente accettata e non considerata un grosso errore anche la forma con lo spazio anche nel caso in cui si utilizzi “per altro” come congiunzione.

Simone,
sono molto contento della tua revisione, ma scrivendola qui sul forum si riempiono le pagine di cose che sicuramente interessano me, ma poi gli altri frequentatori, che non possono autocorreggersi la Guida, forse non gradiscono o forse non sanno cosa farsene.

Per le prossime segnalazioni, ti pregherei di scrivermi direttamente per posta elettronica; il mio indirizzo lo trovi facilmente in quasi tutti i pacchetti che ho scritto e sono sia su CTAN sia nella distribuzione TeX Live. 🙂

Ciao e grazie
Claudio

Ciao a tutti,
ho aggiornato il sito con la nuova guida GuIT in formato B5. Ho ricevuto il materiale questa mattina da Claudio Beccari.
Inoltre, la guida è disponibile suddivisa in tre tomi per ulteriore comodità di stampa e rilegatura.

Con l’occasione ho aggiornato la pagina principale della documentazione:
http://www.guitex.org/home/it/doc

quella specifica della Guida GuIT
http://www.guitex.org/home/it/guide-per-iniziare/la-guida-guit

ed anche la pagina “filosofica” sulle guide tematiche, dove ho aggiunto un breve riferimento al repository su github.
http://www.guitex.org/home/it/guide-tematiche/la-filosofia-delle-guide-a-tema

Suggerimenti o segnalazioni di refusi sono ben accetti!
(se riguardano il sito è meglio che mandiate un messaggio e-mail all’indirizzo della redazione, cercatelo sul sito stesso…)
Buona lettura!
R.

Sul vecchio sito guit.sssup.it veniva caricato il sorgente della guida. Da quando il sito si è spostato in questa nuova posizione, non sono più disponibili i sorgenti delle nuove versioni. Si potrebbe creare un apposito repo su Github (magari ripulito da tutti i file binari/ausiliari generati durante la compilazione)? 🙂 Se il problema è solo lo spazio occupato su questo sito il problema sarebbe in questo modo velocemente risolto, però mi rendo conto che si aggiunge il problema che ci vuole qualcuno che si occupi di gestire il repo

Elrond” post=81945Sul vecchio sito guit.sssup.it veniva caricato il sorgente della guida. Da quando il sito si è spostato in questa nuova posizione, non sono più disponibili i sorgenti delle nuove versioni. Si potrebbe creare un apposito repo su Github (magari ripulito da tutti i file binari/ausiliari generati durante la compilazione)? 🙂 Se il problema è solo lo spazio occupato su questo sito il problema sarebbe in questo modo velocemente risolto, però mi rendo conto che si aggiunge il problema che ci vuole qualcuno che si occupi di gestire il repo

Ciao Elrond.
Sul vecchio sito esistevano i sorgenti ma erano accessibili solo dai soci che dovevano loggarsi nell’area riservata.
Sul nuovo sito non abbiamo avuto modo di replicare l’area privata.
Forse quando passeremo al nuovo motore aggiornato faremo di nuovo questo ed altro.
A meno che il gruppo non decida di rendere pubblici i sorgenti.
R.

robitex” post=81946Sul vecchio sito esistevano i sorgenti ma erano accessibili solo dai soci che dovevano loggarsi nell’area riservata.

Non doveva funzionare tanto bene questa area riservata visto che i sorgenti erano accessibili a tutti 😀
In questo messaggio OldClaudio aveva detto di essere disponibile a pubblicare i sorgenti, adesso credo di aver capito perché non è stato fatto

robitex” post=81946Sul vecchio sito esistevano i sorgenti ma erano accessibili solo dai soci che dovevano loggarsi nell’area riservata.

😮 alla pagina http://www.guit.sssup.it/download/#manual l’archivio zip è ben in vista, e qualche volta che ho parlato via mail con Claudio non ha mai fatto nessun problema/mistero dei suoi codici (come sta scritto nel messaggio citato). Adesso non capisco più nulla.

Comunque, meglio aspettare Claudio 🙂 .

Grazie per il lavoro del sito, Roberto. Appena ho tempo ti invio qualche commento e un suggerimento per le guide tematiche…

Ciao,
Orlando

Elrond” post=81949

Sul vecchio sito esistevano i sorgenti ma erano accessibili solo dai soci che dovevano loggarsi nell’area riservata.

Non doveva funzionare tanto bene questa area riservata visto che i sorgenti erano accessibili a tutti 😀
In questo messaggio OldClaudio aveva detto di essere disponibile a pubblicare i sorgenti, adesso credo di aver capito perché non è stato fatto

Vorresti spiegarti meglio?
Non ho capito quel che intendi.
R.

robitex” post=81952

[quote=”robitex” post=81946]Sul vecchio sito esistevano i sorgenti ma erano accessibili solo dai soci che dovevano loggarsi nell’area riservata.

Non doveva funzionare tanto bene questa area riservata visto che i sorgenti erano accessibili a tutti 😀
In questo messaggio OldClaudio aveva detto di essere disponibile a pubblicare i sorgenti, adesso credo di aver capito perché non è stato fatto

Vorresti spiegarti meglio?
Non ho capito quel che intendi.
R.[/quote]
http://www.guit.sssup.it/download/ Nella sezione “I manuali e le traduzioni di GuIT” c’è ill ink http://www.guit.sssup.it/downloads/GuidaGuIT-A4-0.97.zip ma non c’è alcuna richiesta di accesso all’area riservata. La frase «adesso credo di aver capito perché non è stato fatto» si riferisce al fatto che, come hai spiegato prima, su questo nuovo sito non è presente un’area riservata, avevo dedotto che i sorgenti non sono stati caricati per questo motivo