> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/overleaf-learn-latex-pt/estrutura-do-documento/09-hyperlinks.md). # Hiperlinks LaTeX é uma ótima ferramenta para documentos imprimíveis com aspeto profissional, mas também pode ser usada para gerar ficheiros PDF com excelentes ferramentas de navegação. Este artigo descreve como criar hiperligações no seu documento e como configurar documentos LaTeX para serem vistos com um leitor de PDF. ## Introdução Vamos começar com um exemplo mínimo funcional, simplesmente importando o **hyperref** pacote todo [elementos referenciados cruzadamente](/latex/overleaf-learn-latex-pt/estrutura-do-documento/03-cross-referencing-sections-equations-and-floats.md) tornam-se hiperligações. ```latex \documentclass{book} \usepackage{blindtext} \usepackage{hyperref} \title{Exemplo de Hiperligações} \author{Overleaf} \begin{document} \frontmatter \tableofcontents \clearpage \addcontentsline{toc}{chapter}{Foreword} {\huge {\bf Prefácio}} \Blindtext \clearpage \addcontentsline{toc}{chapter}{Entrada fictícia} {\huge {\bf Entrada fictícia}} \Blindtext \mainmatter \chapter{First Chapter} Este será um capítulo vazio \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} A equação \ref{eq:1} mostra uma soma divergente. Esta fórmula será usada mais tarde na página \pageref{second}. \Blindtext \clearpage \section{Segunda secção} \label{second} \blindtext \Blinddocument \end{document} ``` [Abra este `hyperref` exemplo no Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+hyperref+example\&snip=%5Cdocumentclass%7Bbook%7D%0A%5Cusepackage%7Bblindtext%7D%0A%5Cusepackage%7Bhyperref%7D%0A%0A%5Ctitle%7BExample+of+Hyperlinks%7D%0A%5Cauthor%7BOverleaf%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cfrontmatter%0A%5Ctableofcontents%0A%5Cclearpage%0A%0A%5Caddcontentsline%7Btoc%7D%7Bchapter%7D%7BForeword%7D%0A%7B%5Chuge+%7B%5Cbf+Foreword%7D%7D%0A%0A%5CBlindtext%0A%5Cclearpage%0A%0A%5Caddcontentsline%7Btoc%7D%7Bchapter%7D%7BDummy+entry%7D%0A%7B%5Chuge+%7B%5Cbf+Dummy+entry%7D%7D%0A%0A%5CBlindtext%0A%5Cmainmatter%0A%0A%5Cchapter%7BFirst+Chapter%7D%0A%0AThis+will+be+an+empty+chapter%0A%0A%5Cbegin%7Bequation%7D%0A%5Clabel%7Beq%3A1%7D%0A%5Csum_%7Bi%3D0%7D%5E%7B%5Cinfty%7D+a_i+x%5Ei%0A%5Cend%7Bequation%7D%0A%0AThe+equation+%5Cref%7Beq%3A1%7D+shows+a+sum+that+is+divergent.+This+formula+will+be+used+later+on+page+%5Cpageref%7Bsecond%7D.%0A%0A%5CBlindtext%0A%5Cclearpage%0A%0A%5Csection%7BSecond+section%7D+%5Clabel%7Bsecond%7D%0A%0A%5Cblindtext%0A%5CBlinddocument%0A%5Cend%7Bdocument%7D) ![Documento de exemplo do hyperref](/files/d3a56b6e1ee7179259171047992557cb317ffc5f) As linhas no índice tornam-se ligações para as páginas correspondentes no documento simplesmente adicionando no preâmbulo do documento a linha ```latex \usepackage{hyperref} ``` É preciso ter cuidado ao importar `hyperref`: normalmente, tem de ser o último pacote a ser importado — mas podem existir algumas exceções a esta regra. ## Estilos e cores A formatação predefinida das hiperligações pode ser alterada para que a informação nos seus documentos seja apresentada com maior clareza. Abaixo pode ver um exemplo: ```latex \documentclass{book} \usepackage{hyperref} \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Exemplo do Overleaf}, pdfpagemode=FullScreen, } \urlstyle{same} \begin{document} \tableofcontents \chapter{First Chapter} Este será um capítulo vazio e eu colocarei algum texto aqui \begin{equation} \label{eq:1} \sum_{i=0}^{\infty} a_i x^i \end{equation} A equação \ref{eq:1} mostra uma soma divergente. Esta fórmula será usada mais tarde na página \pageref{second}. Para mais referências, veja \href{http://www.overleaf.com}{Alguma Ligação} ou vá para o próximo URL: \url{http://www.overleaf.com} ou abra o próximo ficheiro \href{run:./file.txt}{Ficheiro.txt} Também é possível ligar diretamente qualquer palavra ou \hyperlink{thesentence}{qualquer frase} no seu documento. \end{document} ``` [Abra um exemplo do `hyperref` pacote no Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Another+hyperref+example\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ![HyperrefEx2OverleafVa.png](/files/e97803bfa5a03a6d1b8200efc12439664a097a91) ![HyperrefEx2OverleafVb.png](/files/56b98f46ac692d193d9194f16f64901e43dc1fe8) Este é um exemplo completo, que será totalmente explicado no resto do artigo. Abaixo segue uma descrição dos comandos relacionados com a cor e o estilo das hiperligações. **\hypersetup{ ... }** Isto definirá as opções para configurar o comportamento das hiperligações no documento. Cada parâmetro deve ser separado por vírgulas e a sintaxe deve estar no formato parâmetro=valor. **colorlinks=true** As hiperligações serão coloridas; a cor predefinida é vermelho. **linkcolor=blue** As ligações internas, aquelas geradas por elementos referenciados cruzadamente, são apresentadas em azul. **filecolor=magenta** As ligações para ficheiros locais serão mostradas na cor magenta (ver ligação de ficheiros locais). **urlcolor=cyan** As ligações para sítios Web são definidas na cor ciano (ver ligação de endereços Web). **urlstyle{same}** As definições predefinidas imprimem as hiperligações em fontes monoespaçadas, este comando altera isso e apresenta as hiperligações no mesmo estilo do restante texto. ## Ligar endereços Web Ligações para um endereço Web ou e-mail podem ser adicionadas a um ficheiro LaTeX usando o `\url` comando para mostrar a própria ligação ou `\href` para usar uma ligação oculta e mostrar em vez disso uma palavra/frase. ```latex Para mais referências, veja \href{http://www.overleaf.com}{Alguma Ligação} ou vá para o próximo URL: \url{http://www.overleaf.com} ``` ![HyperlinkExampleUpdatedMore.png](/files/6303136e16155f4873b67f966c73ef3c322d936d) Existem dois comandos no exemplo que geram uma ligação no documento final: **\href{ Ligação}** São passados dois parâmetros para este comando, o primeiro é o URL para a ligação, neste caso, e o segundo é o texto clicável a ser mostrado, Alguma Ligação. **\url{** Este comando mostrará o URL passado como parâmetro e transformá-lo-á numa ligação, útil se pretender imprimir o documento. [Abrir um exemplo do pacote hyperref no Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Ligar ficheiros locais Os comandos `\href` e `\url` apresentado na secção anterior pode ser usado para abrir ficheiros locais ```latex Para mais referências, veja \href{http://www.overleaf.com}{Alguma Ligação} ou vá para o próximo URL: \url{http://www.overleaf.com} ou abra o próximo ficheiro \href{run:./file.txt}{Ficheiro.txt} ``` ![HyperlinkExampleUpdatedMoreNext.png](/files/aa398099f8de66338a561ead5b7006760701f99d) O comando `\href{run:./file.txt}{Ficheiro.txt}` imprime o texto `Ficheiro.txt` que liga para um ficheiro local chamado `file.txt` localizado no diretório de trabalho atual. Note o texto `run:` antes do caminho para o ficheiro. O caminho do ficheiro segue as convenções dos sistemas UNIX, usando `.` para se referir ao diretório atual e `..` para o diretório anterior. O comando `\url{}` também pode ser usado, com a mesma sintaxe descrita para o caminho, mas há relatos de que apresenta alguns problemas. [Abrir um exemplo do pacote hyperref no Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Inserir hiperligações manualmente Foi mencionado anteriormente que todos os elementos referenciados cruzadamente tornam-se ligações assim que **hyperref** é importado, assim podemos usar `\label` em qualquer parte do documento e depois referenciar esses rótulos para criar hiperligações. Esta não é a única maneira de inserir hiperligações manualmente. ```latex Também é possível ligar diretamente qualquer palavra ou \hyperlink{thesentence}{qualquer frase} no seu documento. Se ler este texto, não obterá nenhuma informação. A sério? Não há informação? Por exemplo \hypertarget{thesentence}{esta frase}. ``` ![HyperlinkExampleUpdatedMoreNextAgain.png](/files/1f8f930c071f7e442b7567d8ba9ed2b45ffb83ed) Existem dois comandos para criar ligações definidas pelo utilizador. **\hypertarget{thesentence}{esta frase}** O primeiro parâmetro passado entre chavetas a este comando é um identificador único para esta frase. O segundo parâmetro é o texto "esta frase" e será impresso normalmente (dependendo do valor de anchorcolor, ver o guia de referência), mas quando é clicada uma ligação que aponta para o identificador "thesentence", o ficheiro PDF deslocar-se-á para este ponto. **\hyperlink{thesentence}{qualquer frase}** Este comando imprime o texto "qualquer frase" como um elemento clicável que redireciona para o ponto cujo identificador é "thesentence". [Abrir um exemplo do pacote hyperref no Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=\&mainFile=main.tex) ## Opções específicas de PDF As ligações num documento são criadas tendo em mente um documento que será lido em formato PDF. O ficheiro PDF pode ser ainda mais personalizado para adicionar informação adicional e alterar a forma como o visualizador de PDF o apresenta. Abaixo um exemplo: ```latex \hypersetup{ colorlinks=true, linkcolor=blue, filecolor=magenta, urlcolor=cyan, pdftitle={Exemplo do Overleaf}, pdfpagemode=FullScreen, } ``` ![Pdftitle.png](/files/2d068787ceacf974df92d1fcf05ad45f044a3462) Usando o comando `\hypersetup`, descrito na secção [estilos e cores](#styles-and-colours), aceita parâmetros extra para configurar o ficheiro PDF final. **pdftitle={Exemplo do Overleaf}** É o título do ficheiro de saída PDF, a ser apresentado na barra de título da janela. No exemplo é "Exemplo do Overleaf". **pdfpagemode=FullScreen** O documento será aberto em modo de ecrã completo pelo leitor de PDF. Veja o [guia de referência](#reference-guide) para uma lista completa de opções que podem ser passadas para `\hypersetup`. [Abrir um exemplo do pacote hyperref no Overleaf](https://www.overleaf.com/project/new/template/19606?id=64789057\&templateName=Hyperref+Example+2\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=main.tex) ## Guia de referência **Opções de estilo das hiperligações** | Opção | Valor predefinido | Descrição | | ------------- | ----------------- | --------------------------------------------------------------------------------------- | | `hyperindex` | verdadeiro | Torna os números de página das entradas do índice em hiperligações | | `linktocpage` | falso | Faz com que, no Índice, os números de página sejam ligações em vez do texto. | | `breaklinks` | falso | Permite que as hiperligações sejam quebradas em várias linhas. | | `colorlinks` | falso | Colore o texto das hiperligações e dos alvos; estas cores aparecerão na versão impressa | | `linkcolor` | vermelho | Cor para hiperligações internas normais | | `anchorcolor` | preto | Cor para o texto âncora (alvo) | | `citecolor` | verde | Cor para citações bibliográficas | | `filecolor` | ciano | Cor para ligações que abrem ficheiros locais | | `urlcolor` | magenta | Cor para URLs ligados | | `frenchlinks` | falso | Usa versaletes em vez de cores para as hiperligações | **Opções específicas de PDF** | Opção | Valor predefinido | Descrição | | ----------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------ | | `bookmarks` | verdadeiro | São escritos marcadores do Acrobat, semelhantes ao índice. | | `bookmarksopen` | falso | Os marcadores são mostrados com todas as subárvores expandidas. | | `citebordercolor` | 0 1 0 | Cor da caixa à volta das citações em formato RGB. | | `filebordercolor` | 0 .5 .5 | Cor da caixa à volta das ligações para ficheiros em formato RGB. | | `linkbordercolor` | 1 0 0 | Cor da caixa à volta das hiperligações normais em formato RGB. | | `menubordercolor` | 1 0 0 | Cor da caixa à volta das ligações de menu em formato RGB. | | `urlbordercolor` | 0 1 1 | Cor da caixa à volta das ligações para URLs em formato RGB. | | `pdfpagemode` | vazio | Determina como o ficheiro é aberto. As possibilidades são UseThumbs (Miniaturas), UseOutlines (Marcadores) e FullScreen. | | `pdftitle` | | Define o título do documento. | | `pdfauthor` | | Define o autor do documento. | | `pdfstartpage` | 1 | Determina em que página o ficheiro PDF é aberto. | ## Leitura adicional Para mais informações, veja * [Índice](/latex/overleaf-learn-latex-pt/estrutura-do-documento/02-table-of-contents.md) * [Secções e capítulos](/latex/overleaf-learn-latex-pt/estrutura-do-documento/01-sections-and-chapters.md) * [Referência cruzada de secções e equações](/latex/overleaf-learn-latex-pt/estrutura-do-documento/03-cross-referencing-sections-equations-and-floats.md) * [Utilizar cores no LaTeX](/latex/overleaf-learn-latex-pt/formatacao/13-using-colors-in-latex.md) * [Gestão num grande projeto](/latex/overleaf-learn-latex-pt/estrutura-do-documento/07-management-in-a-large-project.md) * [Manual do Hyperref](http://repositorios.cpai.unb.br/ctan/macros/latex/contrib/hyperref/doc/manual.pdf) * [Artigo sobre hiperligações nos wikibooks](http://en.wikibooks.org/wiki/LaTeX/Hyperlinks) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/overleaf-learn-latex-pt/estrutura-do-documento/09-hyperlinks.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.