FRAGMASTER(1)

NAME
fragmaster - Psfrag-Konstrukte mit Pdflatex verwenden

ÜBERSICHT
 fragmaster [OPTIONEN]

EPS- und PDF-Dateien mit eingebetteten Psfrag-Ersetzungen erstellen.

 Optionen:
  -h,--help          kurze Benutzungsanleitung
  -m,--man           komplette Handbuchseite zeigen (benötigt Perldoc)
  --clean            automatisch erzeugte $basename.{eps,pdf}-Dateien bereinigen
  --debug            weitere Infos zeigen und temporäre Dateien hinterlassen
  --force            alles neu bauen, Änderungszeiten ignorieren.
  --dirfm=Datei      angegebene Datei als optionale, verzeichnisweite
                     fragmaster-fm-Steuerdatei statt der Vorgabe
                     »fragmaster.dfm« verwenden.

BESCHREIBUNG
fragmaster ist ein Perl-Skript, das beim Einsatz von Psfrag-Konstrukten mit pdflatex hilft.

psfrag is a LaTeX package which allows one to replace text elements in included EPS graphics by arbitrary LaTeX output. Because psfrag uses PostScript for making the replacements, in principle you can't use psfrag with pdflatex which doesn't have any interfaces to PostScript.

fragmaster erstellt eine neue EPS aus ihrer ursprünglichen EPS, welche bereits alle diese psfrag-Ersetzungen enthält. Diese neue EPS-Graphik kann dann in der Tat mit allen Ersetzungen in PDF gewandelt werden. Das so erstellte »eingekapselte« PDF kann dann mit Pdflatex verwandt werden.

fragmaster durchsucht das aktuelle Verzeichnis nach Dateien, die in _fm enden und ein _fm.eps Gegenstück haben. Durch Prüfen des Veränderungszeitpunkts ermittelt das Skript, ob die Ausgabedateien neu erstellt werden müssen und erledigt dies, falls notwendig (ein bisschen, wie dies auch »make« durchführen würde).

Mittels folgendem Befehl fügen Sie die erstellte Graphik in Ihr LateX-Dokument ein:

 \includegraphics{<grafik>}

Hierbei können Sie bequem die Endung entfallen lassen. latex wird die EPS-Variante, pdflatex die PDF-Variante auswählen.

  fragmasters Steuerdatei und andere verwandte Dateien
Um das Skript zu verwenden, müssen Sie zwei Dateien pro Graphik erstellen:

    * <graphik>_fm.eps: die EPS-Datei selbst
    * <graphik>_fm: eine Fragmaster-Steuerdatei

Aus diesen Dateien wird die Psfraggte-Graphik erstellt:

    * <graphik>.eps,
    * <graphik>.pdf

Die Steuerdatei von _fm ist im Prinzip eine LaTeX-Datei (mit optionalen besonderen Kommentaren). Sie kann wie folgt ausschauen:

 % Nur ein normaler Kommentar
 %
 % Einige besondere Kommentare:
 % fmclass: book
 % fmclassopt: 11pt
 % fmopt: width=6cm
 %
 % Ein weiterer besonderer Kommentar:
 % head:
 % \usepackage{amsmath}
 % end head

 % psfrag-Befehle:
 \psfrag{x}{$x$}
 \psfrag{y}{$y = x^2$}

Der besondere Kommentar "fmclass:" führt dazu, dass das Skript die angegebene Klasse statt der Standardklasse "article" benutzt.

Der besondere Kommentar "fmclassopt:" führt dazu, dass das Skript die angegebene Klassenoptionen statt des standardmäßigen "12pt" benutzt.

Der besondere Kommentar "fmopt:" wird so evaluiert, dass der folgende Text als optionales Argument an "\includegraphics" weitergegeben wird. Damit können Sie beispielsweise den Bezug zwischen Graphik- und Schriftgröße mit Kommentaren der Art "fmopt: width=6cm" anpassen. Hierfür gibt es keine globale Voreinstellung.

Das besondere Kommentarkonstrukt "head:/end head" führt dazu, dass die Zeilen dazwischen in der Präambel des temporären LaTeX-Dokuments eingefügt werden, wobei die führenden Kommentarzeichen »%« entfernt werden. Auf diese Weise können Sie LaTeX-Pakete einbinden, beispielsweise "\usepackage{amsmath}". Hierfür gibt es kein globalen Vorgabewert.

  Verzeichnisweite fragmaster-Verzeichnissteuerdatei.
Sie können verzeichnisweite Optionen "fmclass:", "fmclassopt:", "fmopt:" und "head:/end head" durch eine verzeichnisweite Fragmaster-Steuerdatei fragmaster.dfm mit ähnlicher Syntax wie oben setzen. Sie können eine andere mit der Option --dirfm verwenden. Beachten Sie, dass so gesetzte Optionen paarweise ausschließend sind. Jede dateiabhängige _fm-Datei wird die zugeordneten Optionen in der verzeichnisweiten Datei komplett überschreiben und Optionen in verzeichnisweiten Dateien werden die anfänglichen Vorgaben ("\documentclass[12pt]{article}") überschreiben. Leere Optionen werden ignoriert.

Diese Funktionalität ist noch in Arbeit und benötigt umfassende Prüfungen. Überprüfen Sie zweimal, dass änderungsbasierte Neuerstellungen korrekt funktionieren.

BEKANNTE PROBLEME
Falls das EPS im Querformat erstellt wird, d.h. gv zeigt Querformat statt Hochformat in der Menüzeile an und die Graphik um 90° gedreht in Ihrem Dokument landet, dann ist es wahrscheinlich, dass Ihre ursprüngliche EPS breiter als hoch ist. In diesem Fall vermuten einige (neuere) Versionen von dvips »intelligent«, dass Ihre Graphik im Querformat vorliegt, obwohl die Proportionen der Graphik nichts über die Ausrichtung des Inhalts aussagen ... Das kann sogar passieren, wenn Ihre Eingabe-EPS eine Standard-Papiergröße hat.

Sie können auf jeden Fall ein netteres Verhalten von dvips erreichen, indem Sie die folgende Zeile in /usr/share/texmf/dvips/config/config.pdf (oder dem lokalen Äquivalent /usr/local/share/texmf) angeben:

@ custom 0pt 0pt

In dem wahrscheinlichen Fall, dass Sie sich nach dem Warum fragen, empfehle ich Ihnen wärmstens die Quellen von dvipsk ...

AUTOREN
Tilman Vogel <tilman vogel web de> (dot at dot) and Agustin Martin <agustin6martin gmail com> (at dot)

ÜBERSETZUNG
Diese Übersetzung wurde 2011-2014 von Helge Kreutzmann erstellt. Sie unterliegt der GNU GPL Version 2 (oder neuer).

Um die englische Originalversion zu lesen, geben Sie "man -L C fragmaster" ein.

Fehler in der Übersetzung melden Sie bitte über die Fehlerdatenbank (BTS) von Debian oder indem Sie eine E-Mail an <debian-l10-german@lists.debian.org>, schreiben.

GESCHICHTE
Dieses Skript wurde von einer Nachricht von Karsten Roemke <k roemke gmx de> (Punkt at Punkt) am 2003-11-11 um 05:25:44 PST in de.comp.text.tex mit dem Betreff »psfrag pdflatex, lange her« inspiriert.

Karsten Roemke wurde durch Nachrichten von Thomas Wimmer zu seiner Lösung inspiriert.

COPYRIGHT
 Copyright (C) 2004 Tilman Vogel
 Copyright (C) 2011-2023 Agustin Martin

Dieses Programm ist freie Software; Sie können es unter den Bedingungen der GNU General Public License, entweder Version 2 der Lizenz oder (wenn Sie es wünschen) jeder neueren Version, wie diese von der Free Software Foundation veröffentlicht wurden, vertreibend und/oder ändern.