> 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/ficheiros-de-classe/02-overleaf-and-tex-live.md). # Lista de pacotes e ficheiros de classe Este artigo apresenta o TeX Live e descreve a sua utilização no serviço de composição tipográfica baseado em LaTeX do Overleaf. ## Introdução ao TeX Live [TeX Live](https://www.tug.org/texlive/) é uma distribuição de software livre publicada anualmente pela [O TeX Users Group](https://www.tug.org/). Fornece os pacotes LaTeX, tipos de letra, motores TeX e inúmeras ferramentas de software necessárias para suportar a composição tipográfica baseada em LaTeX em todos os sistemas operativos padrão. O TeX Live é um componente importante do Overleaf porque os nossos servidores o utilizam para compilar o seu código LaTeX e gerar a pré-visualização PDF em tempo real. Também oferece aos utilizadores do Overleaf acesso fácil a mais de 5.000 pacotes LaTeX contidos em cada versão do TeX Live. Não está limitado a usar a versão mais recente do TeX Live para compilar os seus projetos porque os servidores do Overleaf dão acesso a versões anteriores do TeX Live. Os projetos podem ser facilmente [alterados para usar uma versão anterior do TeX Live](#how-do-i-change-a-projects-tex-live-version)—por exemplo, devido a problemas de compatibilidade de pacotes. ## Que pacotes LaTeX o Overleaf suporta? Como o Overleaf usa o TeX Live, pode aceder a mais de 5.000 pacotes, incluindo: * Figuras com [pstricks](https://ctan.org/pkg/pstricks-base?lang=en) e [TikZ](https://en.wikipedia.org/wiki/PGF/TikZ). Aqui estão alguns [exemplos com TikZ](https://www.overleaf.com/latex/examples/tagged/tikz). * Bibliografias com [BibTeX](https://www.bibtex.org/) e [BibLaTeX](https://ctan.org/pkg/biblatex?lang=en). Aqui estão [alguns exemplos](https://www.overleaf.com/gallery/tagged/bibliography). * Pacotes, como [fontspec](https://ctan.org/pkg/fontspec) necessários para o XeLaTeX e o LuaLaTeX para suporte de tipos de letra OpenType. Pode consultar a lista de pacotes TeX e LaTeX na subpágina do CTAN [CTAN: Pacotes](https://ctan.org/pkg/). ## Que versão do TeX Live o meu projeto usa? Quando cria um novo projeto no Overleaf ou copia um existente, o novo projeto (ou a cópia) será, por predefinição, compilado usando a versão mais recente do TeX Live instalada nos nossos servidores. Quando disponibilizamos uma nova versão do TeX Live para os nossos utilizadores, não atualizamos automaticamente os projetos existentes. Fazer isso automaticamente poderia causar erros ou avisos nos seus projetos existentes devido a diferenças entre versões do TeX Live. ### Notas adicionais sobre o TeX Live e o seu projeto no Overleaf * A versão do TeX Live usada para compilar um projeto não partilhado é controlada pela pessoa proprietária desse projeto. No entanto, se um colaborador de um projeto partilhado alterar a versão do TeX Live, isso afetará todos os que colaboram nesse projeto. * A versão do TeX Live é um parâmetro específico do projeto: alterá-la para um projeto em particular não afetará qualquer outro projeto no seu espaço de trabalho do Overleaf nem modificará qualquer código-fonte no projeto cuja versão do TeX Live foi alterada. * Depois de escolher uma versão específica do TeX Live, todos os pacotes usados pelo seu projeto serão, naturalmente, as versões presentes e publicadas nessa versão do TeX Live. * Mudar para uma configuração diferente do TeX Live pode alterar o comportamento dos pacotes, como alterações nos comandos que fornecem. * Alterar a versão do TeX Live de um projeto não é permanente; pode reverter para uma versão anterior sempre que necessário. Tenha sempre em atenção que diferentes versões do TeX Live podem ter atualizações/alterações que podem afetar a capacidade de compilar o seu projeto usando uma determinada versão do TeX Live. ## Como altero a versão do TeX Live de um projeto? Siga os passos abaixo para alterar a versão do TeX Live de um projeto — a definição do TeX Live é *específica de cada projeto* e não afeta quaisquer outros projetos que possa ter: 1. Selecione o botão de menu do Overleaf (![Overleaf menu button](/files/86f0ade581f9ba6f2f391729b035b5698e60425c)) e localize a secção do menu rotulada **Definições**. 2. Dentro de **Definições**, escolha a lista pendente rotulada **Versão do TeX Live**. 3. Selecione a versão do TeX Live exigida pelo seu projeto e, em seguida, feche o menu clicando em qualquer lugar fora da lista do menu. 4. Volte a compilar o seu projeto para testar a compatibilidade com a versão escolhida do TeX Live. O gráfico seguinte resume estes passos — para maior clareza, a maioria dos itens do menu foi omitida: ![Imagem que mostra como escolher a versão do TeX Live no Overleaf](/files/3d1e3e0e03817c8538f51b5e0f920cc5af555d2e) ### Por que alterar a versão do TeX Live de um projeto? O TeX Live é uma distribuição de software grande e complexa, por isso não é surpreendente que novas versões introduzam ocasionalmente alterações que impeçam a compilação bem-sucedida de alguns documentos. Isto deve-se normalmente a alterações que afetam comandos de pacotes, erros inesperados e incompatibilidades de pacotes (ou “conflitos”). Aqui estão algumas razões comuns para alterar a versão do TeX Live usada para compilar o seu projeto. * **Pode querer uma versão mais recente do TeX Live para um dos seus projetos existentes**. Pode mudar a versão do TeX Live usada pelo seu projeto para uma versão mais recente que disponibilize um pacote, comando ou funcionalidade linguística que pretenda usar. No entanto, antes de fazer isso, recomendamos que o seu projeto compile sem erros e que compreenda quaisquer avisos restantes fornecidos pelo compilador. * **Pode querer que um projeto copiado use a mesma versão do TeX Live que o original**. Por vezes, quando faz uma cópia de um projeto antigo, podem surgir novos erros devido a alterações no TeX Live. Quando isso acontece, pode либо adaptar o seu projeto para ser compatível com a versão mais recente do TeX Live ou definir a versão do TeX Live da sua nova cópia para corresponder à versão do projeto original de que foi copiada. * **Pode precisar que a versão do TeX Live usada no seu projeto do Overleaf corresponda à versão que usa na sua máquina local**. Se compilar os seus projetos localmente e também no Overleaf, para obter resultados consistentes talvez queira ajustar a versão do TeX Live usada pelo Overleaf para ser compatível com a versão do LaTeX que usa localmente. * **Pode submeter para uma revista ou repositório que compile com uma versão específica do TeX Live**. Se submeter para uma revista ou repositório que use uma versão específica do LaTeX, compilar com a mesma versão ou com uma versão compatível do TeX Live no Overleaf pode ajudar a evitar erros no momento da submissão. ### Versões “legacy” do TeX Live No menu pendente da versão do TeX Live, mostrado na captura de ecrã acima, as versões mais antigas do TeX Live são categorizadas como “Legacy”. Estas versões são disponibilizadas para garantir a compatibilidade e a compilação bem-sucedida de modelos e projetos antigos que as exijam. Aqui estão alguns pontos adicionais a considerar ao ponderar a utilização de versões mais antigas do TeX Live: * Ao iniciar um novo projeto, é aconselhável usar a versão mais recente do TeX Live, a menos que problemas específicos de compatibilidade exijam uma versão mais antiga. Esta abordagem garante que beneficia das atualizações e funcionalidades mais recentes. * Embora o Overleaf ainda não tenha definido um calendário para descontinuar as versões mais antigas do TeX Live, essas versões poderão, eventualmente, ser descontinuadas e ficar indisponíveis. * Sempre que viável, os seus projetos existentes devem ser atualizados para a versão mais recente compatível do TeX Live. ## Com que frequência o TeX Live é atualizado no Overleaf? Os servidores de compilação do Overleaf são atualizados para a versão mais recente do TeX Live pouco depois de esta ficar disponível. Após os testes e a conclusão da atualização, o Overleaf publica uma publicação no blogue para partilhar quaisquer atualizações relevantes do TeX Live, juntamente com notas específicas de pacotes e orientações baseadas nos resultados dos nossos testes. As nossas “notas de lançamento” do TeX Live podem ser encontradas no nosso blogue usando a `tex live` etiqueta: . ### Sobre o processo de atualização do Overleaf Antes de atualizar a nossa instalação do TeX Live, recompilamos um vasto conjunto de testes de documentos, incluindo cerca de 5.000 da nossa galeria de modelos, exemplos e artigos, para verificar alterações que quebrem a compatibilidade — incluindo erros e qualquer alteração visual significativa no resultado compilado. Também medimos o tempo comparativo que leva a renderizar documentos. Identificamos renderizações significativamente mais lentas e tentamos torná-las mais rápidas. Como resultado desses testes, atualizamos os modelos que produzimos — é por isso que, por vezes, demoramos algum tempo a atualizar o nosso TeX Live! No entanto, o resultado é, esperamos, uma experiência mais estável para os nossos utilizadores. Apesar dos nossos testes, as atualizações feitas ao LaTeX, aos motores TeX ou aos tipos de letra e pacotes necessários no TeX Live podem, por vezes, introduzir incompatibilidades, alterações que quebram a compatibilidade e depreciações que estão fora do nosso controlo. Dada a dimensão do TeX Live e a riqueza de pacotes e ferramentas que fornece, não podemos excluir alterações que quebrem a compatibilidade, mas faremos o nosso melhor para minimizar qualquer impacto nos nossos utilizadores. ### Alterações de pacotes entre versões do TeX Live A comunidade TeX continua a inovar entre as versões anuais do TeX Live. Novos pacotes LaTeX, tipos de letra e software relacionado com TeX, ou versões atualizadas dos mesmos, são regularmente contribuídos para a Comprehensive TeX Archive Network, conhecida na comunidade TeX como CTAN. O CTAN fornece um repositório central de software relacionado com TeX e LaTeX, pronto para inclusão na próxima versão do TeX Live. --- # 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/ficheiros-de-classe/02-overleaf-and-tex-live.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.