Neue HTML-Fenster aus PDF-Dateien öffnen

Transkript

1 Neue HTML-Fenster aus PDF-Dateien öffnen Alfred Wassermann, Bayreuth 19. Dezember 2002 Inhaltsverzeichnis 1 Was ist das Problem? 1 2 Die Lösung Was haben wir bisher getan? Ein Trick Der Rücksprung Eine HTML-Datei für alle Zwecke Die reine L A TEX-Lehre Was ist das Problem? PDF (Portable Document Format) ist eine PostScript-ähnliche Sprache für druckfertige Dokumente mit Zusatzfunktionen für die multimediale Nutzung der Dokumente am Bildschirm. Zur Darstellung von PDF-Dokumenten ist das (kostenlos erhältliche) Programm Acrobat Reader am weitesten verbreitet. Für die Nutzung am Bildschirm können in das Dokument nun einige Interaktionselemente wie Querverweise (Links) und Buttons eingebaut werden. Kurz, das Dokument kann zum Hypertext, zum multimedialen Gesamtkunstwerk erweitert werden. Wir sind uns einig, dass die Krönung des ästhetischen Schaffens darin besteht, PDF-Dokumente mit TEX, bzw. L A TEX zu erstellen. Wir erreichen dadurch die TEX-typische Typographie-Qualität, insbesondere im mathematischen Formelsatz, und gleichzeitig Hypertext-Funktionalität. Bieten wir unsere Kunstwerke im World Wide Web zum Betrachten an, so wird der Großteil der Lesenden diese Dokumente innerhalb des Web- Browsers sehen, dargestellt durch ein sogenanntes Plugin, das Acrobat- Reader-Plugin. 1

2 Charakteristisch für Hypertext sind Querverweise, auch Links genannt. Nun kann es selbst dem renommiertesten Autor blühen, dass er/sie einen Querverweis auf ein anderes Dokument setzen muss, zum Beispiel einen Querverweis auf eine HTML-Seite. Notwendig wird dies etwa dann, wenn Java- Applets verwendet werden. Diese können leider nicht innerhalb eines PDF- Dokuments angezeigt werden; es ist eine HTML-Datei nötig, die das Java- Applet beheimatet. Testen Sie nun bitte den folgenden Querverweis und klicken Sie danach auf den Zurück -Button des Web-Browsers. Querverweis auf GEONExT Wenn Sie den obigen Querverweis getestet haben, wird Ihnen auffallen, dass die HTML-Datei im gleichen Web-Browser-Fenster geöffnet wurde, in dem vorher das PDF-Dokument angezeigt worden war. Ebenso wird Ihnen vielleicht aufgefallen sein, dass beim Klicken auf den Zurück -Button des Browsers zwar das PDF-Dokument wieder angezeigt wird, wir uns allerdings nun auf Seite 1 befinden, während der Querverweis sich auf Seite 2 befindet. Bei längeren PDF-Dokumenten gestaltet sich dadurch das Weiterlesen an der jeweilig richtigen Stelle als sehr mühsam. Der Leser wird sich mit der Zeit hüten, auf einen Link zu klicken, um ja nicht den Faden zu verlieren. Manchmal ist dieses Verhalten wünschenswert, meist beabsichtigt der Autor jedoch eine der folgenden Aktionen: Beim Klick auf einen Querverweis auf eine HTML-Datei öffnet sich ein neues Fenster, in dem die HTML-Datei angezeigt wird, ohne dass sich die Anzeige des PDF-Dokuments ändert. Das Browser-Fenster ist in Frames unterteilt. Klickt man auf einen Querverweis im PDF-Dokument, das in einem der Frames angezeigt 2

3 wird, wird die HTML-Datei in einem anderen Frame angezeigt, ohne dass sich die Anzeige des PDF-Dokuments ändert. Leider sind beide Aktionen momentan nur über einen kleinen Umweg zu realisieren. 2 Die Lösung 2.1 Was haben wir bisher getan? Als kleine Wiederholung wollen wir zuerst in unser L A TEX-Dokument einen Querverweis auf eine HTML-Seite einbauen. Dazu und für alle folgenden Beispiele benötigen wir das hyperref-paket: \documentclass... \usepackage{hyperref... Im laufenden Text kann nun der Querverweis gesetzt werden... \href{ auf GEONExT... und wir sehen im resultierenden PDF-Dokument die Zeile Querverweis auf GEONExT. Damit sind wir genau bei unserem angesprochenen Problem angelangt, die HTML-Datei öffnet sich im gleichen Fenster wie das PDF-Dokument. 2.2 Ein Trick Würden wir nur mit HTML-Dateien arbeiten, so stünde uns HTML- bzw. JavaScript-Befehle wie target= oder window.open() zur Verfügung. Leider haben wir innerhalb eines PDF-Dokuments darauf direkt keinen Zugriff. Um unser Ziel zu erreichen, müssen wir deshalb einen kleinen HTML-Trick anwenden und durch die Hintertür die JavaScript-Funktionalität des Web- Browsers bemühen. Dazu erstellen wir eine kurze HTML-Datei, der wir zum Beispiel den Namen pdfnewwindow.html geben, mit folgendem Inhalt: <html> window.open(" "", "width=400,height=300"); 3

4 this.location = "neuesfenster.pdf"; Dabei gehen wir von dem Fall aus, dass die PDF-Datei, aus der wir den Querverweis anklicken, den Namen neuesfenster.pdf trägt und sich die beiden Dateien pdfnewwindow.html und neuesfenster.pdf im gleichen Verzeichnis auf dem Web-Server befinden. Der Querverweis im L A TEX-Dokument wird mit \href{ auf GEONExT eingefügt. Natürlich müssen server und verzeichnis entsprechend angepasst werden. Bei aller Eleganz ist diese Anpassung ein kleiner Wermutstropfen, der die Portabilität des Konstrukts behindert. Jeder Autor mit rudimentären L A TEX-Kenntnissen lindert diesen Umstand mit einem Makro: \newcommand{\basisadresse{ \href{\basisadresse/pdfnewwindow.html{querverweis auf GEONExT Im PDF-Dokument liest der Betrachter nun Querverweis auf GEONExT. Damit haben wir unser erstes Problem gelöst, es wird sich ein neues Fenster mit dem HTML-Text öffnen. Was steckt dahinter? Der Trick besteht darin, zuerst in dem Web- Browser-Fenster, in dem die PDF-Datei angezeigt wird, die Datei pdfnewwindow.html anzuzeigen. Beim Anzeigen dieser HTML-Datei wird blitz- schnell das darin enthaltene JavaScript-Programm ausgeführt, das ein neues HTML-Fenster öffnet und gleichzeitig im momentanen Fenster wieder die PDF-Datei anzeigt. Frames. Wollen wir mit Frames arbeiten, genügt es die Datei pdfnewwindow.html leicht zu variieren. Gehen wir davon aus, dass das PDF- Dokument in einem Frame angezeigt wird, den wir rechts genannt haben, und die HTML-Datei im Frame mit dem Namen links angezeigt werden soll. Wir können den gleichen L A TEX-Querverweis wie oben verwenden und müssen lediglich die Datei pdfnewwindow.html folgendermaßen umwandeln. 4

5 <html> parent.links.location=" parent.rechts.location="neuesfenster.pdf"; 2.3 Der Rücksprung Der aufmerksame Tester hat sicher bemerkt, dass wir noch nicht vollständig zufrieden sein können. Zwar wird ein neues HTML-Fenster geöffnet bzw. es werden die richtigen Frames verwendet, aber es wird immer die erste Seite des PDF-Dokuments angezeigt, und nicht die Seite, auf der sich der Querverweis befindet. Dies ist aber nun nur noch eine kleine Fingerübung: Wir setzen an die Stelle des Querverweises einen Anker und springen beim Wiederaufruf des PDF- Dokumentes zu diesem Anker. Im L A TEX-Quellcode schreiben wir dazu \hypertarget{hierherspringen{% \href{\basisadresse/pdfnewwindow.html{querverweis auf GEONExT und in pdfnewwindow.html geben wir als Verweisziel diesen Anker an: <html> window.open(" "", "width=400,height=300"); this.location = "neuesfenster.pdf#hierherspringen"; Das probieren wir aus: Querverweis auf GEONExT. 5

6 Es funktioniert! Durch das Neuladen des PDF-Dokumentes wirkt die Lösung zwar etwas ruckelig, aber der Leser bleibt beim Anklicken des Querverweises immerhin auf der gleichen Seite des PDF-Dokumentes. 2.4 Eine HTML-Datei für alle Zwecke Nun ist es unser ständiges Bestreben, unser Leben zu erleichtern. Aus diesem Grund wollen wir nicht für jeden Querverweis eine eigene HTML-Datei im Stil von pdfnewwindow.html erstellen. Wir können genauso gut mit Variablen arbeiten. Betrachten wir folgende HTML-Datei, die wir link.html nennen: <html> var Ausdruck = /(\w.+)=(\w.+)&(\w.+)=(\w.+)/; var sprung = window.location.search; Ausdruck.exec(sprung); adresse = RegExp.$2; sprung = RegExp.$4; window.open(adresse, "", "width=400,height=300"); this.location="neuesfenster.pdf"+datei+"#"+sprung; Im L A TEX-Dokument setzen wir dann folgenden Querverweis: \hypertarget{ziel{% \href{\basisadresse/link.html?dat= {Querverweis auf GEONExT Damit kann allgemein eine Web-Adresse und eine Rücksprung-Adresse an die Datei link.html weitergereicht werden. HTML-Autoren mit JavaScript-Kenntnissen sehen, dass wir die gewünschte Web-Adresse und die Rücksprung-Adresse als GET-Variable an die Datei link.html übergeben. Mittels regulärer Ausdrücke werten wir im JavaScript- Programm die Variablen aus und springen zu den darin enthaltenen Adressen. 6

7 2.5 Die reine L A TEX-Lehre Es kann Gründe geben, dass ein Autor mit dieser HTML-Zwischendatei nicht recht glücklich ist. Sei es, weil alle Abhängigkeiten mit dem L A TEX-Dokument kontrolliert werden sollen oder weil der Autor grundsätzlich keine Dateien außer L A TEX-Dateien editieren will. Hier ist eine Möglichkeit, aus dem L A TEX-Dokument heraus alle erforderlichen HTML-Dateien mit pdflatex zu erzeugen. \newcommand{\basisadresse{ \newcounter{verweis\setcounter{verweis{1 {\catcode [=1 \catcode ]=2 \catcode {=11 \catcode =11 \catcode #=11 \gdef\charlb[{] \gdef\charrb[] \gdef\chardc[#] ] \newcommand{\querverweis[2]{% \hypertarget{quer\arabic{vnr{% \href{\basisadresse/pdflink\arabic{vnr.html{#2 \immediate\openout9=pdflink\arabic{vnr.html \immediate\write9{<html><script language= JavaScript > \immediate\write9{function weiter() \charlb \immediate\write9{window.open( #1 ); \immediate\write9{this.location= \jobname.pdf\chardc quer\arabic{vnr ; \immediate\write9{\charrb \immediate\write9{<body onload= weiter() > \immediate\write9{ \immediate\closeout9 \stepcounter{vnr Unser neuer Befehl \querverweis hat genau wie href zwei Parameter: das Verweisziel und den Verweistext. \querverweis{ auf GEONExT Dadurch wird automatisch für jeden Querverweis eine HTML-Datei geschrieben, die den Namen pdflinkxxx.html trägt, wobei xxx für eine fortlaufende Nummer steht. Diese fortlaufende Nummer wird im TEX-Zähler vnr verwaltet, der in jedem Aufruf des Makros \querverweis hochgezählt wird. Der Name der PDF-Datei wird durch das TEX-Kommando \jobname bestimmt. Deshalb ist Vorsicht geboten, wenn die PDF-Datei im Nachhinein umbenannt wird. Für TEX-Puristen: Ja, es ist unsauber, \openout9 zu verwenden. Allerdings scheint \newwrite nicht für beliebig viele Dateien zu funktionieren. Abschließend ist hier ein Verweis auf den L A TEX-Quelltext des vorliegenden Dokumentes. 7