LaTeX e Vim: differenze tra le versioni

Da Guide@Debianizzati.Org.
Vai alla navigazione Vai alla ricerca
m (rimosse versioni obsolete dal template Versioni compatibili)
 
(14 versioni intermedie di 7 utenti non mostrate)
Riga 1: Riga 1:
{{Versioni compatibili|Jessie|Stretch}}
== Introduzione a LaTeX ==
== 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.
Se non conoscete LaTeX o ne avete solo sentito parlare, e ne siete in qualche modo incuriositi, potreste trovarvi spaesati di fronte alla mastodontica quantità di informazioni presenti in internet. Di seguito si elencano le principali risorse.


; [http://profs.sci.univr.it/~gregorio/itlshort.pdf 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.
; [http://profs.sci.univr.it/~gregorio/itlshort.pdf Una (mica tanto) breve introduzione a LaTeX2e]:Questo è senza dubbio il primo documento da leggere. In italiano, tratta dalla presentazione di LaTeX fino al suo uso mediamente avanzato.


; [http://www.andy-roberts.net/misc/latex/index.html 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.
; [http://www.andy-roberts.net/misc/latex/index.html 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.


; [http://www.guit.sssup.it/download/#manual 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.
; [http://guitex.org/home/it/doc I manuali e le traduzioni di GuIT]: Questo è un elenco di documenti in italiano tradotti dal Gruppo Utilizzatori Italiani di Tex (ma non solo). Si va dalle introduzioni ad argomenti molto specifici e avanzati. Tra di essi si segnala in particolare [http://www.lorenzopantieri.net/LaTeX_files/ArteLaTeX.pdf L'Arte di scrivere con LaTeX], una guida molto ben scritta che parte da zero per arrivare ad un uso mediamente avanzato di LaTeX.


; [http://a2.pluto.it/latex_introduzione.htm 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.
; [http://a2.pluto.it/a2/a273.htm#almltitle2976 Capitolo 50: LaTeX]: 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 ==
LaTeX è un linguaggio di markup, non un programma o un pacchetto, dunque non è possibile "installarlo". Come per i linguaggi di programmazione, si installa in realtà un compilatore che sia in grado di convertire il codice sorgente in un opportuno output. A corredo di esso saranno poi presenti altri pacchetti con il compito di fornire ulteriori funzionalità (font, documentazione, estensioni, eccetera).
 
La distribuzione consigliata di tutti questi applicativi è quella conosciuta come ''texlive''. Per installarne una versione completa, si installi il metapacchetto <code>texlive-full</code>:
<pre>
# apt-get install texlive-full
</pre>
Il metapacchetto <code>texlive</code> fornisce invece una versione della distribuzione funzionante e comprensiva dei pacchetti più usati, ma non completa.
È fortemente consigliato installare versioni complete della distribuzione, soprattutto per i non esperti.
 
Per installare Vim con il supporto avanzato per LaTeX bastano invece i pacchetti <code>vim-gtk</code>, <code>vim-latexsuite</code> e <code>vim-addon-manager</code>.
<pre>
# apt-get install vim-gtk vim-latexsuite vim-addon-manager
</pre>
Per utilizzare effettivamente il plugin è necessario dare il comando
<pre>$ vim-addons install latex-suite</pre>


* '''[http://www.eng.cam.ac.uk/help/tpl/textprocessing/teTeX/latex/latex2e-html/ltx-2.html Help On LaTeX Commands]'''
==Scorciatoie==
Il plugin <code>latexsuite</code> fornisce utili scorciatoie per svolgere velocemente alcuni compiti.
; Placeholder : Si noterà che vari comandi propri della <code>latexsuite</code> inseriscono nel file sorgente anche uno o più simboli <code><++></code>. Essi si chiamano ''placeholder'' e non sono altro che dei segnaposto. È possibile saltare al successivo placeholder con <code>CTRL + j</code>.


== Installazione ==
Di seguito si elencano le principali scorciatoie.
====Ambienti====
Dopo aver scritto una parola si prema <code>F5</code> indifferentemente in ''insert mode'' o in ''normal mode''. Si aprirà un environment con la parola appena scritta come nome e con gli opportuni placeholder. Ciò è particolarmente utile per ambienti usati frequentemente, come <code>equation</code>, <code>gather</code>, <code>align</code>, <code>enumerate</code>, <code>itemize</code>, <code>description</code>, eccetera; in alcuni casi il plugin inserisce anche altro codice, per esempio nel caso dell'ambiente <code>equation</code> sarà inserita anche la riga <code>\label{<++>}</code>.
 
;Esempio
<pre>
foo
</pre>
Premendo <code>F5</code>
<pre>
\begin{foo}
   
\end{foo}<++>
</pre>
 
Se invece si preme <code>F5</code> senza aver precedentemente scritto una parola, si aprirà un wizard in cui sono elencati i nomi di alcuni ambienti. Scegliendone uno, si aprirà l'ambiente corrispondente nel sorgente.
 
[http://vim-latex.sourceforge.net/documentation/latex-suite/environment-mappings.html Scorciatoie per gli ambienti]
 
====Comandi====
Dopo aver scritto una parola si prema <code>F7</code> indifferentemente in ''insert mode'' o in ''normal mode''. La parola appena scritta sarà trasformata in un comando con un argomento obbligatorio. Ciò è particolarmente utile per comandi quali <code>\text</code>, <code>\intertext</code>, <code>\label</code>, <code>\cite</code>, <code>\ref</code>, <code>\eqref</code>, eccetera. Anche in questo caso il plugin inserisce codice extra per alcuni comandi (per esempio, nel caso del comando <code>\frac</code> vengono inseriti due argomenti obbligatori anzichè uno solo).
 
;Esempio
<pre>
foo
</pre>
Premendo <code>F7</code>
<pre>
\foo{}<++>
</pre>


Per installare latex, basta installare il pacchetto: <tt>tetex-extra</tt>.
Se invece si preme <code>F7</code> senza aver precedentemente scritto una parola, si aprirà un wizard in cui sono elencati i nomi di alcuni comandi. Scegliendone uno, il comando corrispondente sarà inserito nel sorgente.


Per installare vim con il supporto avanzato per latex bastano invece <tt>vim-gtk</tt> e <tt>vim-latexsuite</tt>.
[http://vim-latex.sourceforge.net/documentation/latex-suite/latex-command-maps.html Scorciatorie per i comandi]


Nell'eventualità non compaiano i menù aggiuntivi per LateX dare
====Bibliografia e riferimenti====
Il plugin <code>latexsuite</code> è in grado di memorizzare tutti i label presenti nel documento, nonchè le opere in bibliografia. Per richiamarle nel momento del bisogno la scorciatoia da usare è <code>F9</code>.


  $ vim-addons install latex-suite
Dopo aver scritto <code>\ref{</code> (o gli analoghi <code>\vref{</code>, <code>\eqref{</code>, eccetera), premendo <code>F9</code> si aprirà una finestra con i riferimenti disponibili per il completamento, da cui è possibile scegliere <code>Invio</code>.


== Template ==
Dopo aver scritto <code>\cite{</code> (o comandi analoghi), premendo <code>F9</code> si aprirà una finestra con le citazioni bibliografiche disponibili per il completamento, da cui è possibile scegliere con <code>Invio</code>. Nota: questo comportamento funziona solo se si gestisce la bibliografia con <code>\thebibliography</code>.
Per iniziare un articolo basta usare un template:


: ''Menu TeX_Suite -> Templates -> article''
[http://vim-latex.sourceforge.net/documentation/latex-suite/bibtex-bindings.html Scorciatoie per la bibliografia]


== Elenchi ==
====Altro====
'''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 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.
'''''Sezionamento''''': esistono scorciatoie specifiche per inserire i comandi di sezionamento quali <code>\section</code>, <code>\chapter</code>, eccetera. Sono tutte composte di tre lettere maiuscole consecutive (per esempio <code>SSE</code>, <code>SCH</code> e <code>SSS</code> producono <code>\section</code>, <code>\chapter</code> e <code>\subsection</code> rispettivamente).


'''Elenco descrizioni''': <tt>description</tt> e premere ESC e F5.
'''''Esponenti''''': al posto di scrivere manualmente <code>^{}</code> possiamo premere <code>^^</code> che inserirà automaticamente le parentesi ed il placeholder per uscire dall'esponente.


== Equazioni ==
'''''Pedici''''': al posto di scrivere manualmente <code>_{}</code> possiamo premere <code>__</code> che inserirà automaticamente le parentesi graffe ed il placeholder per uscire dal pedice.
Per inserire una equazione: scrivere <tt>eqnarray</tt> premere ESC e F5.


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


'''Segno uguale''': al posto di <tt>&=&</tt> è possibile scrivere solo <tt>==</tt>.
'''''Lettere greche''''': per inserire svariate lettere greche è possibile digitare il carattere <code>`</code> seguito dall'iniziale della lettera voluta. Per esempio, <code>`a</code> produce <code>\alpha</code>. Data la non coincidenza dei due alfabeti, non tutte le lettere greche si possono ottenere in questo modo, inoltre non sempre la lettera da usare corrisponde all'iniziale.


* [http://vim-latex.sourceforge.net/documentation/latex-suite/auc-tex-mappings.html Altri utili shortcuts]
*[http://vim-latex.sourceforge.net/documentation/latex-suite/section-mappings.html Scorciatoie per il sezionamento]
*[http://vim-latex.sourceforge.net/documentation/latex-suite/greek-letter-mappings.html Scorciatoie per le lettere greche]
*[http://vim-latex.sourceforge.net/documentation/latex-suite/latex-macros.html Altre scorciatoie e macro]


== Folding ==
==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.
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 <code>latexsuite</code> basta premere <code>\rf</code> (''Refresh folds'') in ''normal mode''. Per aprire o 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 ==
==Template==  
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
Per iniziare un articolo è possibile usare un template:
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).
 
: ''Menu TeX_Suite -> Templates''
o il comando
<pre>:TTemplate</pre>
 
I template sono conservati nella cartella <code>~/.vim/ftplugin/latex-suite/templates/</code>. Qui è anche possibile copiare i propri template.


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:
==Compilazione (Produrre DVI/PDF)==
Con il plugin <code>latexsuite</code> è 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).


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


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>.
<pre>:TTarget pdf</pre>


Se la visualizzazione con <tt>'''\lv'''</tt> non funziona possiamo visualizzare il documento usando un normale comando di shell:
Fatto questo, con <code>\ll</code> si produrrà il pdf e con <code>\lv</code> lo si visualizzerà. Di default il pdf è creato mediante il comando <code>pdflatex</code>.<br/>Se la visualizzazione con <code>\lv</code> non dovesse funzionare è possibile 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 etichette, riferimenti, eccetera, bisogna eseguire la compilazione più volte perchè i riferimenti siano corretti. Di default la <code>latexsuite</code> esegue più volte la compilazione solo se si producono '''dvi'''. Perchè questo avvenga anche quando si compila per produrre '''pdf''' è sufficiente eseguire il comando:
   
   
:let g:Tex_MultipleCompileFormats = 'pdf,dvi'
<pre>:let g:Tex_MultipleCompileFormats = 'pdf,dvi'</pre>
 
Per evitare di fare ciò ogni volta, è possibile editare il file <code>'''texrc'''</code>, di solito contenuto in <code>~.vim/ftplugin/latex-suite/texrc</code>, modificando le seguenti stringhe
 
<pre>
g:Tex_DefaultTargetFormat
g:Tex_MultipleCompileFormats
g:Tex_ViewRule_pdf</pre>


Per evitare di eseguire ogni volta questi comandi, potete editare il file <tt>'''textrc'''</tt>, di solito contenuto in ''/usr/share/vim/addons/ftplugin/latex-suite/texrc'', modificando le seguenti stringhe
; Compilare grandi documenti : Nel caso sia necessario compilare un documento complesso (per esempio con al suo interno per esempio dei comandi <code>\include</code> o <code>\input</code>) esistono altri strumenti che ci vengono in aiuto. Uno di essi è <code>latexmk</code>: il pacchetto fornisce l'omonimo comando di shell che provvede autonomamente a compilare il numero di volte necessari i vari documenti (e solo quando necessario). Infine, è sempre possibile avvalersi dell'utility <code>make</code>, istruendola con un opportuno '''makefile'''.


Tex_DefaultTargetFormat
== Configurazione avanzata ==
Tex_MultipleCompileFormats
Per configurare il comportamento del plugin <code>latexsuite</code> secondo le proprie personali esigenze è necessario editare il succitato file <code>'''texrc'''</code>. Qui è possibile ridefinire le macro, il comportamento in fase di compilazione e visualizzazione, l'uso dei placeholder, il comportamento delle finestre di dialogo (per esempio per gli ambienti e la bibliografia), le scorciatoie, il folding e altro ancora.
Tex_ViewRule_pdf
La documentazione relativa si può trovare seguendo il primo dei link sottostanti.


== Link ==
== Link ==
* [http://vim-latex.sourceforge.net/index.php Vim-LaTeX Homepage]: la homepage della <code>latexsuite</code> di Vim.
* [http://newbiedoc.sourceforge.net/tutorials/vim/index-vim.html.en Beginner's guide to Vi Improved (Vim)]: una guida in inglese a Vim.


* [http://vim-latex.sourceforge.net/index.php Vim-LaTeX Homepage]: la homepage delle latexsuite di vim.
{{Autori
* [http://newbiedoc.sourceforge.net/tutorials/vim/index-vim.html.en Beginner's guide to Vi Improved (vim)]: una guida in inglese a vim.
|Autore = [[Utente:TheNoise|TheNoise]]
|Verificata_da =
: [[Utente:HAL 9000|HAL 9000]] 12:20, 3 set 2014 (CEST)
: [[Utente:Spoon|Spoon]] 15:24, 26 mag 2015 (CEST)
|Estesa_da =
: [[Utente:Spoon|Spoon]] 16:01, 11 ago 2014 (CEST)
|Numero_revisori=2
}}


[[Categoria:Desktop]][[Categoria:Tips&Tricks]]
[[Categoria:Elaborazione testi]]

Versione attuale delle 18:50, 6 set 2019

Debian-swirl.png Versioni Compatibili

Debian 8 "jessie"
Debian 9 "stretch"

Introduzione a LaTeX

Se non conoscete LaTeX o ne avete solo sentito parlare, e ne siete in qualche modo incuriositi, potreste trovarvi spaesati di fronte alla mastodontica quantità di informazioni presenti in internet. Di seguito si elencano le principali risorse.

Una (mica tanto) breve introduzione a LaTeX2e
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 Utilizzatori Italiani di Tex (ma non solo). Si va dalle introduzioni ad argomenti molto specifici e avanzati. Tra di essi si segnala in particolare L'Arte di scrivere con LaTeX, una guida molto ben scritta che parte da zero per arrivare ad un uso mediamente avanzato di LaTeX.
Capitolo 50: LaTeX
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.

Installazione

LaTeX è un linguaggio di markup, non un programma o un pacchetto, dunque non è possibile "installarlo". Come per i linguaggi di programmazione, si installa in realtà un compilatore che sia in grado di convertire il codice sorgente in un opportuno output. A corredo di esso saranno poi presenti altri pacchetti con il compito di fornire ulteriori funzionalità (font, documentazione, estensioni, eccetera).

La distribuzione consigliata di tutti questi applicativi è quella conosciuta come texlive. Per installarne una versione completa, si installi il metapacchetto texlive-full:

# apt-get install texlive-full

Il metapacchetto texlive fornisce invece una versione della distribuzione funzionante e comprensiva dei pacchetti più usati, ma non completa. È fortemente consigliato installare versioni complete della distribuzione, soprattutto per i non esperti.

Per installare Vim con il supporto avanzato per LaTeX bastano invece i pacchetti vim-gtk, vim-latexsuite e vim-addon-manager.

# apt-get install vim-gtk vim-latexsuite vim-addon-manager

Per utilizzare effettivamente il plugin è necessario dare il comando

$ vim-addons install latex-suite

Scorciatoie

Il plugin latexsuite fornisce utili scorciatoie per svolgere velocemente alcuni compiti.

Placeholder
Si noterà che vari comandi propri della latexsuite inseriscono nel file sorgente anche uno o più simboli <++>. Essi si chiamano placeholder e non sono altro che dei segnaposto. È possibile saltare al successivo placeholder con CTRL + j.

Di seguito si elencano le principali scorciatoie.

Ambienti

Dopo aver scritto una parola si prema F5 indifferentemente in insert mode o in normal mode. Si aprirà un environment con la parola appena scritta come nome e con gli opportuni placeholder. Ciò è particolarmente utile per ambienti usati frequentemente, come equation, gather, align, enumerate, itemize, description, eccetera; in alcuni casi il plugin inserisce anche altro codice, per esempio nel caso dell'ambiente equation sarà inserita anche la riga \label{<++>}.

Esempio
foo

Premendo F5

\begin{foo}
    
\end{foo}<++>

Se invece si preme F5 senza aver precedentemente scritto una parola, si aprirà un wizard in cui sono elencati i nomi di alcuni ambienti. Scegliendone uno, si aprirà l'ambiente corrispondente nel sorgente.

Scorciatoie per gli ambienti

Comandi

Dopo aver scritto una parola si prema F7 indifferentemente in insert mode o in normal mode. La parola appena scritta sarà trasformata in un comando con un argomento obbligatorio. Ciò è particolarmente utile per comandi quali \text, \intertext, \label, \cite, \ref, \eqref, eccetera. Anche in questo caso il plugin inserisce codice extra per alcuni comandi (per esempio, nel caso del comando \frac vengono inseriti due argomenti obbligatori anzichè uno solo).

Esempio
foo

Premendo F7

\foo{}<++>

Se invece si preme F7 senza aver precedentemente scritto una parola, si aprirà un wizard in cui sono elencati i nomi di alcuni comandi. Scegliendone uno, il comando corrispondente sarà inserito nel sorgente.

Scorciatorie per i comandi

Bibliografia e riferimenti

Il plugin latexsuite è in grado di memorizzare tutti i label presenti nel documento, nonchè le opere in bibliografia. Per richiamarle nel momento del bisogno la scorciatoia da usare è F9.

Dopo aver scritto \ref{ (o gli analoghi \vref{, \eqref{, eccetera), premendo F9 si aprirà una finestra con i riferimenti disponibili per il completamento, da cui è possibile scegliere Invio.

Dopo aver scritto \cite{ (o comandi analoghi), premendo F9 si aprirà una finestra con le citazioni bibliografiche disponibili per il completamento, da cui è possibile scegliere con Invio. Nota: questo comportamento funziona solo se si gestisce la bibliografia con \thebibliography.

Scorciatoie per la bibliografia

Altro

Sezionamento: esistono scorciatoie specifiche per inserire i comandi di sezionamento quali \section, \chapter, eccetera. Sono tutte composte di tre lettere maiuscole consecutive (per esempio SSE, SCH e SSS producono \section, \chapter e \subsection rispettivamente).

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

Pedici: al posto di scrivere manualmente _{} possiamo premere __ che inserirà automaticamente le parentesi graffe ed il placeholder per uscire dal pedice.

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

Lettere greche: per inserire svariate lettere greche è possibile digitare il carattere ` seguito dall'iniziale della lettera voluta. Per esempio, `a produce \alpha. Data la non coincidenza dei due alfabeti, non tutte le lettere greche si possono ottenere in questo modo, inoltre non sempre la lettera da usare corrisponde all'iniziale.

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 latexsuite basta premere \rf (Refresh folds) in normal mode. Per aprire o chiudere un folding basta andarci sopra col cursore e premere za sempre in normal mode.

Altri comandi li trovate nel menu Strumenti -> Piegature.

Template

Per iniziare un articolo è possibile usare un template:

Menu TeX_Suite -> Templates

o il comando

:TTemplate

I template sono conservati nella cartella ~/.vim/ftplugin/latex-suite/templates/. Qui è anche possibile copiare i propri template.

Compilazione (Produrre DVI/PDF)

Con il plugin latexsuite è 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 impostare tramite il menù TeX-Suite i valori di Target format, oppure usando il comando:

:TTarget pdf

Fatto questo, con \ll si produrrà il pdf e con \lv lo si visualizzerà. Di default il pdf è creato mediante il comando pdflatex.
Se la visualizzazione con \lv non dovesse funzionare è possibile 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 etichette, riferimenti, eccetera, bisogna eseguire la compilazione più volte perchè i riferimenti siano corretti. Di default la latexsuite esegue più volte la compilazione solo se si producono dvi. Perchè questo avvenga anche quando si compila per produrre pdf è sufficiente eseguire il comando:

:let g:Tex_MultipleCompileFormats = 'pdf,dvi'

Per evitare di fare ciò ogni volta, è possibile editare il file texrc, di solito contenuto in ~.vim/ftplugin/latex-suite/texrc, modificando le seguenti stringhe

g:Tex_DefaultTargetFormat
g:Tex_MultipleCompileFormats
g:Tex_ViewRule_pdf
Compilare grandi documenti
Nel caso sia necessario compilare un documento complesso (per esempio con al suo interno per esempio dei comandi \include o \input) esistono altri strumenti che ci vengono in aiuto. Uno di essi è latexmk: il pacchetto fornisce l'omonimo comando di shell che provvede autonomamente a compilare il numero di volte necessari i vari documenti (e solo quando necessario). Infine, è sempre possibile avvalersi dell'utility make, istruendola con un opportuno makefile.

Configurazione avanzata

Per configurare il comportamento del plugin latexsuite secondo le proprie personali esigenze è necessario editare il succitato file texrc. Qui è possibile ridefinire le macro, il comportamento in fase di compilazione e visualizzazione, l'uso dei placeholder, il comportamento delle finestre di dialogo (per esempio per gli ambienti e la bibliografia), le scorciatoie, il folding e altro ancora. La documentazione relativa si può trovare seguendo il primo dei link sottostanti.

Link




Guida scritta da: TheNoise Swirl-auth60.png Debianized 60%
Estesa da:
Spoon 16:01, 11 ago 2014 (CEST)
Verificata da:
HAL 9000 12:20, 3 set 2014 (CEST)
Spoon 15:24, 26 mag 2015 (CEST)

Verificare ed estendere la guida | Cos'è una guida Debianized