Ubuntu Manpage: fragmaster - Psfrag-Konstrukte mit Pdflatex verwenden

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 ist ein LaTeX-Paket, das die Ersetzung von Textelementen in eingefügten EPS-
Graphiken durch beliebige LaTeX-Ausgabe erlaubt. Da psfrag PostScript für die Ersetzung
verwendet, können Sie prinzipiell psfrag nicht mit pdflatex verwenden, da dieses keine
Schnittstelle zu PostScript hat.

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-2015 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.