Uma página de PDF como imagem

includegraphics com seleção de página e pdfpages para apêndices.

Uma página de PDF como imagem

O PDF é o melhor formato de figura que o LaTeX consegue usar. Ao contrário de PNG ou JPG, um PDF guarda dados vetoriais, de modo que linhas e rótulos continuam nítidos em qualquer nível de zoom e as fontes dentro dele viajam com o arquivo. Ferramentas como Matplotlib, Inkscape e draw.io exportam PDF, o que significa que o diagrama que você desenhou em outro lugar pode entrar direto no seu documento. Mas os PDFs trazem um detalhe que as imagens não têm: um PDF pode conter muitas páginas, e você precisa dizer ao LaTeX qual delas quer.

Extraindo uma página de um PDF com várias páginas

O \includegraphics do pacote graphicx aceita uma opção page ao lado das chaves de dimensionamento habituais:

\includegraphics[page=1,width=\textwidth]{diagram.pdf}

Aqui page=1 seleciona a primeira página de diagram.pdf, e width=\textwidth ajusta essa página à largura total do bloco de texto. Se você omitir page, o LaTeX usa a página um sem avisar, o que costuma ser o que você quer, mas pode surpreender quando um script de gráficos grava várias figuras em um único arquivo. Você pode incluir o mesmo PDF várias vezes com valores diferentes de page, uma vez por ambiente de figura, cada uma com a própria legenda e o próprio rótulo.

Envolva o comando em um ambiente figure normal para que ele ganhe uma legenda e um número, exatamente como você faria com qualquer outra imagem. A página incluída é recortada pela própria caixa delimitadora, então, se o seu PDF de origem tem margens generosas, a figura vai parecer ter folga demais. Exporte de novo com uma caixa delimitadora justa, ou recorte uma vez com uma ferramenta como o pdfcrop, em vez de brigar com o espaço em branco usando espaçamento negativo.

Inserindo documentos inteiros com pdfpages

Às vezes você não quer uma figura. Quer páginas inteiras, tal como estão, inseridas no seu documento: um PDF suplementar, um formulário assinado, um questionário publicado no apêndice de uma tese. Esse é o trabalho do pacote pdfpages:

\usepackage{pdfpages}
\includepdf[pages=-]{supplement.pdf}

O valor pages=- significa todas as páginas. Você também pode escrever pages=2-5 para um intervalo ou pages={1,3,7} para uma lista específica. Cada página inserida ocupa uma página inteira da saída, mantém o layout original e entra na numeração de páginas do seu documento, de modo que o apêndice se lê de forma contínua. Acrescente a opção pagecommand={} se os cabeçalhos ou rodapés da classe do seu documento estiverem sendo impressos por cima das páginas inseridas e você quiser suprimi-los ou personalizá-los.

Qual ferramenta para qual tarefa

Use \includegraphics[page=...] quando o conteúdo do PDF deve se comportar como uma figura, ou seja, flutuar, ter legenda e ser referenciado a partir do texto. Use \includepdf quando as páginas devem valer por si mesmas, em tamanho total. O erro comum é usar pdfpages para um diagrama, o que lhe dá uma página inteira sem legenda e sem referência, que você não consegue citar com \ref. Se os leitores algum dia verem “veja a Figura 3”, o conteúdo pertence a um ambiente de figura.

Voltar para Cirurgia de flutuantes