fragmaster (1) Linux Manual Page

NAME

fragmaster – Using psfrag constructs with pdflatex

SYNOPSIS

fragmaster[options] Create EPS and PDF files with embedded psfrag substitutions.Options : -h, --help Brief usage guide.- m, --man Show full man page(needs perldoc)-- clean Clean auto - generated $basename.{eps, pdf} files.--debug Show more info and leave temporary files behind.--force Rebuild everything ignoring modification times.--dirfm = file Use given file as optional per - directory fragmaster fm control file instead of default "fragmaster.dfm".

DESCRIPTION

fragmaster is a perl script that helps using psfrag constructs with pdflatex.

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 produces 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 can then be used with pdflatex.

fragmaster will scan the current directory for files which end in _fm and have a _fm.eps counterpart. Looking at the modification dates, the script checks if the output files have to be rebuilt 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 file extension. latex will choose the EPS, pdflatex will choose the PDF.

fragmaster control file and other related files.

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 _fm control file is basically a LaTeX file (with optionally special comments) and can look like this:

% Just an ordinary comment %

    % Some special comments : % fmclass : book % fmclassopt : 11pt % fmopt : width = 6cm %

                                                                                     % Another special comment : % head : %