> 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/mais-topicos/08-choosing-a-latex-compiler.md). # Escolher um compilador LaTeX Os estilos, conteúdos e o layout num documento LaTeX são definidos por meio de *etiquetas* ou *comandos* num ficheiro .tex simples, este ficheiro pode ser usado para gerar vários tipos de versões "legíveis por humanos" do documento. A forma mais fácil de gerar esta saída final é usar [O Overleaf](http://www.overleaf.com). O Overleaf tem uma distribuição LaTeX pronta a usar e os documentos finais podem ser gerados simplesmente clicando no botão "Recompile"; se for esse o seu caso, pode saltar este artigo. Caso contrário, se precisar de aprender a compilar documentos no seu computador, este artigo descreve como gerar saída PS, DVI e PDF a partir de um ficheiro LaTeX. ## Introdução Os documentos LaTeX são documentos simples com a extensão .tex (veja o [Criar um documento em LaTeX](/latex/overleaf-learn-latex-pt/nocoes-basicas-de-latex/01-learn-latex-in-30-minutes.md) artigo para exemplos), este ficheiro de texto simples contém alguns comandos de marcação destinados a formatar o documento, mas como é que gera realmente a saída final? Depende do tipo de documento que pretende gerar. Suponha que guardou o seu documento e chamou o ficheiro de "mydocument.tex". Para criar um ficheiro .PDF basta executar este comando no terminal do sistema. `pdflatex mydocument.tex` E aparecerá um ficheiro chamado "mydocument.pdf". ## Distribuições TeX O conjunto de programas que torna possível compilar documentos TeX e LaTeX chama-se uma composição tipográfica TeX ou uma distribuição TeX. Existem muitas distribuições TeX disponíveis para diferentes sistemas operativos: * **MiKTeX** para Windows * **TeX Live** para Linux e outros sistemas semelhantes a UNIX * **MacTeX** redistribuição do TeX Live para macOS * **teTeX** para Linux e outros sistemas semelhantes a UNIX; já não é atualmente mantido ativamente * **proTeXt** baseia-se em MiKTeX Claro que, se não quiser passar pelo processo de instalar uma distribuição TeX, pode usar uma opção online pronta a usar como [O Overleaf](http://www.overleaf.com). ## Editores LaTeX Existem muitos editores de texto avançados dedicados especificamente ao LaTeX para os sistemas operativos mais populares, alguns podem ser descarregados gratuitamente enquanto outros são software proprietário: * Código aberto: AUCTEX, GNU TeXmacs, Gummi, Kile, LaTeXila, MeWa, TeXShop, TeXnicCenter, Texmaker, TeXstudio, TeXworks * Freeware: LEd, WinShell * Proprietário/Shareware: Inlage, Scientific WorkPlace, WinEdt Existem também editores de uso geral que adicionam opções compatíveis com LaTeX através de plugins. Por exemplo, os conhecidos editores emacs e vim têm ambos uma extensão LaTeX, tal como Atom, VS Code e Sublime Text. Vale a pena mencionar que o editor em [O Overleaf](http://overleaf.com) pode ser personalizado para emular o comportamento do emacs ou vim. Também é *compatível com temas*, para que possa escolher o mesmo destaque de sintaxe de alguns dos editores acima mencionados. Pode encontrar essas definições clicando no ícone de menu do Overleaf, acima do painel da lista de ficheiros no seu projeto Overleaf. ## Formatos de saída Existem três formatos de saída disponíveis em todas as distribuições TeX. Para gerar uma saída específica, o documento tem de ser compilado executando um comando num *terminal* (Linux e macOS) ou na *linha de comandos* (Windows). Por exemplo, se quiser compilar um ficheiro chamado "mydocument.tex" pode usar um dos seguintes comandos: **latex mydocument.tex** Isto irá criar "mydocument.dvi", um documento DVI **pdflatex mydocument.tex** Isto irá gerar "mydocument.pdf", um documento PDF Há alguns comandos adicionais que permitem a conversão entre formatos; as imagens PS também são suportadas. Veja o [guia de referência](#reference-guide) para uma descrição esquemática dos comandos e formatos de saída. Uma descrição de cada formato de saída é fornecida abaixo: * **(DVI)** O formato de ficheiro independente do dispositivo consiste em dados binários que descrevem o layout visual de um documento de uma forma que não depende de qualquer formato de imagem específico, hardware de visualização ou impressora. * **(PS)** O formato de ficheiro PostScript descreve texto e gráficos na página e baseia-se em gráficos vetoriais. O PostScript é, até agora, um padrão nas áreas de editoração eletrónica. * **(PDF)** O Portable Document Format é um formato de ficheiro, baseado em PostScript, usado para representar documentos de forma independente do software de aplicação, hardware e sistemas operativos. Atualmente é amplamente utilizado como formato de ficheiro para impressão e para distribuição na Web. Nota: *A maioria dos editores hoje em dia inclui ícones de acesso rápido para compilar para diferentes formatos de saída, por isso não tem de executar os comandos numa linha de comandos.* No Overleaf, a saída final compilada é sempre um documento PDF. Se lhe for exigido produzir um ficheiro DVI a partir do seu projeto Overleaf, eis o que pode fazer: 1. Certifique-se de que está a usar apenas imagens .eps e .ps no seu projeto. 2. Clique no **menu do Overleaf** ícone acima do painel da lista de ficheiros, e defina a *Compilador* definição para 'LaTeX'. 3. Recompile o seu projeto. 4. Clique no botão "Logs and output files" ao lado do botão Recompile. 5. Desça até ao fundo, e clique em "Other logs and output files". 6. Deverá então ser capaz de descarregar o ficheiro .dvi gerado. ![Descarregar outros ficheiros de saída](/files/e52006a4ed64d704b114fb38fb1e02328ac55c03) ## Outros compiladores As outras definições possíveis do compilador são pdfLaTeX (a predefinição), XeLaTeX e LuaLaTeX. Normalmente pode optar por pdfLaTeX, mas a escolha de um compilador depende das necessidades de cada projeto. * O LaTeX suporta apenas os formatos de imagem .eps e .ps para utilização com `\includegraphics`. Se todas as imagens no seu projeto forem ficheiros .eps, então esta definição do compilador é recomendada. * pdfLaTeX suporta os formatos de imagem .png, .jpg, .pdf. Converterá imagens .eps para .pdf em tempo real durante a compilação, o que pode prolongar o tempo de compilação necessário. (O pdfLaTeX pode não conseguir lidar com `pstricks` bem no Overleaf.) * XeLaTeX e LuaLaTeX suportam ambos UTF-8 de forma robusta logo à partida, bem como Truetype e OpenType. Por isso, são recomendados se precisar de compor scripts não latinos no Overleaf, em conjunto com o `polyglossia` pacote. Também suportam todos os formatos de imagem .png, .jpg, .pdf *e* .eps. * XeLaTeX suporta `pstricks`; mas LuaLaTeX não. * Pode expandir as capacidades do LuaLaTeX integrando código Lua diretamente no seu documento. ## Compilação de documentos com referências cruzadas Em alguns casos, quando o seu documento inclui referências cruzadas, tem de compilar a fonte duas vezes. É necessário incluir os números corretos no índice, lista de imagens, números de referência para teoremas e assim por diante. Durante a primeira compilação, o compilador LaTeX escreve o ficheiro .aux com informações sobre a numeração diferente e, durante a segunda, o compilador lê essas informações para gerar corretamente um índice, bibliografia, etc. Este processo pode ser automatizado pelo comando `latexmk`. Por exemplo, para criar um pdf a partir do ficheiro "mydocument.tex", execute `latexmk -pdf mydocument.tex` apenas uma vez, mesmo que o documento tenha imagens e bibliografia referenciadas. Pode alterar *-pdf* para *-dvi* para definir um tipo de ficheiro diferente. ## Guia de referência **Fluxo do ficheiro de compilação LaTeX** ![Fluxo do ficheiro Latex](/files/b3ec3a5ce53bfa4011d66b13fe72246f5f53a9d0) ## Leitura adicional * [Criar um documento em LaTeX](/latex/overleaf-learn-latex-pt/nocoes-basicas-de-latex/01-learn-latex-in-30-minutes.md) * [Criar um documento no Overleaf](/latex/overleaf-learn-latex-pt/base-de-conhecimento/031-creating-a-document-in-overleaf.md) * [Depurar erros de tempo limite de compilação](/latex/overleaf-learn-latex-pt/base-de-conhecimento/038-fixing-and-preventing-compile-timeouts.md) * [Projetos LaTeX com vários ficheiros](/latex/overleaf-learn-latex-pt/estrutura-do-documento/08-multi-file-latex-projects.md) * [A introdução não tão curta ao LaTeX2ε](http://www.ctan.org/tex-archive/info/lshort/) --- # 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/mais-topicos/08-choosing-a-latex-compiler.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.