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.

perl v5.38.2                                       2024-06-17                                      FRAGMASTER(1)