.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" 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 "2023-01-30" "perl v5.36.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 "NOME" .IX Header "NOME" fragmaster \- Usando construções psfrag com o pdflatex .SH "SINOPSE" .IX Header "SINOPSE" .Vb 1 \& 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". .Ve .SH "DESCRIÇÃO" .IX Header "DESCRIÇÃO" \&\fBfragmaster\fR é um script perl que ajuda a usar construções psfrag com \fBpdflatex\fR. .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 produz um novo \s-1EPS\s0 a partir do seu \s-1EPS\s0 original que já contém todas as substituições \fBpsfrag\fR. Este novo gráfico \s-1EPS\s0 pode mesmo ser convertido para \s-1PDF\s0 incluindo todas as substituições. O \s-1PDF\s0 \*(L"encapsulado\*(R" resultante pode então ser usado com o pdflatex. .PP \&\fBfragmaster\fR irá sondar o directório actual por ficheiros que terminem em \fI_fm\fR e têm uma parte \fI_fm.eps\fR. 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 \*(L"make\*(R" faria). .PP Você pode incluir os gráficos produzidos no seu documento LaTeX usando .PP .Vb 1 \& \eincludegraphics{} .Ve .PP omitindo convenientemente a extensão do ficheiro. \fBlatex\fR irá escolher o \s-1EPS.\s0 \fBpdflatex\fR irá escolher o \s-1PDF.\s0 .SS "Ficheiro de control do \fBfragmaster\fP e outros ficheiros relacionados." .IX Subsection "Ficheiro de control do fragmaster e outros ficheiros relacionados." Para usar o script você tem de criar dois ficheiros por cada gráfico: .PP .Vb 2 \& * _fm.eps: o próprio ficheiro EPS, \& * _fm: um ficheiro de controle do fragmaster. .Ve .PP A partir desses ficheiros serão criados os gráficos psfrag: .PP .Vb 2 \& * .eps, \& * .pdf .Ve .PP O ficheiro de controle \fI_fm\fR é basicamente um ficheiro LaTeX (com comentários especiais opcionais) e pode-se parecer com isto: .PP .Vb 11 \& % Apenas um comentário normal \& % \& % Alguns comentários especiais: \& % fmclass: book \& % fmclassopt: 11pt \& % fmopt: width=6cm \& % \& % Outro comentário especial: \& % head: \& % \eusepackage{amsmath} \& % end head \& \& % comandos do psfrag: \& \epsfrag{x}{$x$} \& \epsfrag{y}{$y = x^2$} .Ve .PP O comentário especial \f(CW\*(C`fmclass:\*(C'\fR irá fazer o script usar a classe fornecida em vez da classe predefinida \f(CW\*(C`article\*(C'\fR. .PP O comentário especial \f(CW\*(C`fmclassopt:\*(C'\fR irá fazer o script usar as opções fornecidas como opções de classe em vez da predefinição \f(CW\*(C`12pt\*(C'\fR. .PP O comentário especial \f(CW\*(C`fmopt:\*(C'\fR irá ser avaliado de modo a que o texto que o segue será passado como argumento opcional para \f(CW\*(C`\eincludegraphics\*(C'\fR. Deste modo você pode, por exemplo, ajustar a relação entre o tamanho dos gráficos e o tamanho da letra usando algo como \f(CW\*(C`fmopt: width=6cm\*(C'\fR. Não há nenhuma predefinição global para isto. .PP A construção do comentário especial \f(CW\*(C`head:/end head\*(C'\fR 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 \*(L"%\*(R" removidos. Deste modo você pode incluir pacotes LaTeX, como em \f(CW\*(C`\eusepackage{amsmath}\*(C'\fR. Não há nenhuma predefinição global para isto. .SS "Ficheiro de controle dir do \fBfragmaster\fP por directório." .IX Subsection "Ficheiro de controle dir do fragmaster por directório." você pode definir \f(CW\*(C`fmclass:\*(C'\fR, \f(CW\*(C`fmclassopt:\*(C'\fR, \f(CW\*(C`fmopt:\*(C'\fR por directório e opções \f(CW\*(C`head:/end head\*(C'\fR por meio de um ficheiro de controle de fragmaster por directório \fIfragmaster.dfm\fR com sintaxe semelhante como em cima. Você pode usar outro ficheiro por meio da opção \fB\-\-dirfm\fR. Note que as opções definidas desta maneira são mutuamente exclusivas, qualquer opção definida ficheiro \fI_fm\fR 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 (\f(CW\*(C`\edocumentclass[12pt]{article}\*(C'\fR). As opções vazias são ignoradas. .PP 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. .SH "PROBLEMAS CONHECIDOS" .IX Header "PROBLEMAS CONHECIDOS" No caso do \s-1EPS\s0 ser produzido como gráficos de paisagem, isto é, \fBgv\fR mostra \fILandscape\fR em vez de \fIPortrait\fR 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 \s-1EPS\s0 original tenha mais largura do que altura. Neste caso algumas versões (mais recentes) do \fBdvips\fR fazem a suposição \*(L"inteligente\*(R" 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 \s-1EPS\s0 fornecido corresponda a um tamanho standard de papel. .PP De qualquer modo, você pode fazer o \fBdvips\fR comportar-se melhor ao especificar a seguinte linha em \fI/usr/share/texmf/dvips/config/config.pdf\fR (ou equivalente local dentro de \fI/usr/local/share/texmf\fR): .PP @ custom 0pt 0pt .PP No caso provável de você estar a imaginar porquê, eu recomendaria calorosamente as fontes \fBdvipsk\fR para si... .SH "AUTORES" .IX Header "AUTORES" Tilman Vogel (dot at dot) and Agustin Martin (at dot) .SH "HISTÓRIA" .IX Header "HISTÓRIA" Este script foi inspirado por uma mensagem publicada por Karsten Roemke (ponto at ponto) com assunto \*(L"psfrag pdflatex, lange her\*(R" em de.comp.text.tex em 2003\-11\-11 05:25:44 \s-1PST.\s0 .PP Karsten Roemke foi inspirado para este solução por mensagens publicadas por Thomas Wimmer. .SH "COPYRIGHT" .IX Header "COPYRIGHT" .Vb 2 \& Copyright (C) 2004 Tilman Vogel \& Copyright (C) 2011\-2015 Agustin Martin .Ve .PP Este programa é software livre, você pode redistribuí\-lo e/ou modificá\-lo sob os termos da \s-1GNU\s0 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.