> 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/formatacao/13-using-colors-in-latex.md). # Usar cores em LaTeX ## Introdução Este artigo explica como usar cor no seu documento LaTeX via os [`color`](https://ctan.org/pkg/color?lang=en) ou [`xcolor`](https://ctan.org/pkg/xcolor?lang=en) pacotes. Note que a documentação para utilizadores do `color` pacote está contida em [O conjunto gráfico padrão do LaTeX](http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf). Ambos os pacotes fornecem um conjunto comum de comandos para manipulação de cores, mas `xcolor` é mais flexível e suporta um maior número de modelos de cor, por isso é a abordagem recomendada. Começaremos com o seguinte exemplo: ```latex \documentclass{article} \usepackage{xcolor} \begin{document} Este exemplo mostra alguns casos de uso do pacote \texttt{xcolor} para alterar a cor de elementos no \LaTeX. \begin{itemize} \color{blue} \item Primeiro item \item Segundo item \end{itemize} \noindent {\color{red} \rule{\linewidth}{0.5mm}} \end{document} ``` [Abra este `xcolor` exemplo no Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=A+basic+xcolor+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxcolor%7D%0A%5Cbegin%7Bdocument%7D%0AThis+example+shows+some+instances+of+using+the+%5Ctexttt%7Bxcolor%7D+package+%0Ato+change+the+color+of+elements+in+%5CLaTeX.%0A%0A%5Cbegin%7Bitemize%7D%0A%5Ccolor%7Bblue%7D%0A%5Citem+First+item%0A%5Citem+Second+item%0A%5Cend%7Bitemize%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7Bred%7D+%5Crule%7B%5Clinewidth%7D%7B0.5mm%7D%7D%0A%5Cend%7Bdocument%7D) Este exemplo produz a seguinte saída: ![Exemplo de uso do pacote xcolor em LaTeX](/files/dbb9929f0b068037c07bb1570e9db0e29cfd6a2f) Neste exemplo, o pacote `xcolor` é importado com ```latex \usepackage{xcolor} ``` depois o comando `\color{blue}` define a `azul` cor para o bloco de texto atual. Neste caso, para o `itemize` ambiente. O código para compor a linha horizontal criada por `\rule{\linewidth}{0.5mm}` está contido num grupo, delimitado por { e }, de modo a manter os efeitos de `\color{red}` limitados a esse grupo. ## Cores nomeadas fornecidas pelo pacote xcolor Como observado na [documentação do pacote xcolor](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf), as seguintes cores nomeadas estão sempre disponíveis sem precisar carregar quaisquer opções de pacote: ![lista de cores no pacote xcolor](/files/4ff315ed51553e84dc4ffd28d06e2575be3fae92) ### Aceder a cores nomeadas adicionais Cores nomeadas adicionais podem ser acedidas através das seguintes `xcolor` opções de pacote: * `dvipsnames`: carrega 68 cores nomeadas (CMYK) * `svgnames`: carrega 151 cores nomeadas (RGB) * `x11names`: carrega 317 cores nomeadas (RGB) Por exemplo, se escrever ```latex \usepackage[dvipsnames]{xcolor} ``` pode aceder às seguintes cores nomeadas: ![cores carregadas pela opção dvipsnames do pacote xcolor](/files/a8e6d9d7f01d58ea3acc76d70238ee4aa7cf53af) Consulte a [documentação do pacote xcolor](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf) para listas tabuladas de cores fornecidas pelas `svgnames` e `x11names` opções. ### Exemplo de utilização O exemplo seguinte usa cores nomeadas carregadas através da `dvipsnames` opção. ```latex \documentclass{article} \usepackage[dvipsnames]{xcolor} \begin{document} Este exemplo mostra como usar o pacote \texttt{xcolor} para alterar a cor de elementos de página do \LaTeX{}. \begin{itemize} \color{ForestGreen} \item Primeiro item \item Segundo item \end{itemize} \noindent {\color{RubineRed} \rule{\linewidth}{0.5mm}} A cor de fundo do texto também pode ser definida \textcolor{red}{facilmente}. Por exemplo, pode alterar para um \colorbox{BurntOrange}{fundo laranja} e depois continuar a escrever. \end{document} ``` [Abra este `**xcolor**` exemplo no Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+xcolor+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bdvipsnames%5D%7Bxcolor%7D%0A%5Cbegin%7Bdocument%7D%0AThis+example+shows+how+to+use+the+%5Ctexttt%7Bxcolor%7D+package+%0Ato+change+the+color+of+%5CLaTeX%7B%7D+page+elements.%0A%0A%5Cbegin%7Bitemize%7D%0A%5Ccolor%7BForestGreen%7D%0A%5Citem+First+item%0A%5Citem+Second+item%0A%5Cend%7Bitemize%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7BRubineRed%7D+%5Crule%7B%5Clinewidth%7D%7B0.5mm%7D%7D%0A%0AThe+background+color+of+text+can+also+be+%5Ctextcolor%7Bred%7D%7Beasily%7D+set.+For+%0Ainstance%2C+you+can+change+use+an+%5Ccolorbox%7BBurntOrange%7D%7Borange+background%7D+and+then+continue+typing.%0A%5Cend%7Bdocument%7D) Este exemplo produz a seguinte saída: ![Demonstração do pacote xcolor](/files/b8e4535ff6d60fc8eee6b3a9c3d46c4a1133ce9d) No exemplo, também são usados dois novos comandos: * `\textcolor{red}{facilmente}`: Altera a cor do texto em linha. Este comando recebe dois parâmetros: a cor a usar e o texto cuja cor é alterada. No exemplo, a palavra `facilmente` é impressa em `vermelho`. * `\colorbox{BurntOrange}{fundo laranja}`: Altera a cor de fundo do texto passado como segundo argumento. No exemplo acima, as palavras `fundo laranja` são compostas com uma cor de fundo `BurntOrange`. ## Carregar e usar cores nomeadas no pacote color Também pode usar o `color` pacote e carregar cores nomeadas através da sua `usenames` e `dvipsnames` opções de pacote: ```latex \usepackage[usenames,dvipsnames]{color} ``` O código seguinte usa o `color` pacote para aplicar as mesmas cores nomeadas usadas no exemplo anterior do `xcolor` pacote. ```latex \documentclass{article} \usepackage[usenames,dvipsnames]{color} %usando o pacote color, não xcolor \begin{document} Este exemplo mostra como usar o pacote \texttt{\bfseries color} para alterar a cor de elementos de página do \LaTeX{}. \begin{itemize} \color{ForestGreen} \item Primeiro item \item Segundo item \end{itemize} \noindent {\color{RubineRed} \rule{\linewidth}{0.5mm}} A cor de fundo do texto também pode ser definida \textcolor{red}{facilmente}. Por exemplo, pode alterar para um \colorbox{BurntOrange}{fundo laranja} e depois continuar a escrever. \end{document} ``` [Abra este `**color**` exemplo no Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+color+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Busenames%2Cdvipsnames%5D%7Bcolor%7D+%25using+the+color+package%2C+not+xcolor%0A%5Cbegin%7Bdocument%7D%0AThis+example+shows+how+to+use+the+%5Ctexttt%7B%5Cbfseries+color%7D+package+%0Ato+change+the+color+of+%5CLaTeX%7B%7D+page+elements.%0A%0A%5Cbegin%7Bitemize%7D%0A%5Ccolor%7BForestGreen%7D%0A%5Citem+First+item%0A%5Citem+Second+item%0A%5Cend%7Bitemize%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7BRubineRed%7D+%5Crule%7B%5Clinewidth%7D%7B0.5mm%7D%7D%0A%0AThe+background+color+of+text+can+also+be+%5Ctextcolor%7Bred%7D%7Beasily%7D+set.+For+%0Ainstance%2C+you+can+change+use+an+%5Ccolorbox%7BBurntOrange%7D%7Borange+background%7D+and+then+continue+typing.%0A%5Cend%7Bdocument%7D) Este exemplo produz a mesma saída que a versão anterior `xcolor` : ![Demonstração do pacote color](/files/37923bb54abc4c9368d3392f409cb57ab707942a) ## Drivers e cor O uso de cor ao compor texto ou matemática não fazia parte do projeto original do TeX; em vez disso, a utilização/aplicação de cor era delegada a “drivers” externos que convertiam o formato de ficheiro de saída original do TeX (DVI) em PostScript ou PDF. Para que a cor funcionasse, instruções específicas do driver tinham de ser “injetadas” na saída do TeX usando um comando TeX incorporado chamado `\special` cuja função é simplesmente permitir que código/dados passem pelo processo de composição tipográfica e sejam incorporados no ficheiro de saída. Quando o driver escolhido (software) processava a saída composta, detetava o código/dados incorporados e agia sobre eles para atingir o que o utilizador pretendia — como o uso de cor. Os tempos mudaram, e o PDF é agora de longe o formato de saída mais comum usado pelos motores TeX, tendo suplantado há muito o uso de drivers DVI legados e a criação de PostScript. Os utilizadores também têm uma maior escolha de motor TeX para usar na composição dos seus documentos LaTeX, nomeadamente pdfTeX, XeTeX ou LuaTeX/LuaHBTeX, pelo que continua a ser importante ter em conta as diferenças entre esses motores TeX — garantindo que são usados os mecanismos corretos para inserir dados de cor (instruções PDF) nos seus ficheiros PDF. Para dar suporte e acomodar o formato de saída DVI legado e o ambiente mais amplo de motores TeX e fluxos de trabalho em uso, pode, se necessário, configurar os `color` ou `xcolor` pacotes para usar um “driver” específico, de modo a que o LaTeX gere dados de cor usando o método apropriado. ### Drivers para color e xcolor O `color` pacote fornece suporte imediato para as seguintes opções de driver: * `dvipdfmx`, `dvips`, `dvisvgm`, `luatex`, `pdftex` e `xetex` Existem outras opções, conforme descrito na [`color` documentação do pacote](https://mirror.ox.ac.uk/sites/ctan.org/macros/latex/required/graphics/grfguide.pdf). O `xcolor` pacote fornece as seguintes opções de driver: * `dvips`, `xdvi`, `dvipdf`, `dvipdfm`, `dvipdfmx`, `luatex`, `pdftex`, `dvipsone`, `dviwindo`, `emtex`, `dviwin`, `oztex`, `textures`, `pctexps`, `pctexwin`, `pctexhp`, `pctex32`, `truetex`, `tcidvi`, `vtex` e `xetex`. ### Deteção automática do driver de cor Ao compor o seu documento, o LaTeX lê um ficheiro de configuração chamado `color.cfg` que contém código que pode determinar se está a executar pdfTeX, XeTeX ou LuaTeX e carrega automaticamente o driver apropriado (`.def` ficheiro) para si, por isso não *precisam* é necessário especificar a opção de pacote de driver para esses motores. ### Exemplo mais avançado usando o driver dvisvgm para criar um ficheiro SVG O exemplo seguinte usa o `color` pacote com opções que carregam cores nomeadas e o `dvisvgm` driver para gerar definições/dados de cor usando código SVG: ```latex \usepackage[dvisvgm, usenames, dvipsnames]{color} ``` Especificamente, o ficheiro de saída composto pelo Overleaf é convertido para SVG usando um programa chamado [`dvisvgm`](https://dvisvgm.de/), que faz parte do TeX Live e está disponível nos nossos servidores. Para executar `dvisvgm`, depois de a página ser composta, usamos um [`latexmkrc` editável](/latex/overleaf-learn-latex-pt/artigos-aprofundados/28-how-to-use-latexmkrc-with-overleaf.md) que é criado quando abre o seguinte código no Overleaf: ```latex \documentclass{article} \usepackage[dvisvgm, usenames, dvipsnames]{color} \title{Creating SVG graphics} \author{Overleaf} \begin{document} \maketitle Olá, {\color{Apricot}em Apricot} e agora em {\color{DarkOrchid} DarkOrchid} mas talvez ficasse melhor se usássemos {\color{JungleGreen}JungleGreen}—ou talvez não? \end{document} ``` [Abra este exemplo para criar um ficheiro SVG](https://www.overleaf.com/docs?engine=latex_dvipdf\&snip_name\[]=main.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bdvisvgm%2C+usenames%2C+dvipsnames%5D%7Bcolor%7D%0A%5Ctitle%7BCreating+SVG+graphics%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0AHello%2C+%7B%5Ccolor%7BApricot%7Din+Apricot%7D+and+now+in+%7B%5Ccolor%7BDarkOrchid%7D+DarkOrchid%7D+but+perhaps+it+might+look+nicer+if+we+use+%7B%5Ccolor%7BJungleGreen%7DJungleGreen%7D---or+may+not%3F%0A%5Cend%7Bdocument%7D\&snip_name\[]=latexmkrc\&snip\[]=END+%7B%0Asystem%28%22dvisvgm+-n+-o+mygraphic.svg+.%2Foutput.dvi%22%29%0A%7D\&main_document=main.tex) Assim que o Overleaf terminar de compilar, pode aceder ao gráfico SVG, chamado `mygraphic.svg`, selecionando `Logs e resultados` e escolhendo a `Outros registos e ficheiros` lista pendente: ![Aceder a um ficheiro gerado no Overleaf](/files/5aae504b336ded6a9a6126070fc2f2f50f47b5c5) ## Criar as suas próprias cores É possível definir as suas próprias cores; a forma como a cor é definida depende do modelo de cor preferido. O exemplo seguinte usa 4 modelos de cor. ```latex \documentclass{article} \usepackage[dvipsnames]{xcolor} \definecolor{mypink1}{rgb}{0.858, 0.188, 0.478} \definecolor{mypink2}{RGB}{219, 48, 122} \definecolor{mypink3}{cmyk}{0, 0.7808, 0.4429, 0.1412} \definecolor{mygray}{gray}{0.6} \begin{document} Cores definidas pelo utilizador com diferentes modelos de cor: \begin{enumerate} \item \textcolor{mypink1}{Rosa com rgb} \item \textcolor{mypink2}{Rosa com RGB} \item \textcolor{mypink3}{Rosa com cmyk} \item \textcolor{mygray}{Cinza com gray} \end{enumerate} \end{document} ``` [Abra este exemplo no Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+user-defined+colours\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bdvipsnames%5D%7Bxcolor%7D%0A%0A%5Cdefinecolor%7Bmypink1%7D%7Brgb%7D%7B0.858%2C+0.188%2C+0.478%7D%0A%5Cdefinecolor%7Bmypink2%7D%7BRGB%7D%7B219%2C+48%2C+122%7D%0A%5Cdefinecolor%7Bmypink3%7D%7Bcmyk%7D%7B0%2C+0.7808%2C+0.4429%2C+0.1412%7D%0A%5Cdefinecolor%7Bmygray%7D%7Bgray%7D%7B0.6%7D%0A%0A%5Cbegin%7Bdocument%7D%0AUser-defined+colors+with+different+color+models%3A%0A%0A%5Cbegin%7Benumerate%7D%0A%5Citem+%5Ctextcolor%7Bmypink1%7D%7BPink+with+rgb%7D%0A%5Citem+%5Ctextcolor%7Bmypink2%7D%7BPink+with+RGB%7D%0A%5Citem+%5Ctextcolor%7Bmypink3%7D%7BPink+with+cmyk%7D%0A%5Citem+%5Ctextcolor%7Bmygray%7D%7BGray+with+gray%7D%0A%5Cend%7Benumerate%7D%0A%5Cend%7Bdocument%7D) Este exemplo produz a seguinte saída: ![Exemplo LaTeX a criar cores definidas pelo utilizador](/files/f6452bba8fe9d7548f7e18879e81a413e4479fde) O comando `\definecolor` recebe três parâmetros: o nome da nova cor, o modelo e a definição da cor. Em termos gerais, cada número representa quanto de cada cor adiciona à mistura que compõe a cor final. * `**rgb**`: Vermelho, Verde, Azul. Três valores separados por vírgulas entre 0 e 1 definem os componentes da cor. * `**RGB**`: É o mesmo que `rgb`, mas os números são inteiros entre 0 e 255. * `**cmyk**`: Ciano, Magenta, Amarelo e preto. Lista separada por vírgulas de quatro números entre 0 e 1 que determinam a cor de acordo com o [modelo CMYK subtrativo](https://en.wikipedia.org/wiki/CMYK_color_model) usado por impressoras comerciais. * `**gray**`: Escala de cinza. Um único número entre 0 e 1. No exemplo, `mypink1`, `mypink2` e `mypink3` definem a mesma cor, mas para modelos diferentes. Na verdade, pode ver que a definida por `cmyk` é ligeiramente diferente. As cores definidas por qualquer um dos modelos podem mais tarde ser usadas no seu documento não só para definir a cor do texto, mas para qualquer outro elemento que aceite uma cor como parâmetro, por exemplo [tabelas](/latex/overleaf-learn-latex-pt/figuras-e-tabelas/01-tables.md#colouring-a-table-28cells2c-rows2c-columns-and-lines29) (deve adicionar a `table` opção a `xcolor`), [elementos gráficos criados com TikZ](/latex/overleaf-learn-latex-pt/figuras-e-tabelas/05-tikz-package.md), [gráficos](/latex/overleaf-learn-latex-pt/especifico-da-area/08-pgfplots-package.md), [réguas verticais em documentos multicoluna](/latex/overleaf-learn-latex-pt/formatacao/09-multiple-columns.md#inserting-vertical-rulers) e [listagens de código](/latex/overleaf-learn-latex-pt/formatacao/11-code-listing.md#code-styles-and-colours). ### modelos de cor exclusivos do xcolor O `xcolor` pacote fornece comandos adicionais que dão suporte a mais modelos de cor e mistura de cores amigável, como demonstrado no exemplo seguinte: ```latex \documentclass{article} \usepackage[dvipsnames]{xcolor} \colorlet{LightRubineRed}{RubineRed!70} \colorlet{Mycolor1}{green!10!orange} \definecolor{Mycolor2}{HTML}{00F9DE} \begin{document} Este documento apresenta vários exemplos que mostram como usar o pacote \texttt{xcolor} para alterar a cor de elementos de página do \LaTeX{}. \begin{itemize} \item \textcolor{Mycolor1}{Primeiro item} \item \textcolor{Mycolor2}{Segundo item} \end{itemize} \noindent {\color{LightRubineRed} \rule{\linewidth}{1mm}} \noindent {\color{RubineRed} \rule{\linewidth}{1mm}} \end{document} ``` [Abra este exemplo no Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Custom+colours+with+xcolor\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bdvipsnames%5D%7Bxcolor%7D%0A%5Ccolorlet%7BLightRubineRed%7D%7BRubineRed%2170%7D%0A%5Ccolorlet%7BMycolor1%7D%7Bgreen%2110%21orange%7D%0A%5Cdefinecolor%7BMycolor2%7D%7BHTML%7D%7B00F9DE%7D%0A%5Cbegin%7Bdocument%7D%0AThis+document+presents+several+examples+showing+how+to+use+the+%5Ctexttt%7Bxcolor%7D+package+%0Ato+change+the+color+of+%5CLaTeX%7B%7D+page+elements.%0A%0A%5Cbegin%7Bitemize%7D%0A%5Citem+%5Ctextcolor%7BMycolor1%7D%7BFirst+item%7D%0A%5Citem+%5Ctextcolor%7BMycolor2%7D%7BSecond+item%7D%0A%5Cend%7Bitemize%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7BLightRubineRed%7D+%5Crule%7B%5Clinewidth%7D%7B1mm%7D%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7BRubineRed%7D+%5Crule%7B%5Clinewidth%7D%7B1mm%7D%7D%0A%5Cend%7Bdocument%7D) Este exemplo produz a seguinte saída: ![Cores personalizadas produzidas pelo pacote xcolor](/files/50f1819ede50b237a52adb4d214ddbd0a095e2cb) Neste exemplo são definidas três novas cores, cada uma de uma maneira diferente. * `\colorlet{LightRubineRed}{RubineRed!70}`: É criada uma nova cor chamada `LightRubineRed` esta cor tem 70% da intensidade da original `RubineRed` cor. Pode pensar nela como uma mistura de 70% de RubineRed e 30% de branco. Definir cores desta forma permite-lhe derivar diferentes tonalidades de uma cor principal — prática comum em branding corporativo. No exemplo, pode ver a cor original `RubineRed` e a nova `LightRubineRed` usadas em duas regras horizontais consecutivas. * `\colorlet{Mycolor1}{green!10!orange}`: É criada uma cor chamada `Mycolor1` com 10% de verde e 90% de laranja. * `\definecolor{Mycolor2}{HTML}{00F9DE}`: A cor `Mycolor2` é criada usando o `HTML` modelo. As cores neste modelo devem ser criadas com 6 dígitos hexadecimais; os caracteres A, B, C, D, E e F devem estar em maiúsculas. Os modelos de cor que o `xcolor` suporta apenas são: * `cmy`: ciano, magenta, amarelo * `hsb`: matiz, saturação, brilho * `HTML`: RRGGBB * `Gray`: Escala de cinzentos, um número entre 1 e 15. * `wave`: Comprimento de onda, um número entre 363 e 814. O número representa o comprimento de onda da luz, em nanómetros (nm) ## Definir a cor de fundo da página A cor de fundo de toda a página pode ser facilmente alterada com `\pagecolor`. O código seguinte demonstra isso, usando o texto de um exemplo anterior: ```latex \documentclass{article} \usepackage[dvipsnames]{xcolor} \colorlet{LightRubineRed}{RubineRed!70} \colorlet{Mycolor1}{green!10!orange} \definecolor{Mycolor2}{HTML}{00F9DE} \begin{document} \pagecolor{black} \color{white}% define a cor padrão como branco Este documento apresenta vários exemplos que mostram como usar o pacote \texttt{xcolor} para alterar a cor de elementos de página do \LaTeX{}. \begin{itemize} \item \textcolor{Mycolor1}{Primeiro item} \item \textcolor{Mycolor2}{Segundo item} \end{itemize} \noindent {\color{LightRubineRed} \rule{\linewidth}{1mm}} \noindent {\color{RubineRed} \rule{\linewidth}{1mm}} \end{document} ``` [Abra este exemplo no Overleaf](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Custom+colors+with+xcolor\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%5Bdvipsnames%5D%7Bxcolor%7D%0A%5Ccolorlet%7BLightRubineRed%7D%7BRubineRed%2170%7D%0A%5Ccolorlet%7BMycolor1%7D%7Bgreen%2110%21orange%7D%0A%5Cdefinecolor%7BMycolor2%7D%7BHTML%7D%7B00F9DE%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cpagecolor%7Bblack%7D%0A%5Ccolor%7Bwhite%7D%25+set+the+default+colour+to+white%0AThis+document+presents+several+examples+showing+how+to+use+the+%5Ctexttt%7Bxcolor%7D+package+%0Ato+change+the+color+of+%5CLaTeX%7B%7D+page+elements.%0A%0A%5Cbegin%7Bitemize%7D%0A%5Citem+%5Ctextcolor%7BMycolor1%7D%7BFirst+item%7D%0A%5Citem+%5Ctextcolor%7BMycolor2%7D%7BSecond+item%7D%0A%5Cend%7Bitemize%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7BLightRubineRed%7D+%5Crule%7B%5Clinewidth%7D%7B1mm%7D%7D%0A%0A%5Cnoindent%0A%7B%5Ccolor%7BRubineRed%7D+%5Crule%7B%5Clinewidth%7D%7B1mm%7D%7D%0A%5Cend%7Bdocument%7D) Este exemplo produz a seguinte saída: ![Definir a cor de fundo da página no LaTex](/files/9e84809c30c3be275933cd7985db51767c646682) O comando `\pagecolor{black}` definir a cor da página como `preto`. Este é um comando de alternância, o que significa que terá efeito em todo o documento a menos que outro comando de alternância seja usado para o reverter. `\nopagecolor` irá voltar a colocar o fundo no normal. ## Pacotes de cor adicionais para LuaLaTeX Para além dos `color` e `xcolor` pacotes padrão, o LuaLaTeX suporta os [`luacolor`](https://ctan.org/pkg/luacolor?lang=en) e [`lua-ul`](https://ctan.org/pkg/lua-ul?lang=en) pacotes — ambos foram escritos especificamente para uso com LuaLaTeX e nenhum é compatível com pdfLaTeX ou XeLaTeX. ### O pacote luacolor O `luacolor` redefine alguns internos dos comandos do pacote padrão `color` usando técnicas exclusivas dos motores TeX baseados em LuaTeX. Embora `luacolor` incorpora automaticamente o `color` pacote, se quiser fazer qualquer uma das seguintes coisas: * usar opções específicas do `color` pacote, tais como `\usepackage[usenames,dvipsnames]{color}`, ou * use o `xcolor` pacote é necessário carregar o `color` ou `xcolor` pacote antes de `luacolor`. Por exemplo, pode carregar o `color` pacote usando: ```latex \usepackage[usenames,dvipsnames]{color} % opções de exemplo do pacote color, consulte a documentação \usepackage{luacolor} % carregado depois do pacote color ``` ou carregue o `xcolor` pacote com: ```latex \usepackage[dvipsnames]{xcolor} % opção de exemplo do pacote xcolor, consulte a documentação \usepackage{luacolor} % carregado depois do pacote xcolor ``` Consulte a documentação de [`color`](http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf) e [`xcolor`](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf) para detalhes sobre as opções do pacote. Ao aproveitar as capacidades do LuaLaTeX, `luacolor` permite aplicações mais avançadas de cor; por exemplo, colorir glifos individuais dentro de linguagens de escrita complexas ou aplicar cor a marcas diacríticas. `luacolor` também evita problemas de kerning ao aplicar cor a caracteres isolados — veja as perguntas no tex.stackexchange [aqui](https://tex.stackexchange.com/questions/622544/kerning-when-coloring-single-letters) e [aqui](https://tex.stackexchange.com/questions/567220/kerning-with-xcolor) para exemplos disso. ### O pacote lua-ul Este pacote é mencionado porque tem funcionalidades de realce de cor. Aplica as capacidades avançadas do LuaTeX para fornecer sublinhado, rasurado e realce usando métodos em que o kerning não é afetado; o texto sublinhado pode usar comandos arbitrários, a hifenização funciona e as ligaduras são preservadas. ### Exemplo: luacolor Aqui, demonstraremos o uso de `luacolor` para colorir texto composto em hindi e árabe juntamente com diacríticos usados numa escrita latina (baseado em [este exemplo](https://tex.stackexchange.com/questions/698933/color-breaks-diacritics-stacking)). O exemplo seguinte usa o [pacote babel](/latex/overleaf-learn-latex-pt/idiomas/02-multilingual-typesetting-on-overleaf-using-babel-and-fontspec.md) para configurar o LuaLaTeX para compor hindi e árabe usando fontes presentes no Overleaf. ```latex \documentclass{article} % Prefira uma largura de página pequena para a demonstração \usepackage[paperwidth=15cm]{geometry} % Use o babel com as línguas árabe, hindi e inglês % O inglês é carregado por último, tornando-o a língua predefinida \usepackage[hindi,english]{babel} \babelprovide[import=ar]{arabic} % Defina a fonte Roman para o árabe \babelfont[arabic]{rm}{Scheherazade} % Defina as fontes Roman e sans serif para o inglês \babelfont{rm}{Noto Serif} \babelfont{sf}{Noto Sans} % Defina as fontes Roman e sem serifas para o hindi \babelfont[hindi]{rm}[Language=Default]{Noto Serif Devanagari} \babelfont[hindi]{sf}[Language=Default]{Noto Sans Devanagari} % Porque queremos usar a opção "dvipsnames" para % aceder a cores nomeadas adicionais, devemos carregar xcolor % antes de luacolor (consulte a documentação do pacote luacolor) \usepackage[dvipsnames]{xcolor} \usepackage{luacolor} % Criar um comando de conveniência para compor hindi \newcommand\hinditext[1]{\foreignlanguage{hindi}{#1}} % Criar um comando de conveniência para compor árabe \newcommand\arabictext[1]{\foreignlanguage{arabic}{#1}} \usepackage{hyperref} \hypersetup{ colorlinks=true, urlcolor=cyan } \begin{document} % As fontes Noto beneficiam de um espaçamento entre linhas maior \setlength{\baselineskip}{14bp} \section{Colorir texto em hindi} O Google traduz a palavra hindi \textsf{\hinditext{किंकर्तव्यविमूढ़}} como ``perplexo''. Usando o pacote \texttt{luacolor} é possível colorir glifos dentro do texto hindi; por exemplo \hinditext{किंक\textcolor{purple}{र्तव्यव}\textcolor{green}{िमूढ़}}. Também pode adicionar cor à palavra inteira: \hinditext{\textcolor{blue}{किंकर्तव्यविमूढ़}}. \section{Colorir texto em árabe} % Criar um ambiente personalizado para % compor texto árabe colorido \newenvironment{colorarabic} {% Compor árabe usando uma fonte maior \fontsize{30}{30} % Definir direções de parágrafo e de texto da direita para a esquerda \pardir TRT\textdir TRT} {} Aqui está algum texto árabe colorido: \begin{colorarabic} \textcolor{red}{\arabictext{هَذَا}} \arabictext{نَصٌّ عَرَب}\textcolor{green}{\arabictext{ِ}}\arabictext{ي}\textcolor{blue}{\arabictext{ٌّ}} \end{colorarabic} \section{Colorização de diacríticos} Este exemplo é baseado em \href{https://tex.stackexchange.com/questions/698933/color-breaks-diacritics-stacking}{código do tex.stackexchange}. \vspace{12pt} \bgroup \newcommand{\emptydiacritic}{\char"034F} \fontsize{60}{60}\selectfont á̀̐{\color{blue}a\emptydiacritic\color{green}́\color{red}̀\color{magenta}̐ \egroup \end{document} ``` [Abra este exemplo do luacolor no Overleaf.](/latex/overleaf-learn-latex-pt/formatacao/13-using-colors-in-latex.md) Este exemplo produz a seguinte saída: ![exemplo de saída usando o pacote luacolor](/files/d4c671204fc01a8638b5b29d6443bb2ec02272cb) ### Exemplo: lua-ul Este exemplo demonstra o seguinte `lua-ul` comandos do pacote: * `\highLight[*color*]{*text to highlight*}` que aplica a (opcional) `*color*` para `*text to highlight*`. Observe a capital **`E`** na grafia de `\high**L**ight` comando! * `\LuaULSetHighLightColor{*default color*}`: isto define a `*default color*` usado pelo `\highLight` comando quando a opcional `[*color*]` não é especificada. Nota: o `luacolor` pacote também deve ser carregado ao usar o `\highLight` comando fornecido pelo `lua-ul` pacote. ```latex \documentclass{article} % Prefira uma largura de página pequena para a demonstração \usepackage[paperwidth=12cm]{geometry} \usepackage[dvipsnames]{xcolor} % Para aceder a algumas cores nomeadas usadas com \highLight \usepackage{luacolor} % Necessário para usar o comando \highLight do lua-ul \usepackage{lua-ul} \usepackage{blindtext} \begin{document} % Use a cor Apricot para destacar o texto \highLight[Apricot]{\blindtext} % Use \LuaULSetHighLightColor para definir cores predefinidas para % o comando \highLight \begin{itemize} \item \LuaULSetHighLightColor{CornflowerBlue} \highLight{\blindtext[1]}. \item \LuaULSetHighLightColor{Goldenrod}\highLight{{\(y=f(x)\)}} \end{itemize} \end{document} ``` [Abra este `lua-ul` exemplo no Overleaf.](https://www.overleaf.com/docs?engine=lualatex\&snip_name=lua-ul+package+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%25+Prefer+a+small+page+width+for+the+demo%0A%5Cusepackage%5Bpaperwidth%3D12cm%5D%7Bgeometry%7D%0A++%0A%5Cusepackage%5Bdvipsnames%5D%7Bxcolor%7D+%25+To+access+some+named+colors+used+with+%5ChighLight%0A%5Cusepackage%7Bluacolor%7D+%25+Required+to+use+the+lua-ul+%5ChighLight+command+%0A%5Cusepackage%7Blua-ul%7D+%0A++%0A%5Cusepackage%7Bblindtext%7D%0A%5Cbegin%7Bdocument%7D%0A%25+Use+the+Apricot+color+to+highlight+the+text++%0A%5ChighLight%5BApricot%5D%7B%5Cblindtext%7D+%0A%0A%25+Use+%5CLuaULSetHighLightColor+to+set+default+colors+for+%0A%25+the+%5ChighLight+command%0A%5Cbegin%7Bitemize%7D%0A++++%5Citem+%5CLuaULSetHighLightColor%7BCornflowerBlue%7D+%5ChighLight%7B%5Cblindtext%5B1%5D%7D.%0A++++%5Citem+%5CLuaULSetHighLightColor%7BGoldenrod%7D%5ChighLight%7B%7B%5C%28y%3Df%28x%29%5C%29%7D%7D%0A%5Cend%7Bitemize%7D%0A%5Cend%7Bdocument%7D) Este exemplo produz a seguinte saída: ![Destacar texto com o pacote lua-ul](/files/7c58db1c389a18f6655b40b6190d216d5e6b4ca5) ## Leitura adicional Para mais informações, consulta: * [O **color** documentação do pacote](http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf) (ou [acesso via `texdoc.org`](https://texdoc.org/serve/color/5)) * [O **xcolor** documentação do pacote](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf) (ou [acesso via `texdoc.org`](https://texdoc.org/serve/xcolor/0)) * [Comprimentos em LaTeX](/latex/overleaf-learn-latex-pt/formatacao/01-lengths-in-latex.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) * [Suporte a fontes modernas com XeLaTeX](/latex/overleaf-learn-latex-pt/fontes/03-xelatex.md) * [Tabelas](/latex/overleaf-learn-latex-pt/figuras-e-tabelas/01-tables.md) * [Inserção de imagens](/latex/overleaf-learn-latex-pt/mais-topicos/27-inserting-images.md) * [Beamer](/latex/overleaf-learn-latex-pt/apresentacoes/01-beamer.md) * [Powerdot](/latex/overleaf-learn-latex-pt/apresentacoes/02-powerdot.md) * [Cartazes](/latex/overleaf-learn-latex-pt/apresentacoes/03-posters.md) --- # 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/formatacao/13-using-colors-in-latex.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.