Utente:Spoon/Draft: differenze tra le versioni

Da Guide@Debianizzati.Org.
Vai alla navigazione Vai alla ricerca
(controllo guida, come richiesto)
(Scrittura/aggiornamento della guida su Gnash)
Riga 1: Riga 1:
{{Versioni compatibili}}
= Gnash e il plugin per Iceweasel =
== Introduzione a LaTeX ==
__NOTOC__
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.
{{Versioni compatibili|Wheezy|Jessie|Sid}}
== Introduzione ==
Da buon utente Debian si è sempre alla ricerca di qualche strumento libero per liberarci da quelle cattive abitudini di utilizzare software proprietario ;-). Fra i casi più comuni, le catene di Flash sono state per anni un qualcosa di difficile dalle quali liberarsi. Dal 2005 GNU ha incominciato lo sviluppo di un software libero che potesse leggere e dunque riprodurre i filmati in formato Flash: nacque così [http://www.gnu.org/software/gnash/ Gnash].


; [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.
Mentre le prime versioni presentavano qualche difficoltà d'utilizzo, il software è migliorato di tempo in tempo arrivando ai giorni attuali in grado di sostituire quasi completamente il suo compagno proprietario.


; [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.
Fino a Debian Squeeze 6 era possibile incontrare difficoltà con [http://youtube.com YouTube]: per poter sfruttare il plugin di Gnash per Iceweasel era necessario mettere a punto una soluzione basata su [http://www.greasespot.net/ GreaseMonkey]. Nella guida [http://guide.debianizzati.org/index.php/Visualizzare_filmati_YouTube_con_Gnash_e_GreaseMonkey Visualizzare filmati YouTube con Gnash e GreaseMonkey] è spiegato come fare.


; [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. 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.
Da Debian Wheezy 7 in poi non è più necessario ricorrere a tale situazione di compromesso, in quanto il plugin di Gnash per Iceweasel funziona autonomamente su YouTube. In questa guida è spiegato come installare Gnash e il relativo plugin, in modo da poter fare a meno di Flash in moltissime situazioni.


; [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.
== Installare Gnash e il plugin per Iceweasel ==
Evidentemente si deve avere Iceweasel installato. Se questo non fosse il caso è possibile installarlo come sempre tramite Apt con l'interfaccia preferita.


<!-- NOTA: Da controllare prima di aggiungerla, al momento la pagina non è trovata:
<pre># aptitude install iceweasel</pre>


Infine si segnala la risorsa più completa nella quale troverete informazioni dettagliate su ogni singolo comando LaTeX: '''[http://www.eng.cam.ac.uk/help/tpl/textprocessing/teTeX/latex/latex2e-html/ltx-2.html Help On LaTeX Commands]'''
La guida è stata testata con la versione XXX di Iceweasel da Wheezy-backports. In seguito si installi Gnash allo stesso modo:


-->
<pre># aptitude install gnash</pre>
== 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 provvedere a ulteriori funzionalità (come per esempio fornire font, documentazione, estensioni, eccetera).


La versione consigliata di tutti questi applicativi è quella conosciuta come ''texlive''. Per installarne una versione completa, si installi il pacchetto <code>texlive</code>.
Su Wheezy attualmente è presente la versione YYY. Per utilizzare il plugin di gnash con Iceweasel è necessario installare anche il pacchetto
Sebbene sia possibile installare anche versioni non complete, questo è il comportamento consigliato, 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># aptitude install browser-plugin-gnash</pre>
Per utilizzare effettivamente il plugin è necessario dare il comando
<pre>$ vim-addons install latex-suite</pre>


==Scorciatoie==
alla stessa versione di Gnash.
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>.


Di seguito si elencano le principali scorciatoie.
Attenzione: in precedenza era necessario installare il pacchetto mozilla-plugin-gnash. Da un po' di tempo quest'ultimo non è altro che un pacchetto fittizio che rimanda a browser-plugin-gnash. È pertanto da considerarsi obsoleto e rimpiazzato da browser-plugin-gnash.
====Ambienti====
Dopo aver scritto una parola in ''insert mode'', 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
A questo punto si è già liberi di navigare con Iceweasel e il nuovo plugin di Gnash. Non si dovrebbero riscontrare particolari problemi e si potrà già godere i benefici di un ulteriore plugin free in più sul PC o - meglio detto - un plugin non-free in meno.
<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.
==== YouTube ====


[http://vim-latex.sourceforge.net/documentation/latex-suite/environment-mappings.html Scorciatoie per gli ambienti]
Come detto in precedenza, fino a Debian Squeeze era necessario arrivare a una soluzione di compromesso per poter usare Gnash su YouTube. Ora questo non è più necessario, non solo perchè Gnash funziona correttamente, ma anche perchè YouTube è passato da tempo a HTML5, non richiedendo quindi Flash per funzionare. Gnash risulta però ancora necessario per evitare Flash in tutti quei casi in cui la pagina adotti questa soluzione.


====Comandi====
{{Autori | Autore= [[Utente:Spoon|Spoon]] 11:43, 6 apr 2015 (CEST) }}
Dopo aver scritto una parola in ''insert mode'', 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
[[Categoria: Multimedia]][[Categoria: Browser]]
<pre>
foo
</pre>
Premendo <code>F7</code>
<pre>
\foo{}<++>
</pre>
 
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.
 
[http://vim-latex.sourceforge.net/documentation/latex-suite/latex-command-maps.html Scorciatorie per i comandi]
 
====Bibliografia====
Il plugin <code>latexsuite</code> è in grado di memorizzare tutti i label presenti nel documento, nonchè le opere in bibliografia (se date con <code>\bibitem</code>). Per richiamarle nel momento del bisogno la scorciatoia da usare è <code>F9</code>. Dopo aver scritto <code>\ref{</code> (o gli analoghi <code>\vref{</code>, <code>\eqref{</code>, eccetera), si prema <code>F9</code>. Si aprirà una finestra di dialogo con le opzioni disponibili per il completamento, da cui sarà possibile scegliere quella desiderata con <code>Invio</code>.
 
[http://vim-latex.sourceforge.net/documentation/latex-suite/bibtex-bindings.html Scorciatoie per la bibliografia]
 
====Altro====
 
'''''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).
 
'''''Esponenti''''': al posto di scrivere manualmente <code>^{}</code> possiamo premere <code>^^</code>
che inserirà automaticamente le parentesi ed il placeholder per uscire dall'esponente.
 
'''''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.
 
'''''Segno uguale''''': al posto di <code>&=&</code> è possibile scrivere solo <code>==</code>.
 
'''''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>. Per ovvi motivi di 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/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==
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 <code>latexsuite</code> basta premere <code>\rf</code> (''Refresh Folding'') 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''.
 
==Template==
Per iniziare un articolo è possibile usare un template:
 
: ''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.
 
==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).
 
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:
 
<pre>:TTarget pdf</pre>
 
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:
 
<pre>:!evince nome_file.pdf</pre>
 
Per impostare un visualizzatore di pdf diverso da quello di default basta usare il seguente comando:
 
<pre>:let g:Tex_ViewRule_pdf = 'evince'</pre>
 
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:
<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>
 
; Compilare grandi documenti : Nel caso sia necessario compilare un documento complesso (che abbia al suo interno per esempio dei comandi <code>\include</code> o <code>\input</code>) esistono altri strumenti che 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'''.
== Configurazione avanzata ==
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.
La documentazione relativa si può trovare seguendo il primo dei link sottostanti.
 
== 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.
 
{{Autori
|Autore = [[Utente:TheNoise|TheNoise]]
|Verificata_da =
: [[Utente:Spoon|Spoon]] 16:01, 11 ago 2014 (CEST)
|Estesa_da =
: [[Utente:Spoon|Spoon]] 16:01, 11 ago 2014 (CEST)
|Numero_revisori=1
}}
 
[[Categoria:Elaborazione testi]]

Versione delle 09:43, 6 apr 2015

Gnash e il plugin per Iceweasel

Debian-swirl.png Versioni Compatibili

Debian 7 "wheezy"
Debian 8 "jessie"
ERRORE: utilizzare "unstable_2024" come parametro al posto di " Sid "! Vedi qui.

Introduzione

Da buon utente Debian si è sempre alla ricerca di qualche strumento libero per liberarci da quelle cattive abitudini di utilizzare software proprietario ;-). Fra i casi più comuni, le catene di Flash sono state per anni un qualcosa di difficile dalle quali liberarsi. Dal 2005 GNU ha incominciato lo sviluppo di un software libero che potesse leggere e dunque riprodurre i filmati in formato Flash: nacque così Gnash.

Mentre le prime versioni presentavano qualche difficoltà d'utilizzo, il software è migliorato di tempo in tempo arrivando ai giorni attuali in grado di sostituire quasi completamente il suo compagno proprietario.

Fino a Debian Squeeze 6 era possibile incontrare difficoltà con YouTube: per poter sfruttare il plugin di Gnash per Iceweasel era necessario mettere a punto una soluzione basata su GreaseMonkey. Nella guida Visualizzare filmati YouTube con Gnash e GreaseMonkey è spiegato come fare.

Da Debian Wheezy 7 in poi non è più necessario ricorrere a tale situazione di compromesso, in quanto il plugin di Gnash per Iceweasel funziona autonomamente su YouTube. In questa guida è spiegato come installare Gnash e il relativo plugin, in modo da poter fare a meno di Flash in moltissime situazioni.

Installare Gnash e il plugin per Iceweasel

Evidentemente si deve avere Iceweasel installato. Se questo non fosse il caso è possibile installarlo come sempre tramite Apt con l'interfaccia preferita.

# aptitude install iceweasel

La guida è stata testata con la versione XXX di Iceweasel da Wheezy-backports. In seguito si installi Gnash allo stesso modo:

# aptitude install gnash

Su Wheezy attualmente è presente la versione YYY. Per utilizzare il plugin di gnash con Iceweasel è necessario installare anche il pacchetto

# aptitude install browser-plugin-gnash

alla stessa versione di Gnash.

Attenzione: in precedenza era necessario installare il pacchetto mozilla-plugin-gnash. Da un po' di tempo quest'ultimo non è altro che un pacchetto fittizio che rimanda a browser-plugin-gnash. È pertanto da considerarsi obsoleto e rimpiazzato da browser-plugin-gnash.

A questo punto si è già liberi di navigare con Iceweasel e il nuovo plugin di Gnash. Non si dovrebbero riscontrare particolari problemi e si potrà già godere i benefici di un ulteriore plugin free in più sul PC o - meglio detto - un plugin non-free in meno.

YouTube

Come detto in precedenza, fino a Debian Squeeze era necessario arrivare a una soluzione di compromesso per poter usare Gnash su YouTube. Ora questo non è più necessario, non solo perchè Gnash funziona correttamente, ma anche perchè YouTube è passato da tempo a HTML5, non richiedendo quindi Flash per funzionare. Gnash risulta però ancora necessario per evitare Flash in tutti quei casi in cui la pagina adotti questa soluzione.




Guida scritta da: Spoon 11:43, 6 apr 2015 (CEST) Swirl-auth20.png Debianized 20%
Estesa da:
Verificata da:

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