> 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/fontes/03-xelatex.md). # Suportar fontes modernas com XƎLaTeX ## Introdução [XeTeX](https://tug.org/xetex/) é um mecanismo de composição tipográfica derivado do software TeX original de Donald Knuth. No entanto, ao contrário do programa original de Knuth, o XeTeX lê nativamente texto Unicode codificado em UTF-8 e, com a ajuda do seu [HarfBuzz](https://harfbuzz.github.io/) mecanismo de composição, suporta formatos de fonte modernos, como [OpenType (OTF)](https://docs.microsoft.com/en-us/typography/opentype/) e [a tecnologia de fontes Graphite da SIL](https://scripts.sil.org/cms/scripts/page.php?site_id=projects\&item_id=graphite_home). O compilador LaTeX correspondente [compilador](/latex/overleaf-learn-latex-pt/mais-topicos/08-choosing-a-latex-compiler.md) no Overleaf chama-se `xelatex`. Qualquer pessoa interessada em compreender melhor a evolução dos diferentes mecanismos TeX pode querer ler o artigo do Overleaf [What’s in a Name: A Guide to the Many Flavours of TeX](/latex/overleaf-learn-latex-pt/artigos-aprofundados/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md). ## Os conceitos básicos: Times New Roman Times New Roman é uma fonte muito usada e aqui está um exemplo do seu uso no Overleaf através do compilador XeLaTeX. Neste exemplo, a fonte do documento é definida usando `\usemainfont{Times New Roman}`, onde o comando `\usemainfont{...}` é fornecido pelo pacote `fontspec`. ```latex \documentclass[12pt]{article} \usepackage{fontspec} \setmainfont{Times New Roman} \title{Documento de fonte de exemplo} \author{Overleaf} \date{\today} \begin{document} \maketitle Este é um \textit{exemplo} de um documento compilado com \textbf{XeLaTeX}. O LuaLaTeX também deverá funcionar. \end{document} ``` [Exemplo de Times New Roman aberto usando XeLaTeX no Overleaf](https://www.overleaf.com/docs?engine=xelatex\&snip_name=Times+New+Roman+%28via+XeLaTeX%29\&snip=%5Cdocumentclass%5B12pt%5D%7Barticle%7D%0A%5Cusepackage%7Bfontspec%7D%0A+%0A%5Csetmainfont%7BTimes+New+Roman%7D%0A%5Ctitle%7BSample+font+document%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A+++%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A+++++%0AThis+is+an+%5Ctextit%7Bexample%7D+of+a+document+compiled+%0Awith+%5Ctextbf%7BXeLaTeX%7D.+LuaLaTeX+should+also+work+too.%0A%0A%5Cend%7Bdocument%7D) Este exemplo produz a seguinte saída: ![XeLaTeXOverleaf.png](/files/52c7343ec4248a1ed3c5b3a2fb45892db46acbc7) Também pode [usar LuaLaTeX para executar o mesmo código](https://www.overleaf.com/docs?engine=lualatex\&snip_name=Times+New+Roman+%28via+LuaLaTeX%29\&snip=%5Cdocumentclass%5B12pt%5D%7Barticle%7D%0A%5Cusepackage%7Bfontspec%7D%0A+%0A%5Csetmainfont%7BTimes+New+Roman%7D%0A%5Ctitle%7BSample+font+document%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A+++%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A+++++%0AThis+is+an+%5Ctextit%7Bexample%7D+of+a+document+compiled+%0Awith+%5Ctextbf%7BLuaLaTeX%7D.%0A%0A%5Cend%7Bdocument%7D) . ## Definir fontes para diferentes elementos LaTeX Diferentes elementos num documento LaTeX são formatados com diferentes fontes; por exemplo, num `verbatim` ambiente o texto é exibido usando um estilo de máquina de escrever. Estilos de fonte diferentes podem ser definidos para cada contexto: ```latex \documentclass[12pt]{article} \usepackage{fontspec} %----------------------------------------------------------------------- \setmainfont{Times New Roman} \setsansfont{Arial} \setmonofont[Color={0019D4}]{Courier New} %----------------------------------------------------------------------- \title{Documento de fonte de exemplo} \author{Overleaf} \date{\today} \begin{document} \maketitle Este é um \textit{exemplo} de documento compilado com o compilador \textbf{XeLaTeX}. Se tiver de escrever algum código, pode usar o ambiente \texttt{verbatim}: \begin{verbatim} Normalmente este ambiente é usado para exibir código, por isso aqui está um programa C simples. #include #define NUMYAYS 10 int main() { int i; for (i = 0; i <= NUMYAYS; i++) { printf("Viva! O Overleaf é incrível!\n"); } return 0; } \end{verbatim} {\sffamily Este é um texto de exemplo em \textbf{tipografia sem serifa}} \end{document} ``` [Para ver o resultado, abra este exemplo XeLaTeX no Overleaf](https://www.overleaf.com/docs?engine=xelatex\&snip_name=Document+formatted+with+different+fonts\&snip=%5Cdocumentclass%5B12pt%5D%7Barticle%7D%0A%5Cusepackage%7Bfontspec%7D%0A%0A%25-----------------------------------------------------------------------%0A%5Csetmainfont%7BTimes+New+Roman%7D%0A%5Csetsansfont%7BArial%7D%0A%5Csetmonofont%5BColor%3D%7B0019D4%7D%5D%7BCourier+New%7D%0A%25-----------------------------------------------------------------------%0A%0A%5Ctitle%7BSample+font+document%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%5Cbegin%7Bdocument%7D%0A++++%0A%5Cmaketitle%0A+++++%0AThis+an+%5Ctextit%7Bexample%7D+of+document+compiled+with+the++%0A%5Ctextbf%7BXeLaTeX%7D+compiler.+If+you+have+to+write+some+code+you+can+%0Ause+the+%5Ctexttt%7Bverbatim%7D+environment%3A%0A%0A++++%5Cbegin%7Bverbatim%7D%0A++++Usually+this+environment+is+used+to+display+code%2C+%0A++++so+here%27s+a+simple+C+program.%0A%0A++++%23include+%3Cstdio.h%3E%0A++++%23define+NUMYAYS+10%0A++++++%0A++++int+main%28%29%0A++++%7B%0A++++++++int+i%3B+++%0A++++++++for+%28i+%3D+0%3B+i+%3C%3D+NUMYAYS%3B+i%2B%2B%29+%0A++++++++%7B%0A++++++++++++printf%28%22Yay%21+Overleaf+is+Awesome%21%5Cn%22%29%3B%0A++++++++%7D%0A++++++++return+0%3B%0A++++%7D%0A++++%5Cend%7Bverbatim%7D%0A++++%7B%5Csffamily+This+is+a+sample+text+in+%5Ctextbf%7BSans+Serif+Font+Typeface%7D%7D%0A+++++++%0A%5Cend%7Bdocument%7D) No exemplo anterior são usadas três fontes diferentes; as linhas seguintes determinam os elementos que usarão estas fontes: **\setmainfont{Times New Roman}** Esta é a fonte normal usada na maior parte do documento, Times New Roman no exemplo. **\setsansfont{Arial}** Os elementos que requerem uma fonte sem serifa, explicitamente declarados por \ssfamily no exemplo, serão compostos com a fonte Arial. **\setmonofont{Courier New}** Tudo o que tiver de ser formatado com uma fonte monoespaçada (tipo máquina de escrever) usará a fonte Courier New. Este comando tem um parâmetro opcional extra entre chavetas: **Color={0019D4}** Isto define a cor do texto, usando um valor Color= no formato hexadecimal HTML. O uso seletivo e cuidadoso da cor do texto pode ser útil ao criar uma apresentação. ## Fontes no Overleaf Há [um grande número de fontes instaladas no Overleaf](/latex/overleaf-learn-latex-pt/perguntas-e-respostas/85-which-otf-or-ttf-fonts-are-supported-via-fontspec.md) que pode usar no seu projeto, da forma mais fácil através de `fontspec`. Os exemplos seguintes mostram o uso de fontes incluídas nos servidores do Overleaf, como Google Noto, juntamente com fontes que precisa de carregar a partir de [Google Fonts](https://fonts.google.com/). ### Fontes instaladas nos servidores do Overleaf: fontes Google Noto Porque [TeX Live](https://www.tug.org/texlive/)—que é usado pelo Overleaf—inclui as [fontes Google Noto](https://www.google.com/get/noto/) pode usá-las, através do `fontspec` pacote, em projetos Overleaf compilados usando os compiladores XeLaTeX ou LuaLaTeX. Aqui está um projeto de exemplo que usa o [`noto` pacote](https://ctan.org/pkg/noto?lang=en) para configurar o seu documento para composição tipográfica com as famílias de fontes NotoSerif, NotoSans e NotoSansMono. A documentação sobre o `noto` pacote pode ser encontrada no seu [ficheiro readme no CTAN](http://mirrors.ctan.org/fonts/noto/README). ```latex \documentclass{article} \usepackage{xcolor} \usepackage{noto} \usepackage{hyperref} \title{Usar fontes Google Noto} \author{Overleaf} \date{Abril de 2021} \begin{document} \maketitle \section{Introdução} Este projeto de exemplo usa o pacote \href{https://ctan.org/pkg/noto?lang=en}{\color{blue}\texttt{noto}} para compor o seu documento usando as fontes Noto da Google\footnote{\url{https://www.google.com/get/noto/}}: \begin{itemize} \item \verb|\textbf{bold}| produz \textbf{bold} \item \verb|\textit{italic}| produz \textit{italic} \item \verb|\textbf{\textit{bold italic}}| produz \textbf{\textit{bold italic}} \item \verb|\emph{emphasis}| produz \emph{emphasis} \item \verb|\textbf{\emph{bold italic}}| produz \textbf{\emph{bold italic}} \end{itemize} \subsection{Fontes monoespaçadas} Pode usar as fontes monoespaçadas da Noto para texto monoespaçado \texttt{regular} e \texttt{\textbf{bold}}. \subsection{Fontes sem serifa} Aqui há algum \textsf{texto composto numa fonte sem serifa} juntamente com \textbf{\textsf{texto composto em negrito sem serifa}}. \section{Leitura adicional} A documentação para o pacote \texttt{noto} pode ser encontrada no seu \href{http://mirrors.ctan.org/fonts/noto/README}{\color{blue}\texttt{readme} file no CTAN}. \end{document} ``` [Abra este exemplo XeLaTeX no Overleaf para explorar as fontes Noto](https://www.overleaf.com/docs?engine=xelatex\&snip_name=Using+Google+Noto+fonts\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxcolor%7D%0A%5Cusepackage%7Bnoto%7D%0A%5Cusepackage%7Bhyperref%7D%0A%5Ctitle%7BUsing+Google+Noto+fonts%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7BApril+2021%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cmaketitle%0A%0A%5Csection%7BIntroduction%7D%0AThis+example+project+uses+the+%5Chref%7Bhttps%3A%2F%2Fctan.org%2Fpkg%2Fnoto%3Flang%3Den%7D%7B%5Ccolor%7Bblue%7D%5Ctexttt%7Bnoto%7D%7D+package+to+typeset+your+document+using+Google%27s+Noto+fonts%5Cfootnote%7B%5Curl%7Bhttps%3A%2F%2Fwww.google.com%2Fget%2Fnoto%2F%7D%7D%3A%0A%5Cbegin%7Bitemize%7D%0A%5Citem+%5Cverb%7C%5Ctextbf%7Bbold%7D%7C+produces+%5Ctextbf%7Bbold%7D%0A%5Citem+%5Cverb%7C%5Ctextit%7Bitalic%7D%7C+produces+%5Ctextit%7Bitalic%7D%0A%5Citem+%5Cverb%7C%5Ctextbf%7B%5Ctextit%7Bbold+italic%7D%7D%7C+produces+%5Ctextbf%7B%5Ctextit%7Bbold+italic%7D%7D%0A%5Citem+%5Cverb%7C%5Cemph%7Bemphasis%7D%7C+produces+%5Cemph%7Bemphasis%7D%0A%5Citem+%5Cverb%7C%5Ctextbf%7B%5Cemph%7Bbold+italic%7D%7D%7C+produces+%5Ctextbf%7B%5Cemph%7Bbold+italic%7D%7D%0A%5Cend%7Bitemize%7D%0A%0A%5Csubsection%7BMonospaced+fonts%7D%0AYou+can+use+Noto%27s+monospaced+fonts+for+%5Ctexttt%7Bregular%7D+and+%5Ctexttt%7B%5Ctextbf%7Bbold%7D%7D+monospaced+text.%0A%0A%5Csubsection%7BSans+serif+fonts%7D%0AHere+is+some+%5Ctextsf%7Btext+is+typeset+in+a+sans+serif+font%7D+together+with+%5Ctextbf%7B%5Ctextsf%7Btext+typeset+in+bold+sans+serif%7D%7D.%0A%0A%5Csection%7BFurther+reading%7D%0ADocumentation+for+the+%5Ctexttt%7Bnoto%7D+package+can+be+found+in+its+%5Chref%7Bhttp%3A%2F%2Fmirrors.ctan.org%2Ffonts%2Fnoto%2FREADME%7D%7B%5Ccolor%7Bblue%7D%5Ctexttt%7Breadme%7D+file+on+CTAN%7D.%0A%0A%5Cend%7Bdocument%7D) ![Usar fontes Google Noto para compor um documento LaTeX](/files/9206a5e65296dcd39b070f5421476d9c28f6ea0c) ### Usar fontes não instaladas nos servidores do Overleaf: exemplo com Google Fonts Para usar fontes OpenType que não estão instaladas nos servidores do Overleaf, tem primeiro de carregar os ficheiros de fonte para o seu projeto Overleaf—desde que as licenças das fontes o permitam. Depois de as fontes OpenType serem carregadas, defina o compilador do projeto para XƎLaTeX (ou LuaLaTeX) e use `fontspec` para configurar as suas fontes. O projeto de exemplo descrito abaixo mostra como criar pastas, carregar fontes e configurá-las com `fontspec`. Para o nosso exemplo, usaremos a seguinte seleção de fontes de [Google Fonts](https://fonts.google.com/): * Fonte serifada: [Brygada1918](https://fonts.google.com/specimen/Brygada+1918) * Fonte sem serifa: [Asap](https://fonts.google.com/specimen/Asap) * Fonte monoespaçada: [JetBrains Mono](https://fonts.google.com/specimen/JetBrains+Mono) Nota: Não estamos a sugerir que este exemplo forneça uma combinação tipograficamente harmoniosa de estilos de letra; apenas mostra como carregar, configurar e usar as fontes da sua escolha. Para cada tipo de letra, precisa de descarregar a família de fontes a partir do Google Fonts: ![GoogleDownload.png](/files/2967c087c25cb931ef8e7a9066171b0f033360ad) Nota: Algumas fontes da Google estão disponíveis como fontes OpenType "estáticas" e as chamadas fontes OpenType "variáveis". Se o ficheiro ZIP descarregado tiver uma pasta chamada "static", deve carregar as fontes dessa pasta, e não as versões de fonte variável: ![OpenTypeStatic.png](/files/70f58369784dcf0a40af0943a91074d53a2201cc) A seguir, precisa de carregar os ficheiros de fonte para o seu projeto, mas como as famílias de fontes contêm vários ficheiros de fonte, talvez queira criar pastas individuais de projeto Overleaf para conter os ficheiros—usando uma pasta por família de fontes. O vídeo seguinte mostra como fazer isso. Mais tarde, teremos de indicar ao XƎLaTeX onde encontrar as fontes do seu projeto—porque elas não estão pré-instaladas nos servidores do Overleaf. {% embed url="" %} ### Configurar o fontspec para usar as fontes Depois de carregar os ficheiros da família de fontes para as pastas do projeto Overleaf, podemos configurá-los para uso através de `fontspec`. No código LaTeX seguinte, repare como usamos o `Path` parâmetro para dizer ao `fontspec` que os ficheiros de fonte estão localizados numa pasta local dentro do sistema de ficheiros do nosso projeto: ```latex \setmainfont{Brygada1918}[ Path=./BrygadaFontFiles/, Extension = .ttf, UprightFont=*-Regular, BoldFont=*-Bold, ItalicFont=*-Italic, BoldItalicFont=*-BoldItalic ] \setsansfont{Asap}[ Path=./AsapFontFiles/, Scale=0.9, Extension = .ttf, UprightFont=*-Regular, BoldFont=*-Bold, ItalicFont=*-Italic, BoldItalicFont=*-BoldItalic ] \setmonofont{JetBrainsMono}[ Path=./JetbrainsFontFiles/, Scale=0.85, Extension = .ttf, UprightFont=*-Regular, BoldFont=*-Bold, ItalicFont=*-Italic, BoldItalicFont=*-BoldItalic ] ``` ![FontSpecPathUpdated.png](/files/d5bdb3c3b0f80d0e6095d7f0655f0989c6ab3e1e) [Abra a demonstração XeLaTeX e Google Fonts no Overleaf](https://www.overleaf.com/project/new/template/31226?id=835225587\&templateName=XeLaTeX+font+demo+with+Google+Fonts\&latexEngine=xelatex\&texImage=texlive-full%3A2022.1\&mainFile=) O [`fontspec` pacote](https://ctan.org/pkg/fontspec?lang=en) oferece uma grande variedade de opções para configurar fontes OpenType para uso com LuaLaTeX ou XƎLaTeX—a sua [documentação excelente](http://mirrors.ctan.org/macros/unicodetex/latex/fontspec/fontspec.pdf) contém numerosos exemplos que pode explorar para afinar o design e a composição tipográfica dos seus documentos. ## Leitura adicional Para mais informações, consulta: * [Negrito, itálico e sublinhado](/latex/overleaf-learn-latex-pt/nocoes-basicas-de-latex/03-bold-italics-and-underlining.md) * [Tamanhos, famílias e estilos de fonte](/latex/overleaf-learn-latex-pt/fontes/01-font-sizes-families-and-styles.md) * [Tipos de letra](/latex/overleaf-learn-latex-pt/fontes/02-font-typefaces.md) * [Formatação de parágrafos](/latex/overleaf-learn-latex-pt/formatacao/04-articles-how-to-change-paragraph-spacing-in-latex.md) * [Quebras de linha e espaços em branco](/latex/overleaf-learn-latex-pt/formatacao/05-line-breaks-and-blank-spaces.md) * [Alinhamento do texto](/latex/overleaf-learn-latex-pt/formatacao/06-text-alignment.md) * [Múltiplas colunas](/latex/overleaf-learn-latex-pt/formatacao/09-multiple-columns.md) * [Gestão num grande projeto](/latex/overleaf-learn-latex-pt/estrutura-do-documento/07-management-in-a-large-project.md) * [Projetos LaTeX com vários ficheiros](/latex/overleaf-learn-latex-pt/estrutura-do-documento/08-multi-file-latex-projects.md) * [Suporte a línguas internacionais](/latex/overleaf-learn-latex-pt/idiomas/03-international-language-support.md) * [Escolher um Compilador LaTeX](/latex/overleaf-learn-latex-pt/mais-topicos/08-choosing-a-latex-compiler.md) * [Lista de fontes OTF e TTF instaladas no Overleaf](/latex/overleaf-learn-latex-pt/perguntas-e-respostas/85-which-otf-or-ttf-fonts-are-supported-via-fontspec.md) * [coleção de fontes da Google](http://www.google.com/fonts/) * [`fontspec` manual do pacote](http://tug.ctan.org/tex-archive/macros/latex/contrib/fontspec/fontspec.pdf) --- # 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/fontes/03-xelatex.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.