Links dentro do PDF

hyperref, url, href, cores e metadados do PDF.

Links dentro do PDF

Um PDF não é só papel numa tela. Ele pode carregar links ativos: URLs clicáveis, referências cruzadas que levam à figura certa, citações que levam à bibliografia e um painel lateral de estrutura montado a partir dos títulos das suas seções. No LaTeX, um único pacote oferece tudo isso: o hyperref. Carregue-o e todo \ref, todo \cite e toda entrada do sumário do seu documento passam discretamente a ser clicáveis, sem nenhuma mudança no resto do código-fonte.

Carregando e configurando o hyperref

\usepackage[colorlinks=true,linkcolor=blue,citecolor=blue,urlcolor=blue]{hyperref}
\url{https://oleafly.com}
\href{https://oleafly.com}{Oleafly}
\hypersetup{pdftitle={My Paper}, pdfauthor={You}}

As opções entre colchetes controlam a aparência dos links. Por padrão, o hyperref desenha um retângulo colorido em volta de cada link, o que a maioria das pessoas acha feio. Definir colorlinks=true troca as caixas por texto colorido, e as três opções de cor dividem isso por tipo de link: linkcolor cobre os saltos internos, como as referências a seções e figuras, citecolor cobre as citações e urlcolor cobre os endereços da web. Separá-las faz diferença porque um artigo cheio de citações pode, de outro modo, virar uma parede azul.

url versus href

Os dois comandos de link fazem trabalhos diferentes. \url{...} imprime o próprio endereço em fonte de máquina de escrever e o torna clicável, que é o que você quer em uma bibliografia ou em uma nota de rodapé, onde o leitor deve ver para onde o link leva. \href{address}{text} esconde o endereço atrás do texto que você fornecer, como um link numa página da web. Prefira \url em documentos que podem ser impressos, já que o texto de um \href não dá ao leitor da versão impressa nenhum jeito de digitar o endereço.

Um bônus prático: o \url sabe quebrar endereços longos em várias linhas sem inserir um hífen que corromperia o endereço, algo que uma URL comum em fonte de máquina de escrever não consegue fazer.

Metadados do PDF

O \hypersetup permite alterar qualquer opção do hyperref depois de carregá-lo, e também é onde você define os metadados do documento. Os campos pdftitle e pdfauthor preenchem o título e o autor que o seu leitor de PDF mostra na barra da janela e nas propriedades do arquivo. Sem eles, os leitores costumam exibir o nome do arquivo ou o primeiro título, o que parece descuido em um documento que você vai submeter ou compartilhar. Você pode chamar o \hypersetup no preâmbulo a qualquer momento depois de \usepackage{hyperref}.

Para documentos pensados para impressão, use hidelinks. Passá-lo como opção, \usepackage[hidelinks]{hyperref}, mantém todos os links clicáveis na tela, mas remove tanto as caixas coloridas quanto o texto colorido, de modo que a página impressa fica com aparência totalmente normal. Muitas classes de periódicos exigem exatamente isso.

Um erro comum a evitar: o hyperref redefine muitos comandos internos, então ele deve ser carregado como um dos últimos pacotes do seu preâmbulo. Se os seus links apontam para as páginas erradas ou se você recebe erros estranhos de outro pacote, a ordem de carregamento é a primeira coisa a conferir. Veja referências cruzadas para entender o funcionamento de \label e \ref, que o hyperref torna clicáveis.

Voltar para O esqueleto do artigo