LaTeX e Vim: differenze tra le versioni

Da Guide@Debianizzati.Org.
Vai alla navigazione Vai alla ricerca
Nessun oggetto della modifica
Nessun oggetto della modifica
Riga 18: Riga 18:
== Installazione ==
== Installazione ==


Per installare latex, basta installare il pacchetto: <tt>tetex-extra</tt>.
Per installare latex, basta installare il pacchetto: <code>tetex-extra</code>.


Per installare vim con il supporto avanzato per latex bastano invece <tt>vim-gtk</tt> e <tt>vim-latexsuite</tt>.
Per installare vim con il supporto avanzato per latex bastano invece <code>vim-gtk</code> e <code>vim-latexsuite</code>.


Nell'eventualità non compaiano i menù aggiuntivi per LateX dare
Nell'eventualità non compaiano i menù aggiuntivi per LateX dare


  $ vim-addons install latex-suite
<pre>$ vim-addons install latex-suite</pre>


== Template ==  
== Template ==  
Riga 32: Riga 32:


== Elenchi ==
== Elenchi ==
'''Elenco numerato''': scrivere in una nuova linea <tt>enumerate</tt> e premere ESC seguito da F5. Gli strani simboli <tt><++></tt> sono dei segnaposto (''placeholder''). Si può saltare al successivo placeholder con <tt>CTRL + j</tt>.
'''Elenco numerato''': scrivere in una nuova linea <code>enumerate</code> e premere ESC seguito da F5. Gli strani simboli <code><++></code> sono dei segnaposto (''placeholder''). Si può saltare al successivo placeholder con <code>CTRL + j</code>.


'''Elenco puntato''': idem come prima basta scrivere <tt>itemize</tt> uscire con ESC dalla modalità inserimento e richiamare la macro con F9. Con <tt>CTRL + j</tt> si esce subito dall'elenco.
'''Elenco puntato''': idem come prima, basta scrivere <code>itemize</code> uscire con ESC dalla modalità inserimento e richiamare la macro con F9. Con <code>CTRL + j</code> si esce subito dall'elenco.


'''Elenco descrizioni''': <tt>description</tt> e premere ESC e F5.
'''Elenco descrizioni''': <code>description</code> e premere ESC e F5.


== Equazioni ==
== Equazioni ==
Per inserire una equazione: scrivere <tt>eqnarray</tt> premere ESC e F5.
Per inserire una equazione: scrivere <code>eqnarray</code> premere ESC e F5.


'''Esponente''': al posto di scrivere manualmente <tt>^{}</tt> possiamo premere <tt>^^</tt>
'''Esponente''': al posto di scrivere manualmente <code>^{}</code> possiamo premere <code>^^</code>
che inserirà automaticamente le parentesi ed in placeholder per uscire dall'esponente.
che inserirà automaticamente le parentesi ed in placeholder per uscire dall'esponente.


'''Segno uguale''': al posto di <tt>&=&</tt> è possibile scrivere solo <tt>==</tt>.
'''Segno uguale''': al posto di <code>&=&</code> è possibile scrivere solo <code>==</code>.


* [http://vim-latex.sourceforge.net/documentation/latex-suite/auc-tex-mappings.html Altri utili shortcuts]
* [http://vim-latex.sourceforge.net/documentation/latex-suite/auc-tex-mappings.html Altri utili shortcuts]
Riga 51: Riga 51:
Il folding è la capacità di vim di fare delle "ripiegature" nel file, ovvero nascondere certe parti del documento per rendere la navigazione più agevole. Questa funzionalità è fondamentale per navigare velocemente in documenti con vari capitoli, paragrafi e sotto-paragrafi.
Il folding è la capacità di vim di fare delle "ripiegature" nel file, ovvero nascondere certe parti del documento per rendere la navigazione più agevole. Questa funzionalità è fondamentale per navigare velocemente in documenti con vari capitoli, paragrafi e sotto-paragrafi.


Per attivare il folding con la LaTeX-Suite basta premere <tt>\rf</tt> (''Refresh Folding'') in ''normal mode''. Per aprire e chiudere un folding basta andarci sopra col cursore e premere <tt>'''za'''</tt> sempre in ''normal mode''.  
Per attivare il folding con la LaTeX-Suite basta premere <code>\rf</code> (''Refresh Folding'') in ''normal mode''. Per aprire e chiudere un folding basta andarci sopra col cursore e premere <code>'''za'''</code> sempre in ''normal mode''.  


Altri comandi li trovate nel menu ''Strumenti -> Piegature''.
Altri comandi li trovate nel menu ''Strumenti -> Piegature''.


== Produrre PDF ==
== Produrre PDF ==
Con la <tt>latexsuite</tt> di vim è possibile compilare un documento latex semplicemente premendo <tt>'''\ll'''</tt> in ''normal mode''. Per la visualizzazione basta invece premere <tt>'''\lv'''</tt>. Di default viene prodotto e visualizzato un file in formato '''dvi''', ma  
Con la <code>latexsuite</code> di vim è possibile compilare un documento latex semplicemente premendo <code>'''\ll'''</code> in ''normal mode''. Per la visualizzazione basta invece premere <code>'''\lv'''</code>. Di default viene prodotto e visualizzato un file in formato '''dvi''', ma  
in molti casi si vuole produrre '''pdf''' sia per la maggiore diffusione del formato che per le caratteristiche più avanzate (come la selezione del testo, l'indice, i link sia interni al documento che a pagine internet).
in molti casi si vuole produrre '''pdf''' sia per la maggiore diffusione del formato che per le caratteristiche più avanzate (come la selezione del testo, l'indice, i link sia interni al documento che a pagine internet).


Per impostare '''pdf''' come formato di output di default in gvim basta impostarlo tramite il menù ''TeX-Suite'' i valori di ''Target format'', oppure usando il comando:
Per impostare '''pdf''' come formato di output di default in gvim basta impostarlo tramite il menù ''TeX-Suite'' i valori di ''Target format'', oppure usando il comando:


:TTarget pdf
<pre>:TTarget pdf</pre>


Adesso con <tt>'''\ll'''</tt> si produrrà il pdf e con <tt>'''\lv'''</tt> si visualizzerà. Il pdf viene creato di default usando il comando <code>pdflatex</code>.
Adesso con <code>'''\ll'''</code> si produrrà il pdf e con <code>'''\lv'''</code> si visualizzerà. Il pdf viene creato di default usando il comando <code>pdflatex</code>.


Se la visualizzazione con <tt>'''\lv'''</tt> non funziona possiamo visualizzare il documento usando un normale comando di shell:
Se la visualizzazione con <code>'''\lv'''</code> non funziona possiamo visualizzare il documento usando un normale comando di shell:


:!evince nome_file.pdf
<pre>:!evince nome_file.pdf</pre>


Per impostare un visualizzatore di pdf diverso da quello di default basta usare il seguente comando:
Per impostare un visualizzatore di pdf diverso da quello di default basta usare il seguente comando:


:let g:Tex_ViewRule_pdf = 'evince'
<pre>:let g:Tex_ViewRule_pdf = 'evince'</pre>


Se il documento contiene delle etichette, riferimenti ecc., bisogna eseguire la compilazione più volte per avere tutti i numeri dei riferimenti corretti. La latexsuite esegue più volte la compilazione solo se si producono '''dvi'''. Per eseguire la compilazione più volte automaticamente quando si preme <tt>'''\ll'''</tt> anche se si compila un pdf basta eseguire questo comando:
Se il documento contiene delle etichette, riferimenti ecc., bisogna eseguire la compilazione più volte per avere tutti i numeri dei riferimenti corretti. La latexsuite esegue più volte la compilazione solo se si producono '''dvi'''. Per eseguire la compilazione più volte automaticamente quando si preme <code>'''\ll'''</code> anche se si compila un pdf basta eseguire questo comando:
   
   
:let g:Tex_MultipleCompileFormats = 'pdf,dvi'
<pre>:let g:Tex_MultipleCompileFormats = 'pdf,dvi'</pre>


Per evitare di eseguire ogni volta questi comandi, potete editare il file <tt>'''texrc'''</tt>, di solito contenuto in <code>/usr/share/vim/addons/ftplugin/latex-suite/texrc</code>, modificando le seguenti stringhe
Per evitare di eseguire ogni volta questi comandi, potete editare il file <code>'''texrc'''</code>, di solito contenuto in <code>/usr/share/vim/addons/ftplugin/latex-suite/texrc</code>, modificando le seguenti stringhe


Tex_DefaultTargetFormat
<pre>Tex_DefaultTargetFormat
  Tex_MultipleCompileFormats
  Tex_MultipleCompileFormats
  Tex_ViewRule_pdf
  Tex_ViewRule_pdf</pre>


== Link ==
== Link ==

Versione delle 20:33, 2 feb 2010

Debian-swirl.png Versioni Compatibili

ERRORE: valore non valido ( Debian Etch 4.0
Debian Lenny 5.0
Debian Squeeze
Debian Sid )! Vedi qui.

Introduzione a LaTeX

Se non conoscete LaTeX e ne avete solo sentito parlare di sfuggita, e ne siete in qualche modo incuriositi potreste trovarvi spaesati nella mastodontica quantità di informazioni presenti in internet. Di seguito elencherò le principali risorse.

Una (mica tanto) breve introduzione aLTE X2 ε
Questo è senza dubbio il primo documento da leggere. In italiano, tratta dalla presentazione di LaTeX fino al suo uso mediamente avanzato.
Getting to grips with Latex
Questa risorsa, in inglese, con una serie di tutorial ed esempi molto ben fatti affronta in maniera pragmatica e diretta tutti i principali problemi della scrittura di documenti LaTeX. Parte anch'esso da zero ma si trovano certi dettagli più avanzati non presenti nel precedente link.
I manuali e le traduzioni di GuIT
Questo è un elenco di documenti in italiano tradotti dal Gruppo Utenti Tex Italiani (ma non solo). Si va dalle introduzioni ad argomenti molto specifici e avanzati.
LaTeX: introduzione
Come non segnalare inoltre il capitolo dedicato a LaTeX della monumentale opera Appunti di Informatica Libera di Daniele Giacomini. Vi si trovano informazioni utili, tra le altre cose, sulle spaziature, le lunghezze, le scatole (box), i contatori.

Ed infine, mi fermo qui altrimenti degeneriamo, non mi resta che segnalare la risorsa più completa nella quale troverete informazioni dettagliate su ogni singolo comando LaTeX:

Installazione

Per installare latex, basta installare il pacchetto: tetex-extra.

Per installare vim con il supporto avanzato per latex bastano invece vim-gtk e vim-latexsuite.

Nell'eventualità non compaiano i menù aggiuntivi per LateX dare

$ vim-addons install latex-suite

Template

Per iniziare un articolo basta usare un template:

Menu TeX_Suite -> Templates -> article

Elenchi

Elenco numerato: scrivere in una nuova linea enumerate e premere ESC seguito da F5. Gli strani simboli <++> sono dei segnaposto (placeholder). Si può saltare al successivo placeholder con CTRL + j.

Elenco puntato: idem come prima, basta scrivere itemize uscire con ESC dalla modalità inserimento e richiamare la macro con F9. Con CTRL + j si esce subito dall'elenco.

Elenco descrizioni: description e premere ESC e F5.

Equazioni

Per inserire una equazione: scrivere eqnarray premere ESC e F5.

Esponente: al posto di scrivere manualmente ^{} possiamo premere ^^ che inserirà automaticamente le parentesi ed in placeholder per uscire dall'esponente.

Segno uguale: al posto di &=& è possibile scrivere solo ==.

Folding

Il folding è la capacità di vim di fare delle "ripiegature" nel file, ovvero nascondere certe parti del documento per rendere la navigazione più agevole. Questa funzionalità è fondamentale per navigare velocemente in documenti con vari capitoli, paragrafi e sotto-paragrafi.

Per attivare il folding con la LaTeX-Suite basta premere \rf (Refresh Folding) in normal mode. Per aprire e chiudere un folding basta andarci sopra col cursore e premere za sempre in normal mode.

Altri comandi li trovate nel menu Strumenti -> Piegature.

Produrre PDF

Con la latexsuite di vim è possibile compilare un documento latex semplicemente premendo \ll in normal mode. Per la visualizzazione basta invece premere \lv. Di default viene prodotto e visualizzato un file in formato dvi, ma in molti casi si vuole produrre pdf sia per la maggiore diffusione del formato che per le caratteristiche più avanzate (come la selezione del testo, l'indice, i link sia interni al documento che a pagine internet).

Per impostare pdf come formato di output di default in gvim basta impostarlo tramite il menù TeX-Suite i valori di Target format, oppure usando il comando:

:TTarget pdf

Adesso con \ll si produrrà il pdf e con \lv si visualizzerà. Il pdf viene creato di default usando il comando pdflatex.

Se la visualizzazione con \lv non funziona possiamo visualizzare il documento usando un normale comando di shell:

:!evince nome_file.pdf

Per impostare un visualizzatore di pdf diverso da quello di default basta usare il seguente comando:

:let g:Tex_ViewRule_pdf = 'evince'

Se il documento contiene delle etichette, riferimenti ecc., bisogna eseguire la compilazione più volte per avere tutti i numeri dei riferimenti corretti. La latexsuite esegue più volte la compilazione solo se si producono dvi. Per eseguire la compilazione più volte automaticamente quando si preme \ll anche se si compila un pdf basta eseguire questo comando:

:let g:Tex_MultipleCompileFormats = 'pdf,dvi'

Per evitare di eseguire ogni volta questi comandi, potete editare il file texrc, di solito contenuto in /usr/share/vim/addons/ftplugin/latex-suite/texrc, modificando le seguenti stringhe

Tex_DefaultTargetFormat
 Tex_MultipleCompileFormats
 Tex_ViewRule_pdf

Link