Manuale di &kdvi;

Esportare a &PostScript; Come nella stampa, per generare il file &PostScript; viene usato il programma esterno dvips. Se il file &DVI; contiene collegamenti ipertestuali, questi rimarranno anche nel file &PostScript;. Se sei un esperto e vuoi generare un file ottimizzato per una stampante specifica, dovresti avviare dvips manualmente dalla riga di comando e scegliere direttamente la modalità MetaFont appropriata.

Esportare a <acronym>PDF</acronym> Per produrre file PDF di alta qualità, &kdvi; converte i file &DVI; in PDF usando il programma esterno dvipdfm. Se stai utilizzando un sistema con installata una versione vecchia di TeX, il programma dvipdfm potrebbe non essere presente. In quel caso, devi usare la funzione di stampa per generare il file PDF. Se usi una vecchia installazione di TeX, e se stai visualizzando il file generato con Acrobat Reader di Adobe, potresti notare che alcuni caratteri vengono visualizzati estremamente male, anche se poi vengono comunque stampati correttamente, nonostante vengano visualizzati bene con kghostview. Questo è un problema noto di Acrobat Reader con i tipi di carattere bitmap. Al momento, l'unica soluzione praticabile è quella di evitare l'uso dei tipi di carattere bitmap o aggiornare l'installazione di TeX a una più recente. Mentre dvipdfm produce dei file PDF di alta qualità, al momento dvipdfm ignora i &PostScript; incorporati nel file &DVI;. Il PostScript incorporato è generato, per esempio, dal pacchetto di macro xy, o dalla funzione di &kdvi; "Incorpora file PostScript" descritta sotto. Se vedi che al PDF generato mancano dei dati grafici, usa la funzione di stampa di &kdvi; al suo posto.

Esportare a file di testo &kdvi; può anche salvare i tuoi file &DVI; in formato testuale. Lo standard dei file &DVI; non fu progettato pensando a questo tipo di funzionalità. Questa funzione, quindi, funziona bene solo con i caratteri ASCII standard. Non funzionerà con lingue non europee. A seconda dei caratteri usati nei file, ci potrebbero essere problemi con i caratteri accentati o con le dieresi, e a volte con le legature.

Produrre file TeX per la ricerca inversa Ci sono essenzialmente due modi per generare file &DVI; che contengono informazioni per la ricerca inversa: puoi usare un programma TeX/LaTeX che genera e include automaticamente le informazioni necessarie, oppure puoi includere un pacchetto aggiuntivo scritto in TeX/LaTeX. Un programma TeX che genera e include automaticamente le informazioni necessarie è certamente la strada migliore per includere le informazioni di ricerca inversa. Se usi la versione 2 o superiore della distribuzione teTeX di TeX, puoi usare l'opzione della riga di comando 'src-specials' dei comandi tex o latex, come segue. tex --src-specials miofile.tex o latex --src-specials miofile.tex Se non hai un programma TeX che include le informazioni di ricerca inversa in maniera nativa, copia i file srcltx.sty e srctex.sty nella cartella dove risiede il file TeX (puoi farlo premendo il tasto &Shift; e il &LMB; mentre il puntatore del mouse si trova sopra un collegamento). Se usi LaTeX, aggiungi la riga \usepackage[active]{srcltx} al preambolo del tuo file LaTeX. Se invece usi TeX semplice, usa la riga \include{srctex} Sebbene la ricerca inversa sia molto utile quando stai scrivendo un documento, potrebbe essere una buona idea rimuovere queste informazioni prima di inviare il file &DVI; a qualcun altro.

Impostare il tuo editor per la ricerca inversa Anche se la ricerca inversa funziona generalmente bene con la maggior parte degli editor di testo, alcuni richiedono un po' più di attenzione. Questa sezione illustra come impostare il tuo editor.

<application>Emacs</application> Emacs funziona bene con &kdvi;. Il comportamento di Emacs dipende in gran parte dalla configurazione. Come al solito, puoi personalizzare completamente Emacs, se non hai paura di scontrarti con il codice Lisp. &kdvi; utilizza il programma emacsclient per controllare a distanza Emacs. Il programma emacsclient richiede che Emacs sia in esecuzione e che il programma Emacs Server sia stato avviato all'interno di Emacs. La ricerca inversa non funzionerà in maniera ottimale se non sono in esecuzione sia Emacs che Emacs Server. Per avviare Emacs Server, puoi fare nei seguenti modi: Da Emacs, avvia Emacs Server digitando Mx server-start Aggiungi la riga (server-start) al tuo file .emacs. Riavvia Emacs Assicurati che Emacs sia installato. Prova ad avviare emacs dalla riga di comando. &kdvi; usa il comando emacsclient per controllare a distanza Emacs. Assicurati che emacsclient sia disponibile alla riga di comando provando a eseguire emacsclient nome di un file di testo. Questo comando dovrebbe aprire il file all'interno di Emacs. Se emacsclient non funziona e restituisce un messaggio di errore come unable to connect to local, assicurati che Emacs sia in esecuzione. Inoltre, assicurati che anche Emacs Server sia in esecuzione digitando Mx server-start. Se vuoi che la finestra venga portata in primo piano, aggiungi la funzione raise-frame a server-switch-hook (fai M x customize-variable RET server-switch-hook e inserisci il nome della funzione nel campo di testo). Se hai modificato il buffer dall'ultimo salvataggio, Emacs ti chiederà: Revert buffer from file ...? (yes or no). Di solito bisogna rispondere no, perché rispondere diversamente vuol dire che il file verrà riletto da disco, e ciò comporterà la perdita di tutte le modifiche apportate! È probabilmente preferibile il comportamento di gnuclient, che ricarica silenziosamente il buffer modificato; aggiungi le seguenti righe al tuo file .emacs per emulare il comportamento di gnuclient con emacsclient: (defadvice server-visit-files (around save-buffers last activate) "Prova a emulare il comportamento di gnuclient con emacsclient. Funziona solo per visitare un buffer alla volta." (let* ((filen (car (car (ad-get-arg 0)))) (buf (get-file-buffer filen)) (this-buf-modified-p nil)) ;;; the following is copied from server-visit-files, with ;;; a modification for the `verify-visited-file-modtime' test (if (and buf (set-buffer buf)) (if (file-exists-p filen) ;;; if the file has changed on disk, reload it ;;; using `find-file-noselect' (if (not (verify-visited-file-modtime buf)) (progn (find-file-noselect filen) ;;; if user answered `no', reset modtime anyway ;;; so that server-visit-files doesn't realize the ;;; difference: (set-visited-file-modtime))) ;;; if file exists no longer, we let server-visit-files ;;; deal with that t) (set buf (find-file-noselect filen))) (set this-buf-modified-p (buffer-modified-p buf)) (set-buffer buf) (set-buffer-modified-p nil) ad-do-it (set-buffer-modified-p this-buf-modified-p)))

&kate; L'editor &kate; di &kde; supporta molto bene la ricerca inversa. Non è richiesta nessuna configurazione aggiuntiva.

<application>Kile</application> L'editor LaTeX Kile supporta KDVI molto bene. Non è richiesta nessuna configurazione aggiuntiva. Maggiori informazioni su Kile possono essere trovare alla pagina Web di Kile.

<application>NEdit</application> NEdit funziona generalmente molto bene. Se fai clic sul file &DVI; si dovrebbe aprire una nuova finestra. Se il file TeX è già aperto in un'altra finestra di NEdit, la nuova finestra mostrerà un'altra vista dello stesso buffer. Altrimenti, il file TeX viene caricato. Dopo l'apertura della finestra, NEdit evidenzia la prima riga del paragrafo appropriato. &kdvi; utilizza il comando ncl per controllare a distanza NEdit. Assicurati che ncl sia disponibile dalla riga di comando, provando a avviare ncl -noask. Questo comando dovrebbe aprire una finestra di NEdit. Se ncl non è presente, potrebbe darsi che tu stia usando una versione vecchia di NEdit. In questo caso, puoi passare a una versione più recente, oppure usare l'opzione Editor definito dall'utente nella finestra Opzioni.

<application>XEmacs</application> XEmacs funziona correttamente con &kdvi;. Il comportamento di XEmacs dipende in gran parte dalla sua configurazione. Come al solito, puoi personalizzare completamente XEmacs, se non hai paura di scontrarti con il codice Lisp. &kdvi; usa il programma gnuclient per controllare a distanza XEmacs. Il programma gnuclient richiede che XEmacs sia in esecuzione e che il programma gnuserv sia avviato all'interno di XEmacs. La ricerca inversa non funzionerà se non sono in esecuzione sia XEmacs che gnuserv. Per avviare il programma gnuserv, puoi fare nei seguenti modi: In XEmacs, avvia gnuserv immettendo Mx gnuserv-start Aggiungi la riga (gnuserv-start) al tuo file .xemacs. Se usi una versione più recente di XEmacs, .xemacs sarà una directory. In questo caso, dovresti aggiungere tale riga in fondo al file .xemacs/init.el. Riavvia XEmacs Se non vuoi aprire una nuova finestra per ciascuna chiamata dell'editor e vuoi che la finestra venga portata in primo piano automaticamente, imposta Gnuserv Frame a Use selected frame e aggiungi la funzione raise-frame a Visit Hook. Digita Mx customize-group RET gnuserv per rendere effettive queste impostazioni. Assicurati che XEmacs sia installato. Prova ad avviare xemacs dalla riga di comando. &kdvi; usa il comando gnuserv per controllare a distanza XEmacs. Assicurati che gnuclient sia disponibile dalla riga di comando provando ad avviare gnuclient nome di un file di testo. Questo comando dovrebbe aprire una nuova finestra dell'editor XEmacs. Se gnuserv restituisce un messaggio di errore come unable to connect to local, assicurati che XEmacs sia in esecuzione. Inoltre assicurati che sia in funzione anche gnuserv digitando Mx gnuserv-start. Se non vuoi aprire una nuova finestra per ogni invocazione dell'editor e vuoi che la finestra sia portata in primo piano automaticamente, imposta Gnuserv Frame a Use selected frame e aggiungi la funzione raise-frame a Visit Hook. Digita Mx customize-group RET gnuserv per attivare queste modifiche.

<application>VI iMproved</application> / &GUI; La variante gvim dell'editor vi supporta le ricerche inverse molto bene. Non è necessaria nessuna configurazione aggiuntiva.

Impostare il tuo editor per la ricerca in avanti

<application>Emacs</application> Per usare la ricerca in avanti con Emacs, compi i seguenti passi: Scarica il seguente script per Emacs, kdvi-searc.el (premi &Shift; e il &LMB; sul nome del file per scaricarlo) e salvalo in un posto a cui Emacs possa accedere; si consiglia la cartella emacs-script. Aggiungi le righe (add-to-list 'load-path (expand-file-name "~/emacs-scripts/")) (require 'kdvi-search) (add-hook 'LaTeX-mode-hook (lambda () (local-set-key "\C-x\C-j" 'kdvi-jump-to-line))) (add-hook 'tex-mode-hook (lambda () (local-set-key "\C-x\C-j" 'kdvi-jump-to-line))) al tuo file .emacs. Riavvia Emacs. Apri Emacs, carica un file TeX, crea il file &DVI; corrispondente e digita il comando Mx kdvi-jump-to-line oppure premi &Ctrl;X &Ctrl;J . Può capitare che Emacs ti chieda il nome del master file. Ciò è utile se usi un file TeX che ne include altri: il master file è il file principale che include gli altri. Emacs forse ti chiederà di salvare il nome del file principale come una local variable, &ie; come un commento alla fine del file. Rispondi yes o no per continuare. Assicurati che Emacs sia installato. Prova ad avviare emacs dalla riga di comando. Se Emacs non riesce ad avviare &kdvi;, puoi trovare i messaggi di errore nel buffer kdvi-output.

<application>Kile</application> Se usi Kile, non è necessaria nessuna configurazione aggiuntiva.

<application>XEmacs</application> Per impostare XEmacs, segui i passi illustrati sopra per Emacs, ma modifica il file .xemacs invece di .emacs. Se usi una versione molto recente di XEmacs, .xemacs potrebbe essere una cartella. In tal caso, aggiungi le righe al file .xemacs/init.el.