.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "FRAGMASTER 1" .TH FRAGMASTER 1 "2020-12-28" "perl v5.32.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" fragmaster \- Psfrag\-Konstrukte mit Pdflatex verwenden .SH "ÜBERSICHT" .IX Header "ÜBERSICHT" .Vb 1 \& fragmaster [OPTIONEN] .Ve .PP \&\s-1EPS\-\s0 und PDF-Dateien mit eingebetteten Psfrag-Ersetzungen erstellen. .PP .Vb 9 \& 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. .Ve .SH "BESCHREIBUNG" .IX Header "BESCHREIBUNG" \&\fBfragmaster\fR ist ein Perl-Skript, das beim Einsatz von Psfrag-Konstrukten mit \fBpdflatex\fR hilft. .PP \&\fBpsfrag\fR is a LaTeX package which allows one to replace text elements in included \s-1EPS\s0 graphics by arbitrary LaTeX output. Because \fBpsfrag\fR uses PostScript for making the replacements, in principle you can't use \fBpsfrag\fR with \fBpdflatex\fR which doesn't have any interfaces to PostScript. .PP \&\fBfragmaster\fR erstellt eine neue \s-1EPS\s0 aus ihrer ursprünglichen \s-1EPS,\s0 welche bereits alle diese \fBpsfrag\fR\-Ersetzungen enthält. Diese neue EPS-Graphik kann dann in der Tat mit allen Ersetzungen in \s-1PDF\s0 gewandelt werden. Das so erstellte »eingekapselte« \s-1PDF\s0 kann dann mit Pdflatex verwandt werden. .PP \&\fBfragmaster\fR durchsucht das aktuelle Verzeichnis nach Dateien, die in \&\fI_fm\fR enden und ein \fI_fm.eps\fR 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). .PP Mittels folgendem Befehl fügen Sie die erstellte Graphik in Ihr LateX-Dokument ein: .PP .Vb 1 \& \eincludegraphics{} .Ve .PP Hierbei können Sie bequem die Endung entfallen lassen. \fBlatex\fR wird die EPS-Variante, \fBpdflatex\fR die PDF-Variante auswählen. .SS "\fBfragmaster\fPs Steuerdatei und andere verwandte Dateien" .IX Subsection "fragmasters Steuerdatei und andere verwandte Dateien" Um das Skript zu verwenden, müssen Sie zwei Dateien pro Graphik erstellen: .PP .Vb 2 \& * _fm.eps: die EPS\-Datei selbst \& * _fm: eine Fragmaster\-Steuerdatei .Ve .PP Aus diesen Dateien wird die Psfraggte-Graphik erstellt: .PP .Vb 2 \& * .eps, \& * .pdf .Ve .PP Die Steuerdatei von \fI_fm\fR ist im Prinzip eine LaTeX-Datei (mit optionalen besonderen Kommentaren). Sie kann wie folgt ausschauen: .PP .Vb 11 \& % Nur ein normaler Kommentar \& % \& % Einige besondere Kommentare: \& % fmclass: book \& % fmclassopt: 11pt \& % fmopt: width=6cm \& % \& % Ein weiterer besonderer Kommentar: \& % head: \& % \eusepackage{amsmath} \& % end head \& \& % psfrag\-Befehle: \& \epsfrag{x}{$x$} \& \epsfrag{y}{$y = x^2$} .Ve .PP Der besondere Kommentar \f(CW\*(C`fmclass:\*(C'\fR führt dazu, dass das Skript die angegebene Klasse statt der Standardklasse \f(CW\*(C`article\*(C'\fR benutzt. .PP Der besondere Kommentar \f(CW\*(C`fmclassopt:\*(C'\fR führt dazu, dass das Skript die angegebene Klassenoptionen statt des standardmäßigen \f(CW\*(C`12pt\*(C'\fR benutzt. .PP Der besondere Kommentar \f(CW\*(C`fmopt:\*(C'\fR wird so evaluiert, dass der folgende Text als optionales Argument an \f(CW\*(C`\eincludegraphics\*(C'\fR weitergegeben wird. Damit können Sie beispielsweise den Bezug zwischen Graphik\- und Schriftgröße mit Kommentaren der Art \f(CW\*(C`fmopt: width=6cm\*(C'\fR anpassen. Hierfür gibt es keine globale Voreinstellung. .PP Das besondere Kommentarkonstrukt \f(CW\*(C`head:/end head\*(C'\fR 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 \&\f(CW\*(C`\eusepackage{amsmath}\*(C'\fR. Hierfür gibt es kein globalen Vorgabewert. .SS "Verzeichnisweite \fBfragmaster\fP\-Verzeichnissteuerdatei." .IX Subsection "Verzeichnisweite fragmaster-Verzeichnissteuerdatei." Sie können verzeichnisweite Optionen \f(CW\*(C`fmclass:\*(C'\fR, \f(CW\*(C`fmclassopt:\*(C'\fR, \f(CW\*(C`fmopt:\*(C'\fR und \f(CW\*(C`head:/end head\*(C'\fR durch eine verzeichnisweite Fragmaster-Steuerdatei \&\fIfragmaster.dfm\fR mit ähnlicher Syntax wie oben setzen. Sie können eine andere mit der Option \fB\-\-dirfm\fR verwenden. Beachten Sie, dass so gesetzte Optionen paarweise ausschließend sind. Jede dateiabhängige \fI_fm\fR\-Datei wird die zugeordneten Optionen in der verzeichnisweiten Datei komplett überschreiben und Optionen in verzeichnisweiten Dateien werden die anfänglichen Vorgaben (\f(CW\*(C`\edocumentclass[12pt]{article}\*(C'\fR) überschreiben. Leere Optionen werden ignoriert. .PP Diese Funktionalität ist noch in Arbeit und benötigt umfassende Prüfungen. Überprüfen Sie zweimal, dass änderungsbasierte Neuerstellungen korrekt funktionieren. .SH "BEKANNTE PROBLEME" .IX Header "BEKANNTE PROBLEME" Falls das \s-1EPS\s0 im Querformat erstellt wird, d.h. \fBgv\fR zeigt \fIQuerformat\fR statt \fIHochformat\fR in der Menüzeile an und die Graphik um 90° gedreht in Ihrem Dokument landet, dann ist es wahrscheinlich, dass Ihre ursprüngliche \&\s-1EPS\s0 breiter als hoch ist. In diesem Fall vermuten einige (neuere) Versionen von \fBdvips\fR »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. .PP Sie können auf jeden Fall ein netteres Verhalten von \fBdvips\fR erreichen, indem Sie die folgende Zeile in \fI/usr/share/texmf/dvips/config/config.pdf\fR (oder dem lokalen Äquivalent \fI/usr/local/share/texmf\fR) angeben: .PP @ custom 0pt 0pt .PP In dem wahrscheinlichen Fall, dass Sie sich nach dem Warum fragen, empfehle ich Ihnen wärmstens die Quellen von \fBdvipsk\fR ... .SH "AUTOREN" .IX Header "AUTOREN" Tilman Vogel (dot at dot) and Agustin Martin (at dot) .SH "ÜBERSETZUNG" .IX Header "ÜBERSETZUNG" Diese Übersetzung wurde 2011\-2014 von Helge Kreutzmann erstellt. Sie unterliegt der \s-1GNU GPL\s0 Version 2 (oder neuer). .PP Um die englische Originalversion zu lesen, geben Sie \f(CW\*(C`man \-L C fragmaster\*(C'\fR ein. .PP Fehler in der Übersetzung melden Sie bitte über die Fehlerdatenbank (\s-1BTS\s0) von Debian oder indem Sie eine E\-Mail an <\fIdebian\-l10\-german@lists.debian.org\fR>, schreiben. .SH "GESCHICHTE" .IX Header "GESCHICHTE" Dieses Skript wurde von einer Nachricht von Karsten Roemke (Punkt at Punkt) am 2003\-11\-11 um 05:25:44 \s-1PST\s0 in de.comp.text.tex mit dem Betreff »psfrag pdflatex, lange her« inspiriert. .PP Karsten Roemke wurde durch Nachrichten von Thomas Wimmer zu seiner Lösung inspiriert. .SH "COPYRIGHT" .IX Header "COPYRIGHT" .Vb 2 \& Copyright (C) 2004 Tilman Vogel \& Copyright (C) 2011\-2015 Agustin Martin .Ve .PP Dieses Programm ist freie Software; Sie können es unter den Bedingungen der \&\s-1GNU\s0 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.