NOME

       fragmaster - Usando construções psfrag com o pdflatex

SINOPSE

        fragmaster [opções]

        Cria ficheiros EPS e PDF com substituições psfrag embebidas.

        Options:
         -h,--help          Guia breve de utilização.
         -m,--man           Mostra o manual completo (precisa do perldoc)
         --clean            Limpa ficheiros $basename.{eps,pdf} auto-gerados.
         --debug            Mostra mais informação e deixa para trás ficheiros
                            temporários.
         --force            Reconstrói tudo ignorando os tempos de modificação.
         --dirfm=file       Usa o ficheiro fornecido como ficheiro de controle
                            fm do fragmaster por directório em vez do predefinido
                            "fragmaster.dfm".

DESCRIÇÃO

       fragmaster é um script perl que ajuda a usar construções psfrag com pdflatex.

       psfrag é um pacote LaTeX que permite substituir elementos de texto em gráficos EPS
       incluídos por resultados LaTeX arbitrários: Porque o psfrag usa PostScript para fazer as
       substituições, em princípio você não pode usar o psfrag com o pdflatex o qual não tem
       nenhuma interface para o PostScript.

       fragmaster produz um novo EPS a partir do seu EPS original que já contém todas as
       substituições psfrag. Este novo gráfico EPS pode mesmo ser convertido para PDF incluindo
       todas as substituições. O PDF "encapsulado" resultante pode então ser usado com o
       pdflatex.

       fragmaster irá sondar o directório actual por ficheiros que terminem em _fm e têm uma
       parte _fm.eps. Observando as datas de modificação, o script verifica se os ficheiros
       resultantes têm de ser re-construídos e fá-lo se necessário (um pouco como o "make"
       faria).

       Você pode incluir os gráficos produzidos no seu documento LaTeX usando

        \includegraphics{<gráficos>}

       omitindo convenientemente a extensão do ficheiro. latex irá escolher o EPS. pdflatex irá
       escolher o PDF.

   Ficheiro de control do fragmaster e outros ficheiros relacionados.
       Para usar o script você tem de criar dois ficheiros por cada gráfico:

           * <graphics>_fm.eps: o próprio ficheiro EPS,
           * <graphics>_fm: um ficheiro de controle do fragmaster.

       A partir desses ficheiros serão criados os gráficos psfrag:

           * <graphics>.eps,
           * <graphics>.pdf

       O ficheiro de controle _fm é basicamente um ficheiro LaTeX (com comentários especiais
       opcionais) e pode-se parecer com isto:

        % Apenas um comentário normal
        %
        % Alguns comentários especiais:
        % fmclass: book
        % fmclassopt: 11pt
        % fmopt: width=6cm
        %
        % Outro comentário especial:
        % head:
        % \usepackage{amsmath}
        % end head

        % comandos do psfrag:
        \psfrag{x}{$x$}
        \psfrag{y}{$y = x^2$}

       O comentário especial "fmclass:" irá fazer o script usar a classe fornecida em vez da
       classe predefinida "article".

       O comentário especial "fmclassopt:" irá fazer o script usar as opções fornecidas como
       opções de classe em vez da predefinição "12pt".

       O comentário especial "fmopt:" irá ser avaliado de modo a que o texto que o segue será
       passado como argumento opcional para "\includegraphics". Deste modo você pode, por
       exemplo, ajustar a relação entre o tamanho dos gráficos e o tamanho da letra usando algo
       como "fmopt: width=6cm". Não há nenhuma predefinição global para isto.

       A construção do comentário especial "head:/end head" faz com que as linhas no meio sejam
       incluídas no prefácio do documento temporário LaTeX após ter os caracteres iniciais do
       comentário "%" removidos. Deste modo você pode incluir pacotes LaTeX, como em
       "\usepackage{amsmath}". Não há nenhuma predefinição global para isto.

   Ficheiro de controle dir do fragmaster por directório.
       você pode definir "fmclass:", "fmclassopt:", "fmopt:" por directório e opções "head:/end
       head" por meio de um ficheiro de controle de fragmaster por directório fragmaster.dfm com
       sintaxe semelhante como em cima. Você pode usar outro ficheiro por meio da opção --dirfm.
       Note que as opções definidas desta maneira são mutuamente exclusivas, qualquer opção
       definida ficheiro _fm por ficheiro irá sobrepor completamente a opção associada em
       ficheiro por directório, e as opções definidas por ficheiro por directório irão sobrepor
       as predefinições iniciais ("\documentclass[12pt]{article}"). As opções vazias são
       ignoradas.

       Isto ainda é trabalho em progresso e ainda precisa de verificação extensiva. Certifique-se
       que as recompilações baseadas na data de modificação estão a funcionar correctamente.

PROBLEMAS CONHECIDOS

       No caso do EPS ser produzido como gráficos de paisagem, isto é, gv mostra Landscape em vez
       de Portrait na barra de menu, e o gráfico irá acabar rodado cerca de 90 graus no seu
       documento, então é provável que o seu EPS original tenha mais largura do que altura. Neste
       caso algumas versões (mais recentes) do dvips fazem a suposição "inteligente" que o seu
       gráfico é paisagem, mesmo que as proporções do gráfico nada digam acerca da orientação do
       seu conteúdo... Isto ainda pode acontecer no caso do seu EPS fornecido corresponda a um
       tamanho standard de papel.

       De qualquer modo, você pode fazer o dvips comportar-se melhor ao especificar a seguinte
       linha em /usr/share/texmf/dvips/config/config.pdf (ou equivalente local dentro de
       /usr/local/share/texmf):

       @ custom 0pt 0pt

       No caso provável de você estar a imaginar porquê, eu recomendaria calorosamente as fontes
       dvipsk para si...

AUTORES

       Tilman Vogel <tilman vogel web de> (dot at dot) e Agustin Martin <agustin martin
       hispalinux es> (dot at dot)

HISTÓRIA

       Este script foi inspirado por uma mensagem publicada por Karsten Roemke <k roemke gmx de>
       (ponto at ponto) com assunto "psfrag pdflatex, lange her" em de.comp.text.tex em
       2003-11-11 05:25:44 PST.

       Karsten Roemke foi inspirado para este solução por mensagens publicadas por Thomas Wimmer.

COPYRIGHT

        Copyright (C) 2004 Tilman Vogel
        Copyright (C) 2011-2014 Agustin Martin

       Este programa é software livre, você pode redistribuí-lo e/ou modificá-lo sob os termos da
       GNU General Public License como publicada pela Free Software Foundation; na versão 2 da
       licença, ou (por sua opção) qualquer versão posterior.