> 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/fi/muotoilu/13-using-colors-in-latex.md).

# Värien käyttö LaTeXissa

## Johdanto

Tässä artikkelissa selitetään, miten värejä käytetään LaTeX-asiakirjassasi käyttäen [`värin`](https://ctan.org/pkg/color?lang=en) tai [`xcolor`](https://ctan.org/pkg/xcolor?lang=en) paketteja. Huomaa, että käyttäjätason dokumentaatio `värin` paketista on [LaTeXin vakio-grafiikkapaketti](http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf).

Molemmat paketit tarjoavat yhteisen joukon komentoja värien käsittelyyn, mutta `xcolor` on joustavampi ja tukee suurempaa määrää värimalleja, joten se on suositeltu tapa.

Aloitamme seuraavalla esimerkillä:

```latex
\documentclass{article}
\usepackage{xcolor}
\begin{document}
Tämä esimerkki näyttää muutamia tapoja käyttää \texttt{xcolor}-pakettia
elementtien värin muuttamiseen \LaTeXissa.

\begin{itemize}
\color{blue}
\item Ensimmäinen kohta
\item Toinen kohta
\end{itemize}

\noindent
{\color{red} \rule{\linewidth}{0.5mm}}
\end{document}
```

[Avaa tämä `xcolor` esimerkki Overleafissa](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![xcolor-paketin käyttöesimerkki LaTeXissa](/files/fdd6554b1c50200f2bb44d477a1c788118819254)

Tässä esimerkissä paketti `xcolor` tuodaan valinnalla

```latex
\usepackage{xcolor}
```

sitten komento `\color{blue}` asettaa `blue` värin nykyiselle tekstilohkolle. Tässä tapauksessa `itemize` ympäristössä.

Koodi, jolla ladotaan vaakaviiva, jonka luo `\rule{\linewidth}{0.5mm}` on ryhmässä, jonka rajina ovat { ja }, jotta `\color{red}` vaikutukset pysyvät paikallisina kyseiseen ryhmään.

## xcolor-paketin tarjoamat nimetyt värit

Kuten todetaan [xcolor-paketin dokumentaatiossa](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf), seuraavat nimetyt värit ovat aina käytettävissä ilman, että mitään pakettivalintoja tarvitsee ladata:

![xcolor-paketin väriluettelo](/files/bce86eaedf19f2001813fffe13665520d02751e8)

### Muiden nimettyjen värien käyttäminen

Muita nimettyjä värejä voidaan käyttää seuraavien `xcolor` pakettivalintojen kautta:

* `dvipsnames`: lataa 68 nimettyä väriä (CMYK)
* `svgnames`: lataa 151 nimettyä väriä (RGB)
* `x11names`: lataa 317 nimettyä väriä (RGB)

Esimerkiksi, jos kirjoitat

```latex
\usepackage[dvipsnames]{xcolor}
```

voit käyttää seuraavia nimettyjä värejä:

![xcolor-paketin dvipsnames-valinnalla ladatut värit](/files/cfb23970bdadeac291ce71606ba43d83dae6342a)

Katso [xcolor-paketin dokumentaatiossa](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf) taulukoituja luetteloita väreistä, joita tarjoavat `svgnames` ja `x11names` valinnat.

### Esimerkkikäyttö

Seuraava esimerkki käyttää nimettyjä värejä, jotka on ladattu valinnalla `dvipsnames` vaihtoehto.

```latex
\documentclass{article}
\usepackage[dvipsnames]{xcolor}
\begin{document}
Tämä esimerkki näyttää, miten \texttt{xcolor}-pakettia käytetään
\LaTeX{}-sivun elementtien värin muuttamiseen.

\begin{itemize}
\color{ForestGreen}
\item Ensimmäinen kohta
\item Toinen kohta
\end{itemize}

\noindent
{\color{RubineRed} \rule{\linewidth}{0.5mm}}

Tekstin taustavärikin voidaan asettaa \textcolor{red}{helposti}. Esimerkiksi
voit käyttää \colorbox{BurntOrange}{oranssia taustaa} ja jatkaa sitten kirjoittamista.
\end{document}
```

[Avaa tämä `**xcolor**` esimerkki Overleafissa](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![xcolor-paketin esittely](/files/9d049001631245b42c6a3c02ec5cdb5a5768918b)

Esimerkissä käytetään myös kahta uutta komentoa:

* `\textcolor{red}{helposti}`: Muuttaa rivissä olevan tekstin väriä. Tämä komento ottaa kaksi parametria: käytettävän värin ja sen tekstin, jonka väriä muutetaan. Esimerkissä sana `helposti` tulostetaan värillä `punainen`.
* `\colorbox{BurntOrange}{oranssi tausta}`: Muuttaa toisena argumenttina annetun tekstin taustavärin. Yllä olevassa esimerkissä sanat `oranssi tausta` ladotaan taustavärillä `BurntOrange`.

## Nimetyjen värien lataaminen ja käyttäminen color-paketissa

Voit myös käyttää `värin` pakettia ja ladata nimettyjä värejä sen `usenames` ja `dvipsnames` pakettivalintojen kautta:

```latex
\usepackage[usenames,dvipsnames]{color}
```

Seuraava koodi käyttää `värin` pakettia samoihin nimettyihin väreihin kuin edellisessä `xcolor` pakettiesimerkissä.

```latex
\documentclass{article}
\usepackage[usenames,dvipsnames]{color} % using the color package, not xcolor
\begin{document}
Tämä esimerkki näyttää, miten \texttt{\bfseries color} -pakettia käytetään
\LaTeX{}-sivun elementtien värin muuttamiseen.

\begin{itemize}
\color{ForestGreen}
\item Ensimmäinen kohta
\item Toinen kohta
\end{itemize}

\noindent
{\color{RubineRed} \rule{\linewidth}{0.5mm}}

Tekstin taustavärikin voidaan asettaa \textcolor{red}{helposti}. Esimerkiksi
voit käyttää \colorbox{BurntOrange}{oranssia taustaa} ja jatkaa sitten kirjoittamista.
\end{document}
```

[Avaa tämä `**color**` esimerkki Overleafissa](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)

Tämä esimerkki tuottaa saman tulosteen kuin edellinen `xcolor` versio:

![color-paketin esittely](/files/4f0792d4c060c5c7b857572611ad28383d8e5a73)

## Ajurit ja väri

Värien käyttö tekstin tai matematiikan ladonnassa ei kuulunut TeX:n alkuperäiseen suunnitteluun; sen sijaan värien käyttö/soveltaminen annettiin ulkoisille “ajureille”, jotka muunsivat TeX:n alkuperäisen tulostiedostomuodon (DVI) PostScriptiksi tai PDF:ksi. Jotta värit toimisivat, ajurikohtaiset ohjeet täytyi “ruiskuttaa” TeX:n tulosteeseen käyttämällä sisäänrakennettua TeX-komentoa nimeltä `\special` jonka tehtävänä on yksinkertaisesti sallia koodin/datan kulkea ladontaprosessin läpi ja upottua tulostiedostoon. Kun valittu ajuri (ohjelmisto) käsitteli ladotun tulosteen, se havaitsi upotetun koodin/datan ja toimi sen mukaan saavuttaakseen sen, mitä käyttäjä tarkoitti — esimerkiksi värien käytön.

Ajan myötä asiat ovat muuttuneet, ja PDF on nykyään ylivoimaisesti yleisin TeX-moottoreiden käyttämä tulostusmuoto, joka on pitkälti syrjäyttänyt vanhat DVI-ajurit ja PostScriptin luomisen. Käyttäjillä on myös enemmän valinnanvaraa TeX-moottoreissa LaTeX-asiakirjojensa ladontaan, erityisesti pdfTeX, XeTeX tai LuaTeX/LuaHBTeX, joten näiden TeX-moottoreiden erojen huomioon ottaminen on yhä tärkeää — ja on varmistettava, että oikeita mekanismeja käytetään väridatan (PDF-ohjeiden) lisäämiseen PDF-tiedostoihin. Jotta vanha DVI-tulostusmuoto sekä laajempi käytössä olevien TeX-moottorien ja työnkulkujen ympäristö voidaan tukea ja huomioida, voit tarvittaessa määrittää `värin` tai `xcolor` paketit käyttämään tiettyä “ajuria”, jotta LaTeX tuottaa väridataa käyttäen asianmukaista menetelmää.

### Ajurit color- ja xcolor-paketeille

Se `värin` paketti tarjoaa valmiin tuen seuraaville ajurivalinnoille:

* `dvipdfmx`, `dvips`, `dvisvgm`, `luatex`, `pdftex` ja `xetex`

Muita vaihtoehtoja on kuvattu [`värin` pakettidokumentaatio](https://mirror.ox.ac.uk/sites/ctan.org/macros/latex/required/graphics/grfguide.pdf).

Se `xcolor` paketti tarjoaa seuraavat ajurivalinnat:

* `dvips`, `xdvi`, `dvipdf`, `dvipdfm`, `dvipdfmx`, `luatex`, `pdftex`, `dvipsone`, `dviwindo`, `emtex`, `dviwin`, `oztex`, `textures`, `pctexps`, `pctexwin`, `pctexhp`, `pctex32`, `truetex`, `tcidvi`, `vtex` ja `xetex`.

### Ajurin automaattinen tunnistus väreille

Kun asiakirjaasi ladotaan, LaTeX lukee asetustiedoston nimeltä `color.cfg` joka sisältää koodia, joka voi määrittää, käytätkö pdfTeX:iä, XeTeX:iä vai LuaTeX:iä, ja lataa automaattisesti sopivan ajurin (`.def` tiedoston) puolestasi, joten sinun ei tarvitse *tarvitse* määrittää ajuripaketin valintaa näille moottoreille.

### Edistyneempi esimerkki, jossa käytetään dvisvgm-ajuria SVG-tiedoston luomiseen

Seuraava esimerkki käyttää `värin` pakettia valinnoilla, jotka lataavat nimetyt värit ja `dvisvgm` ajuria värimäärittelyjen/datan tulostamiseen SVG-koodina:

```latex
\usepackage[dvisvgm, usenames, dvipsnames]{color}
```

Tarkemmin sanottuna Overleafin ladoma tulostiedosto muunnetaan SVG:ksi ohjelmalla nimeltä [`dvisvgm`](https://dvisvgm.de/), joka kuuluu TeX Liveen ja on saatavilla palvelimillamme. Jotta voidaan ajaa `dvisvgm`, sivun ladonnan jälkeen käytämme [`latexmkrc` tiedostoa](/latex/fi/syvalliset-artikkelit/28-how-to-use-latexmkrc-with-overleaf.md) joka luodaan, kun avaat seuraavan koodin Overleafissä:

```latex
\documentclass{article}
\usepackage[dvisvgm, usenames, dvipsnames]{color}
\title{Creating SVG graphics}
\author{Overleaf}
\begin{document}
\maketitle
Hello, {\color{Apricot}Apricot-värillä} ja nyt {\color{DarkOrchid} DarkOrchid-värillä}, mutta ehkä se näyttäisi paremmalta, jos käyttäisimme {\color{JungleGreen}JungleGreenia}—vai ei?
\end{document}
```

[Avaa tämä esimerkki SVG-tiedoston luomiseksi](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)

Kun Overleaf on saanut käännöksen valmiiksi, voit käyttää SVG-grafiikkaa nimeltä `mygraphic.svg`, valitsemalla `Lokit ja tulosteet` ja valitsemalla `Muut lokit ja tiedostot` pudotusvalikosta:

![Luodun tiedoston käyttäminen Overleafissä](/files/a3d3f6404cf2e942e828a7c13deb57fb511f7f3b)

## Omien värien luominen

Voit määrittää omia värejäsi; tapa, jolla väri määritellään, riippuu valitusta värimallista. Seuraava esimerkki käyttää neljää värimallia.

```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}
Käyttäjän määrittämät värit eri värimalleilla:

\begin{enumerate}
\item \textcolor{mypink1}{Vaaleanpunainen rgb-mallilla}
\item \textcolor{mypink2}{Vaaleanpunainen RGB-mallilla}
\item \textcolor{mypink3}{Vaaleanpunainen cmyk-mallilla}
\item \textcolor{mygray}{Harmaa harmaasävyllä}
\end{enumerate}
\end{document}
```

[Avaa tämä esimerkki Overleafissa](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![LaTeX-esimerkki käyttäjän määrittämien värien luomisesta](/files/362190614d93ee2200a0b33bc41433a84a938a9c)

Komento `\definecolor` ottaa kolme parametria: uuden värin nimen, mallin ja värimäärittelyn. Karkeasti ottaen kukin luku ilmaisee, kuinka paljon kutakin väriä lisätään seokseen, josta lopullinen väri muodostuu.

* `**rgb**`: Punainen, vihreä, sininen. Kolme pilkuilla erotettua arvoa väliltä 0 ja 1 määrittävät värin osat.
* `**RGB**`: Sama kuin `rgb`, mutta luvut ovat kokonaislukuja väliltä 0 ja 255.
* `**cmyk**`: Syaani, magenta, keltainen ja musta. Pilkuilla erotettu neljän luvun luettelo väliltä 0 ja 1, joka määrittää värin [vähentävän CMYK-mallin](https://en.wikipedia.org/wiki/CMYK_color_model) mukaan, jota käytetään kaupallisessa painatuksessa.
* `**gray**`: Harmaasävy. Yksi luku väliltä 0 ja 1.

Esimerkissä `mypink1`, `mypink2` ja `mypink3` määrittävät saman värin, mutta eri malleilla. Voit itse asiassa nähdä, että se, jonka on määrittänyt `cmyk` on hieman erilainen.

Kummallakin mallilla määritellyt värit voidaan myöhemmin käyttää asiakirjassasi paitsi tekstin värin asettamiseen myös mihin tahansa muuhun elementtiin, joka ottaa värin parametrina, esimerkiksi [taulukoita](/latex/fi/kuvat-ja-taulukot/01-tables.md#colouring-a-table-28cells2c-rows2c-columns-and-lines29) (sinun täytyy lisätä `table` valinta `xcolor`), [TikZillä luotuihin graafisiin elementteihin](/latex/fi/kuvat-ja-taulukot/05-tikz-package.md), [kuvioihin](/latex/fi/alakohtaiset/08-pgfplots-package.md), [pystyviivoihin monipalsta-asiakirjoissa](/latex/fi/muotoilu/09-multiple-columns.md#inserting-vertical-rulers) ja [koodiluetteloihin](/latex/fi/muotoilu/11-code-listing.md#code-styles-and-colours).

### vain xcolorissa tuetut värimallit

Se `xcolor` paketti tarjoaa lisäkomentoja, jotka tukevat useampia värimalleja ja helppoa värisekoitusta, kuten seuraava esimerkki osoittaa:

```latex
\documentclass{article}
\usepackage[dvipsnames]{xcolor}
\colorlet{LightRubineRed}{RubineRed!70}
\colorlet{Mycolor1}{green!10!orange}
\definecolor{Mycolor2}{HTML}{00F9DE}
\begin{document}
Tämä asiakirja esittelee useita esimerkkejä, jotka näyttävät, miten \texttt{xcolor}-pakettia käytetään
\LaTeX{}-sivun elementtien värin muuttamiseen.

\begin{itemize}
\item \textcolor{Mycolor1}{Ensimmäinen kohta}
\item \textcolor{Mycolor2}{Toinen kohta}
\end{itemize}

\noindent
{\color{LightRubineRed} \rule{\linewidth}{1mm}}

\noindent
{\color{RubineRed} \rule{\linewidth}{1mm}}
\end{document}
```

[Avaa tämä esimerkki Overleafissa](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![xcolor-paketin tuottamat mukautetut värit](/files/a7cea0b36ad48dbe53b63b8a8b53f4c0b5b2babf)

Tässä esimerkissä määritellään kolme uutta väriä, kukin eri tavalla.

* `\colorlet{LightRubineRed}{RubineRed!70}`: Uusi väri nimeltä `LightRubineRed` luodaan; tällä värillä on 70 % alkuperäisen `RubineRed` värin intensiteetistä. Sen voi ajatella seoksena, jossa on 70 % RubineRediä ja 30 % valkoista. Tällaisten värien määrittelyllä voit johtaa pääväristä erilaisia sävyjä — yleinen käytäntö yritysbrändäyksessä. Esimerkissä voit nähdä alkuperäisen `RubineRed` ja uuden `LightRubineRed` käytettynä kahdessa peräkkäisessä vaakaviivassa.
* `\colorlet{Mycolor1}{green!10!orange}`: Väri nimeltä `Mycolor1` luodaan 10 %:lla vihreää ja 90 %:lla oranssia.
* `\definecolor{Mycolor2}{HTML}{00F9DE}`: Väri `Mycolor2` luodaan käyttäen `HTML` mallia. Tämän mallin värit on luotava kuudella heksadesimaalimerkillä, ja kirjainten A, B, C, D, E ja F on oltava isoja.

Värimallit, joita se tukee vain `xcolor` ovat:

* `cmy`: syaani, magenta, keltainen
* `hsb`: sävy, kylläisyys, kirkkaus
* `HTML`: RRGGBB
* `Gray`: Harmaasävy, luku 1:n ja 15:n välillä.
* `wave`: Aallonpituus, luku 363:n ja 814:n välillä. Luku edustaa valon aallonpituutta nanometreinä (nm)

## Sivun taustavärin asettaminen

Koko sivun taustaväri voidaan helposti muuttaa komennolla `\pagecolor`. Seuraava koodi havainnollistaa tätä käyttäen aiemman esimerkin tekstiä::

```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}% aseta oletusväri valkoiseksi
Tämä asiakirja esittelee useita esimerkkejä, jotka näyttävät, miten \texttt{xcolor}-pakettia käytetään
\LaTeX{}-sivun elementtien värin muuttamiseen.

\begin{itemize}
\item \textcolor{Mycolor1}{Ensimmäinen kohta}
\item \textcolor{Mycolor2}{Toinen kohta}
\end{itemize}

\noindent
{\color{LightRubineRed} \rule{\linewidth}{1mm}}

\noindent
{\color{RubineRed} \rule{\linewidth}{1mm}}
\end{document}
```

[Avaa tämä esimerkki Overleafissa](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Sivun taustavärin asettaminen LaTeXissa](/files/c66378843477589ebd44a25393922ce8a4a3a19d)

Komento `\pagecolor{black}` aseta sivun väriksi `musta`. Tämä on kytkentäkomento, eli se vaikuttaa koko asiakirjassa, ellei toista kytkentäkomentoa käytetä sen palauttamiseen. `\nopagecolor` palauttaa taustan normaaliksi.

## Lisäväripaketit LuaLaTeXille

Vakiopakettien lisäksi `värin` ja `xcolor` LuaLaTeX tukee [`luacolor`](https://ctan.org/pkg/luacolor?lang=en) ja [`lua-ul`](https://ctan.org/pkg/lua-ul?lang=en) paketteja — molemmat on kirjoitettu erityisesti LuaLaTeXia varten, eikä kumpikaan ole yhteensopiva pdfLaTeXin tai XeLaTeXin kanssa.

### luacolor-paketti

Se `luacolor` paketti määrittelee uudelleen joitakin standardin `värin` paketin komentojen sisäisiä toimintoja käyttäen LuaTeX-pohjaisten TeX-moottoreiden ainutlaatuisia tekniikoita.

Vaikka `luacolor` sisällyttää automaattisesti `värin` paketin, jos haluat tehdä jommankumman seuraavista:

* käyttää tiettyjä `värin` paketin valintoja, kuten `\usepackage[usenames,dvipsnames]{color}`, tai
* käytä `xcolor` paketti

sinun täytyy ladata `värin` tai `xcolor` paketti ennen `luacolor`. Esimerkiksi voit ladata `värin` paketin käyttäen:

```latex
\usepackage[usenames,dvipsnames]{color} % esimerkki color-paketin valinnoista, katso dokumentaatio
\usepackage{luacolor} % ladattu color-paketin jälkeen
```

tai lataa `xcolor` paketti valinnalla:

```latex
\usepackage[dvipsnames]{xcolor} % esimerkki xcolor-paketin valinnasta, katso dokumentaatio
\usepackage{luacolor} % ladattu xcolor-paketin jälkeen
```

Katso [`värin`](http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf) ja [`xcolor`](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf) pakettivalintojen yksityiskohdat dokumentaatiosta.

Hyödyntämällä LuaLaTeXin ominaisuuksia, `luacolor` mahdollistaa värin edistyneemmät käyttötavat; esimerkiksi yksittäisten glyfien värjäämisen monimutkaisissa kirjoitusjärjestelmissä tai värin lisäämisen diakriittisiin merkkeihin. `luacolor` välttää myös kirjainvälitysongelmat, kun väriä käytetään yksittäisiin merkkeihin — katso tex.stackexchange-kysymykset [täällä](https://tex.stackexchange.com/questions/622544/kerning-when-coloring-single-letters) ja [täällä](https://tex.stackexchange.com/questions/567220/kerning-with-xcolor) esimerkeiksi siitä.

### lua-ul-paketti

Tämä paketti mainitaan, koska siinä on värikorostusominaisuuksia. Se hyödyntää LuaTeXin kehittyneitä ominaisuuksia tarjotakseen alleviivauksen, yliviivauksen ja korostuksen menetelmin, joissa kirjainväliin ei vaikuteta, alleviivattu teksti voi käyttää mielivaltaisia komentoja, tavutus toimii ja ligatuurit säilyvät.

### Esimerkki: luacolor

Tässä näytetään, miten käytetään `luacolor` värjäämään tekstiä, joka on ladottu hindiksi ja arabiaksi, yhdessä latinalaisessa kirjaimistossa käytettyjen diakriittien kanssa (perustuen [tämä esimerkki](https://tex.stackexchange.com/questions/698933/color-breaks-diacritics-stacking)). Seuraava esimerkki käyttää [babel-pakettia](/latex/fi/kielet/02-multilingual-typesetting-on-overleaf-using-babel-and-fontspec.md) määrittämään LuaLaTeXin latoakseen hindin ja arabian Overleafissä olevilla fonteilla.

```latex
\documentclass{article}

% Suosi pientä sivuleveyttä demoa varten
\usepackage[paperwidth=15cm]{geometry}

% Käytä babelia arabian, hindin ja englannin kielille
% Englanti ladataan viimeisenä, jolloin siitä tulee oletuskieli
\usepackage[hindi,english]{babel}
\babelprovide[import=ar]{arabic}
% Aseta roomalainen fontti arabiaksi
\babelfont[arabic]{rm}{Scheherazade}

% Aseta roomalaiset ja päätteettömät fontit englannille
\babelfont{rm}{Noto Serif}
\babelfont{sf}{Noto Sans}

% Aseta roomalaiset ja päätteettömät fontit hindille
\babelfont[hindi]{rm}[Language=Default]{Noto Serif Devanagari}
\babelfont[hindi]{sf}[Language=Default]{Noto Sans Devanagari}

% Koska haluamme käyttää "dvipsnames"-valintaa
% lisänimetyillä väreillä, meidän on ladattava xcolor
% ennen luacoloria (katso luacolor-paketin dokumentaatio)
\usepackage[dvipsnames]{xcolor}
\usepackage{luacolor}

% Luo käteiskomento hindin ladontaan
\newcommand\hinditext[1]{\foreignlanguage{hindi}{#1}}

% Luo käteiskomento arabian ladontaan
\newcommand\arabictext[1]{\foreignlanguage{arabic}{#1}}

\usepackage{hyperref}
\hypersetup{
colorlinks=true,
urlcolor=cyan
}
\begin{document}
% Noto-fontit hyötyvät suuremmasta rivivälistä
\setlength{\baselineskip}{14bp}

\section{Hindinkielisen tekstin värjääminen}
Google kääntää hindin sanan \textsf{\hinditext{किंकर्तव्यविमूढ़}} muodossa
``hämmentynyt''. Käyttämällä \texttt{luacolor}-pakettia on mahdollista värjätä hindinkielisen tekstin glyfejä; esimerkiksi \hinditext{किंक\textcolor{purple}{र्तव्यव}\textcolor{green}{िमूढ़}}. Voit myös lisätä väriä koko sanaan: \hinditext{\textcolor{blue}{किंकर्तव्यविमूढ़}}.

\section{Arabian tekstin värjääminen}
% Luo mukautettu ympäristö
% ladottamaan värillistä arabian tekstiä
\newenvironment{colorarabic}
{% Lado arabiaa suuremmalla fontilla
\fontsize{30}{30}
% Aseta kappaleen ja tekstin suunnaksi oikealta vasemmalle
\pardir TRT\textdir TRT}
{}

Tässä on hieman värjättyä arabian tekstiä:  \begin{colorarabic}
\textcolor{red}{\arabictext{هَذَا}} \arabictext{نَصٌّ عَرَب}\textcolor{green}{\arabictext{ِ}}\arabictext{ي}\textcolor{blue}{\arabictext{ٌّ}}
\end{colorarabic}
\section{Diakriittisten merkkien väritys}
Tämä esimerkki perustuu \href{https://tex.stackexchange.com/questions/698933/color-breaks-diacritics-stacking}{koodiin tex.stackexchange-sivustolta}.

\vspace{12pt}
\bgroup
\newcommand{\emptydiacritic}{\char"034F}
\fontsize{60}{60}\selectfont
á̀̐{\color{blue}a\emptydiacritic\color{green}́\color{red}̀\color{magenta}̐
\egroup
\end{document}
```

[Avaa tämä luacolor-esimerkki Overleafissa.](/latex/fi/muotoilu/13-using-colors-in-latex.md)

Tämä esimerkki tuottaa seuraavan tulosteen:

![luacolor-paketin esimerkkituloste](/files/152c8459369e47aa81b9c90355c868d0a0ddc164)

### Esimerkki: lua-ul

Tämä esimerkki havainnollistaa seuraavia `lua-ul` paketin komentoja:

* `\highLight[*color*]{*text to highlight*}` joka soveltaa (valinnaista) `*color*` kohteeseen `*text to highlight*`. Huomaa iso **`V`** kirjoitusasussa `\high**L**ight` komento!
* `\LuaULSetHighLightColor{*default color*}`: tämä asettaa `*default color*` käytetään komennossa `\highLight` komennon, kun valinnaista `[*color*]` ei ole määritetty.

Huomaa: `luacolor` paketti on myös ladattava käytettäessä `\highLight` komentoa, jonka tarjoaa `lua-ul` pakettiin.

```latex
\documentclass{article}
% Suosi pientä sivuleveyttä demoa varten
\usepackage[paperwidth=12cm]{geometry}

\usepackage[dvipsnames]{xcolor} % Pääsyyn joihinkin nimettyihin väreihin, joita käytetään \highLight-komennon kanssa
\usepackage{luacolor} % Vaaditaan lua-ul \highLight -komennon käyttämiseen
\usepackage{lua-ul}

\usepackage{blindtext}
\begin{document}
% Käytä Apricot-väriä tekstin korostamiseen
\highLight[Apricot]{\blindtext}

% Käytä \LuaULSetHighLightColor-komentoa asettaaksesi oletusvärit
% \highLight-komennolle
\begin{itemize}
    \item \LuaULSetHighLightColor{CornflowerBlue} \highLight{\blindtext[1]}.
    \item \LuaULSetHighLightColor{Goldenrod}\highLight{{\(y=f(x)\)}}
\end{itemize}
\end{document}
```

[Avaa tämä `lua-ul` esimerkki Overleafissa.](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)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Tekstin korostaminen lua-ul-paketilla](/files/336930d4db2a9195b5ca6e8525ef981c547dd05e)

## Lisälukemista

Lisätietoja löydät:

* [Se **värin** pakettidokumentaatio](http://mirrors.ctan.org/macros/latex/required/graphics/grfguide.pdf) (tai [käytettävissä osoitteessa `texdoc.org`](https://texdoc.org/serve/color/5))
* [Se **xcolor** pakettidokumentaatio](http://mirrors.ctan.org/macros/latex/contrib/xcolor/xcolor.pdf) (tai [käytettävissä osoitteessa `texdoc.org`](https://texdoc.org/serve/xcolor/0))
* [Pituudet LaTeXissa](/latex/fi/muotoilu/01-lengths-in-latex.md)
* [Kirjasinkoot, -perheet ja -tyylit](/latex/fi/fontit/01-font-sizes-families-and-styles.md)
* [Kirjasinlajit](/latex/fi/fontit/02-font-typefaces.md)
* [Modernien fonttien tuki XeLaTeXillä](/latex/fi/fontit/03-xelatex.md)
* [Taulukot](/latex/fi/kuvat-ja-taulukot/01-tables.md)
* [Kuvien lisääminen](/latex/fi/lisaa-aiheita/27-inserting-images.md)
* [Beamer](/latex/fi/esitykset/01-beamer.md)
* [Powerdot](/latex/fi/esitykset/02-powerdot.md)
* [Julisteet](/latex/fi/esitykset/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/fi/muotoilu/13-using-colors-in-latex.md?ask=<question>&goal=<endgoal>
```

`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.