summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/fragmaster/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/support/fragmaster/README')
-rw-r--r--Master/texmf-dist/doc/support/fragmaster/README154
1 files changed, 154 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/support/fragmaster/README b/Master/texmf-dist/doc/support/fragmaster/README
new file mode 100644
index 00000000000..e6e4b9ab2f3
--- /dev/null
+++ b/Master/texmf-dist/doc/support/fragmaster/README
@@ -0,0 +1,154 @@
+======================================================================
+Using psfrag with pdflatex
+======================================================================
+
+German version: README.de
+
+psfrag is a LaTeX package which allows to replace text elements in
+included EPS graphics by arbitrary LaTeX output. E.g. you can make fonts
+in your graphics match your document fonts or even include mathematical
+formulae in your graphics. For example:
+
+\psfrag{x}{$x$}
+\psfrag{y}{$y = x^2$}
+\includegraphics{diagram}
+
+When using latex (not pdflatex) the file diagram.eps will be included.
+The extension is appended automatically. While doing this, every
+occurrence of "x" in the diagram is replaced by "x" using math font and
+every "y" is replaced by the LaTeX formula "y = x^2". Partial strings
+are not replaced, only completely matching strings.
+
+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.
+
+The basic idea around the problem is the following:
+
+Produce a new EPS from your original EPS which already contains all
+those psfrag replacements. This new EPS graphic actually can be
+converted to PDF including all replacements. The resulting
+"encapsulated" PDF then can be used with pdflatex.
+
+To make such an EPS which already contains the replacements, it is
+necessary to create a separate LaTeX document for every EPS file you
+use. To simplify that task, I wrote the included fragmaster.pl perl
+script.
+
+This script needs: perl, latex, dvips and the common EPS to PDF
+converter script epstopdf.
+
+To use the script you have to create two files per graphic:
+
+ * <graphics>_fm.eps: the EPS file itself,
+ * <graphics>_fm: a fragmaster control file.
+
+From these files the psfragged graphics will be created:
+
+ * <graphics>.eps,
+ * <graphics>.pdf
+
+The control file is basically a LaTeX file (with optionally special
+comments) and can look like this:
+
+% Just an ordinary comment
+%
+% A special comment:
+% fmopt: width=6cm
+%
+% Another special comment:
+% head:
+% \usepackage{amsmath}
+% end head
+
+% psfrag commands:
+\psfrag{x}{$x$}
+\psfrag{y}{$y = x^2$}
+
+
+The special comment fmopt: will be evaluated such that the following
+text will by passed as optional argument to \includegraphics. This way
+you can e.g. adjust the relation between graphics size and font size
+using something like width=6cm.
+
+The special comment construct "head:"/"end head" causes the lines in
+between to be included in the preamble of the LaTeX temporary document
+after having the leading comment characters "%" stripped off. This way,
+you can include LaTeX packages.
+
+fragmaster.pl will scan the current directory for files which end in _fm
+and their _fm.eps counterparts. Looking at the modification dates, the
+script checks if the output files have to be remade and does so if
+necessary (a little like "make" would do it).
+
+In your LaTeX document you can include the produced graphics using
+
+\includegraphics{<graphics>}
+
+
+conveniently omitting the file extension. latex will choose the EPS,
+pdflatex will choose the PDF.
+
+======================================================================
+Example
+======================================================================
+The following example files are included:
+
+ * parabel_fm.gp
+ gnuplot file to create the following EPS graphics,
+ * parabel_fm.eps
+ raw EPS without psfrag replacements,
+ * parabel_fm
+ fragmaster file with the psfrag commands,
+ * parabel.eps
+ the produced EPS graphics,
+ * parabel.pdf
+ the produced PDF graphics,
+ * document.tex
+ LaTeX example including the graphics,
+ * document.pdf
+ example PDF,
+ * document.ps
+ example PS,
+ * parabel_fm.pdf
+ PDF version of the raw EPS graphics (only necessary for the
+ example!).
+
+
+======================================================================
+Problems and solutions
+======================================================================
+
+In case the EPS will be produced as landscape graphics, i.e. gv shows
+"Landscape" instead of "Portrait" in the menu bar, and the graphic will
+end up turned around 90° in your document, then it is likely that your
+original EPS is wider than it is tall. In this case some (more recent)
+versions of dvips make the "smart" assumption that your graphic is
+landscape, even though the graphic's proportions don't tell anything
+about the orientation of its contents... Anyway, you can make dvips
+behave nicer by specifying the following line in
+
+/usr/share/texmf/dvips/config/config.pdf
+
+(or a local equivalent inside /usr/local/share/texmf):
+
+@ custom 0pt 0pt
+
+
+In the likely case that you're wondering why, I'd recommend the dvipsk
+sources warmly to you...
+
+Have fun with the script! Feedback is very much appreciated.
+
+Tilman Vogel <tilman vogel web de> (fill in: dot at dot)
+
+
+======================================================================
+Pointers to other solutions
+======================================================================
+
+ * Pdfrack <http://www.enseeiht.fr/~boyer/Pdfrack/>
+ * unpsfrag <http://www.gts.tsc.uvigo.es/~fiz/unpsfrag>
+
+
+Last modified: Thu Mar 19 20:52:45 CET 2009