Het handboek van &kdvi;

Naar &PostScript; exporteren Net als bij het afdrukken, wordt het externe programma dvips gebruikt bij het genereren van het &PostScript;-bestand. Als het &DVI;-bestand hyperlinks bevat, worden deze ook in het &PostScript;-bestand opgenomen. Als u een expert bent, en als u uitvoer wilt genereren die geoptimaliseerd is voor een specifieke printer, dient u waarschijnlijk dvipss handmatig te starten en zelf de juiste MetaFont-modus te kiezen.

Naar <acronym>PDF</acronym> exporteren Om PDF-bestanden van hoge kwaliteit te produceren, converteert &kdvi; &DVI;-bestanden naar PDF met het externe programma dvipdfm. Als u op een machine werkt waar een oudere versie van het typesetting-systeem TeX is geïnstalleerd, kan het zijn dat het programma dvipdfm niet geïnstalleerd is. In dat geval dient u de afdrukfunctie te gebruiken om PDF-uitvoer te genereren. Als u een oudere TeX-installatie gebruikt, en als u het gegenereerde besatnd in Acrobat Reader van Adobe bekijkt, kunt u merken dat sommige lettertypen er zeer lelijk uitzien hoewel een afdruk er goed uitziet en het document er ook goed uitziet in kghostview. Dit is een bekend probleem met Acrobat Reader en bitmaplettertypen. Op het moment dat dit handboek geschreven werd, lijkt de enige praktische oplossing om bitmaplettertypen te proberen te vermijden, of naar een recentere TeX-installatie op te waarderen. Hoewel dvipdfm PDF-bestanden van hoge kwaliteit genereert, negeert dvipdfm momenteel de &PostScript; die is ingebed in het &DVI;-bestand. Ingebedde PostScript wordt gegenereerd door bijvoorbeeld het macropakket xy, of door de &kdvi;-functie "PostScript-bestanden inbedden die hieronder beschreven wordt. Als u merkt dat de gegenereerde PDF-uitvoer grafische gegevens mist, gebruikt u in plaats daarvan de afdrukfunctie van &kdvi;.

Exporteren naar tekstbestanden &kdvi; kan ook uw &DVI;-bestanden in tekstformaat opslaan. De &DVI;-bestandsstandaard is niet ontworpen voor deze functionaliteit. Deze functie werkt daarom alleen met standaard ASCII-tekens. Het werkt niet met niet-Europese talen. Afhankelijk van de gebruikte lettertypen, kunnen er ook problemen zijn met lettertekens met accenten of umlauts, en soms met ligaturen.

TeX-bestanden maken voor inverse search Er zijn in feite twee manieren om &DVI;-bestanden met inverse search informatie te produceren: u kunt een TeX/LaTeX-programma gebruiken dat de benodigde informatie automatisch aanmaakt en invoegt, of u kunt een extra pakket gebruiken dat in TeX/LaTeX geschreven is. Een TeX-programma dat de benodige informatie automatisch genereert en invoegt, is zeker de methode om inverse search informatie in te voegen die de voorkeur geniet. Als u versie 2 of hoger van de TeTeX TeX-distributie gebruikt, kut u de opdrachtregeloptie 'src-specials' van de opdracht 'tex' of 'latex' gebruiken, als volgt: tex --src-specials bestand.tex of latex --src-specials bestand.tex Als u geen TeX-programma hebt dat uit zichzelf de inverse search informatie bevat, kopieert u de bestanden srcltx.sty en srctex.sty naar de map waar uw TeX-bestand zich bevindt (u kunt dat doen door de toets &Shift; en de &LMB; in te drukken als de muispijl op een hyperlink staat.) Als u LaTeX gebruikt, voegt u de regel \usepackage[active]{srcltx} toe aan de preambule van uw LaTeX-bestand. Als u TeX gebruikt, zal de regel \include{srctex} het doen. Hoewel inverse search zeer nuttig is als u zelf een document aan het typen bent, kan het een goed idee zijn om de inverse search informatie te verwijderen voordat u het &DVI;-bestand naar iemand anders stuurt.

Uw editor instellen voor inverse search Hoewel inverse search meestal erg goed werkt met de meeste editors, hebben sommige wat extra aandacht nodig. Deze sectie legt uit hoe u uw editor moet instellen.

<application>Emacs</application> Emacs werkt goed samen met &kdvi;. Het eigenlijke gedrag van Emacs hangt grotendeels af van de instellingen. Zoals gewoonlijk kunt u Emacs volledig aanpassen, als u bereid bent u door Lisp-code heen te slaan. &kdvi; gebruikt het programma emacsclient om Emacs vanaf afstand te bedienen. Het programma emacsclient vereist dat Emacs actief is, en dat het programma Emacs Server binnen Emacs gestart is. Inverse search werkt niet optimaal totdat u zowel Emacs als de Emacs Server gestart hebt. Om de Emacs Server te starten, kunt u één van de volgende dingen doen: In Emacs, start u de Emacs Server door MX server-start te typen. Voeg de regel (server-start) toe aan uw bestand .emacs. Herstart Emacs. Zorg ervoor dat Emacs geïnstalleerd is. Probeer emacs vanaf de opdrachtregel te starten. &kdvi; gebruikt de opdracht emacsclient om Emacs van afstand te besturen. Zorg ervoor dat emacsclient op de opdrachtregel beschikbaar is door de opdracht emacsclient tekstbestand in te voeren. Dit zou een nieuw tekstbestand in de editor Emacs moeten openen. Als emacsclient afsluit met een foutmelding als unable to connect to local, zorgt u ervoor dat Emacs actief is. Verder zorgt u ervoor dat de Emacs Server gestart is door middel van Mx server-start. Als u het kader automatisch bovenop wilt laten tonen, voegt u de functie raise-frame toe aan server-switch-hook (doe Mx customize-variable RET server-switch-hook en voer de functienaam in in het tekstveld). Als u de buffer hebt gewijzigd sinds de laatste keer dat u hebt opgeslagen, vraagt Emacs u: Revert buffer from file ...? (yes or no). Hier wilt u waarschijnlijk altijd no antwoorden, want teruggaan betekent dat het bestand herlezen wordt van schijf, waardoor alle wijzigingen sinds de laatste keer opslaan verloren gaan! Het gedrag van gnuclient om de gewijzigde buffer stil te herladen is waarschijnlijk gewenst — voeg de volgende regels toe aan het bestand .emacs om het gedrag van gnuclient te emuleren met emacsclient: (defadvice server-visit-files (around save-buffers last activate) "Try to emulate gnuclient behavior with emacsclient. Works only for visiting one buffer at a time." (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; &kde;'s editor &kate; biedt zeer goede ondersteuning voor inverse search. Er zijn geen extra instellingen nodig.

<application>Kile</application> Het LaTeX-editorsysteem Kile biedt zeer goede ondersteuning voor KDVI. Er zijn geen extra instellingen nodig. Meer informatie over Kile kunt u vinden op de homepage van Kile.

<application>NEdit</application> NEdit werkt meestal erg goed. In het &DVI;-bestand klikken zou een nieuw venster moeten openen. Als het TeX-bestand al geopend is in een ander venster van NEdit, toont het nieuwe venster een andere weergave van de buffer. Anders wordt het TeX-bestand geladen. Nadat het venster geopend is, accentueert NEdit de eerste regel van de desbetreffende alinea. &kdvi; gebruikt de opdracht ncl om NEdit van afstand te besturen. Zorg ervoor dat ncl op de opdrachtregel beschikbaar is door de opdracht ncl -noaskte proberen. Dit zou een instantie van de editor NEdit moeten openen. Als ncl niet beschikbaar is, gebruikt u misschien een oudere versie van NEdit. In dat geval dient u een recentere versie te installeren of de optie Gebruikergedefinieerde editor uit het dialoogvenster Opties te gebruiken.

<application>XEmacs</application> XEmacs werkt goed samen met &kdvi;. Het eigenlijke gedrag van XEmacs hangt grotendeels af van de instellingen. Zoals gewoonlijk kunt u XEmacs volledig aanpassen, als u zich door Lisp-code heen wilt vechten. &kdvi; gebruikt het programma gnuclient om XEmacs van afstand te besturen. Het programma gnuclient vereist dat XEmacs actief is en dat het programma gnuserv binnenXEmacs gestart is. Inverse search zal niet werken totdat u zowel XEmacs als gnuserv gestart hebt. Om het programma gnuserv te starten, kunt u een van de volgende dingen doen: In XEmacs start u gnuserv door MX gnuserv-start te typen. Voeg de regel (gnuserv-start) toe aan uw bestand .xemacs. Als u eem recentere versie van XEmacs gebruikt, is .xemacs een map. In dat geval dient u de regel aan het bestand .xemacs/init.el toe te voegen. Herstart XEmacs. Als u geen nieuw kader voor elke editor-aanroep wilt openen, en het venster automatisch naar voren wilt laten komen, stelt u Gnuserv Frame in op Use selected frame, en voegt u de functie raise-frame toe aan Visit Hook. Doe Mx customize-group RET gnuserv om dit in te stellen. Zorg ervoor dat XEmacs geïnstalleerd is. Probeer xemacs vanaf de opdrachtregel te starten. &kdvi; gebruikt de opdracht gnuserv om XEmacs van afstand te besturen. Zorg ervoor datgnuclient op de opdrachtregel beschikbaar is door de opdracht gnuclient tekstbestand te proberen. Dit zou een nieuw kader in de editor XEmacs moeten openen. Als gnuserv afsluit met een foutmelding als unable to connect to local, zorgt u ervoor dat XEmacs actief is. Verder zorgt u ervoor dat gnuserv gestart is door MX gnuserv-start te typen. Als u geen nieuw kader voor elke editor-aanroep wilt openen, en het venster automatisch naar voren wilt laten komen, stelt u Gnuserv Frame in op Use selected frame, en voegt u de functie raise-frame toe aan Visit Hook. Doe MX customize-group RET gnuserv om dit in te stellen.

<application>VI iMproved</application> / &GUI; De variant gvim van de editor vi biedt zeer goede ondersteuning voor inverse search. Er zijn geen extra instellingen nodig.

Uw editor instellen voor forward search

<application>Emacs</application> Om forward search in Emacs te gebruiken, volgt u deze stappen: Download het volgende Emacs-script, kdvi-search.el (druk met &Shift; en &LMB; op de bestandsnaam om het te downloaden) en sla het op op een plaats waar Emacs het kan benaderen — we raden een map emacs-scripts aan. Voeg de regels (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))) toe aan uw bestand .emacs. HerstartEmacs. Open Emacs, laad een TeX-bestand, maak het bijbehorende &DVI;-bestand, en voer ofwel de opdracht Mx kdvi-jump-to-line in, of druk&Ctrl;X &Ctrl;J . Het kan zijn dat Emacsu om de naam van een master file vraagt. Dit is nuttig als u een TeX-bestand gebruikt dat andere bestanden invoegt: het "master file" is het bovenste bestand dat alle andere invoegt. Emacs vraagt wellicht ook of de naam van het "master file as a local variable opgeslagen mag worden, &ie; als een commentaar aan het eind van elk bestand. Typ yes of no om door te gaan. Zorg ervoor dat Emacs geïnstalleerd is. Probeer emacs vanaf de opdrachtregel te starten. Als Emacs &kdvi; niet kan starten, vindt u de uitvoer in de buffer kdvi-output.

<application>Kile</application> Als u Kile gebruikt, zijn er geen verdere instellingen nodig.

<application>XEmacs</application> Om XEmacs in te stellen, volgt u de stappen voorEmacs hierboven, maar wijzigt u het bestand .xemacs in plaats van .emacs. Als u een zeer recente versie van XEmacs gebruikt, kan .xemacs een map zijn. In dat geval voegt u de regels toe aan .xemacs/init.el.