> 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/fontit/03-xelatex.md). # Nykyaikaisten fonttien tuki XƎLaTeXilla ## Johdanto [XeTeX](https://tug.org/xetex/) on ladontamoottori, joka on johdettu Donald Knuthin alkuperäisestä TeX-ohjelmistosta. Toisin kuin Knuthin alkuperäinen ohjelma, XeTeX lukee natiivisti (syötteenä) UTF-8-koodattua Unicode-tekstiä ja sisäänrakennetun [HarfBuzz](https://harfbuzz.github.io/) sovitusmoottorin avulla tukee nykyaikaisia fonttiformaatteja, kuten [OpenType (OTF)](https://docs.microsoft.com/en-us/typography/opentype/) ja [SIL:n Graphite-fonttiteknologiaa](https://scripts.sil.org/cms/scripts/page.php?site_id=projects\&item_id=graphite_home). Vastaava LaTeX [kääntäjä](/latex/fi/lisaa-aiheita/08-choosing-a-latex-compiler.md) Overleafissa on nimeltään `xelatex`. Jos haluat ymmärtää paremmin eri TeX-moottorien kehitystä, kannattaa ehkä lukea Overleafin artikkeli [Mitä nimessä on: opas TeXin moniin muunnoksiin](/latex/fi/syvalliset-artikkelit/55-what-s-in-a-name-a-guide-to-the-many-flavours-of-tex.md). ## Perusteet: Times New Roman Times New Roman on yleisesti käytetty fontti, ja tässä on esimerkki sen käytöstä Overleafissa XeLaTeX-kääntäjän kautta. Tässä esimerkissä dokumentin fontti asetetaan käyttäen `\usemainfont{Times New Roman}`, jossa komento `\usemainfont{...}` on paketin tarjoama `fontspec`. ```latex \documentclass[12pt]{article} \usepackage{fontspec} \setmainfont{Times New Roman} \title{Esimerkkifonttidokumentti} \author{Overleaf} \date{\today} \begin{document} \maketitle Tämä on \textit{esimerkki} dokumentista, joka on käännetty \textbf{XeLaTeX}. Myös LuaLaTeXin pitäisi toimia. \end{document} ``` [Avaa Times New Roman -esimerkki XeLaTeXilla Overleafissa](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) Tämä esimerkki tuottaa seuraavan tulosteen: ![XeLaTeXOverleaf.png](/files/a6beb375df3c8cf43e26746a9f9715873773db24) Voit myös [käyttää LuaLaTeXia saman koodin suorittamiseen](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) . ## Fonttien asettaminen eri LaTeX-elementeille LaTeX-dokumentin eri elementit muotoillaan eri fonteilla; esimerkiksi `verbatim` ympäristössä teksti näytetään kirjoituskoneen tyylillä. Eri fonttityylit voidaan asettaa kullekin yhteydelle: ```latex \documentclass[12pt]{article} \usepackage{fontspec} %----------------------------------------------------------------------- \setmainfont{Times New Roman} \setsansfont{Arial} \setmonofont[Color={0019D4}]{Courier New} %----------------------------------------------------------------------- \title{Esimerkkifonttidokumentti} \author{Overleaf} \date{\today} \begin{document} \maketitle Tämä on \textit{esimerkki} dokumentista, joka on käännetty \textbf{XeLaTeX}-kääntäjällä. Jos sinun täytyy kirjoittaa koodia, voit käyttää \texttt{verbatim}-ympäristöä: \begin{verbatim} Yleensä tätä ympäristöä käytetään koodin näyttämiseen, joten tässä on yksinkertainen C-ohjelma. #include #define NUMYAYS 10 int main() { int i; for (i = 0; i <= NUMYAYS; i++) { printf("Yay! Overleaf is Awesome!\n"); } return 0; } \end{verbatim} {\sffamily Tämä on esimerkkiteksti \textbf{Sans Serif -kirjasintyylillä}} \end{document} ``` [Katso tulos avaamalla tämä XeLaTeX-esimerkki Overleafissa](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) Edellisessä esimerkissä käytetään kolmea eri fonttia; seuraavat rivit määrittävät, mitkä elementit käyttävät näitä fontteja: **\setmainfont{Times New Roman}** Tämä on normaali fontti, jota käytetään suurimmassa osassa dokumenttia, esimerkissä Times New Roman. **\setsansfont{Arial}** Elementit, jotka vaativat sans-fontin, joka on esimerkissä nimenomaisesti ilmoitettu \ssfamily-komennolla, ladotaan Arial-fontilla. **\setmonofont{Courier New}** Kaikki, mikä muotoillaan yksivälisellä (kirjoituskoneen kaltaisella) fontilla, käyttää Courier New -fonttia. Tällä komennolla on lisävalinnainen parametri aaltosulkeiden sisällä: **Color={0019D4}** Tämä asettaa tekstin värin käyttämällä Color=-arvoa heksadesimaalisen HTML-muodon mukaisesti. Tekstin värin harkittu ja valikoiva käyttö voi olla hyödyllistä esitystä tehtäessä. ## Fontit Overleafissa On olemassa [suuri määrä Overleafiin asennettuja fontteja](/latex/fi/kysymykset-ja-vastaukset/85-which-otf-or-ttf-fonts-are-supported-via-fontspec.md) joita voit käyttää projektissasi, helpoimmin `fontspec`. Seuraavat esimerkit näyttävät Overleafin palvelimille sisällytettyjen fonttien, kuten Google Noton, käytön yhdessä fonttien kanssa, jotka sinun on ladattava palvelusta [Google Fonts](https://fonts.google.com/). ### Overleafin palvelimille asennetut fontit: Google Noto -fontit Koska [TeX Live](https://www.tug.org/texlive/)—jota Overleaf käyttää—sisältää [Google Noto -fontit](https://www.google.com/get/noto/) voit käyttää niitä `fontspec` paketin kautta Overleaf-projekteissa, jotka on käännetty XeLaTeX- tai LuaLaTeX-kääntäjillä. Tässä on esimerkkiprojekti, joka käyttää [`noto` paketti](https://ctan.org/pkg/noto?lang=en) määrittämään dokumenttisi ladottavaksi NotoSerif-, NotoSans- ja NotoSansMono-fonttiperheillä. Ohjeistuksen `noto` paketista löydät sen [README-tiedostosta CTANissa](http://mirrors.ctan.org/fonts/noto/README). ```latex \documentclass{article} \usepackage{xcolor} \usepackage{noto} \usepackage{hyperref} \title{Using Google Noto fonts} \author{Overleaf} \date{April 2021} \begin{document} \maketitle \section{Introduction} Tämä esimerkkiprojekti käyttää \href{https://ctan.org/pkg/noto?lang=en}{\color{blue}\texttt{noto}}-pakettia dokumenttisi ladontaan Googlen Noto-fonttien\footnote{\url{https://www.google.com/get/noto/}} avulla: \begin{itemize} \item \verb|\textbf{bold}| tuottaa \textbf{bold} \item \verb|\textit{italic}| tuottaa \textit{italic} \item \verb|\textbf{\textit{bold italic}}| tuottaa \textbf{\textit{bold italic}} \item \verb|\emph{emphasis}| tuottaa \emph{emphasis} \item \verb|\textbf{\emph{bold italic}}| tuottaa \textbf{\emph{bold italic}} \end{itemize} \subsection{Yksiväliset fontit} Voit käyttää Noton yksivälisiä fontteja \texttt{regular}- ja \texttt{\textbf{bold}}-yksiväliselle tekstille. \subsection{Päätteettömät fontit} Tässä on hieman \textsf{teksti ladottuna päätteettömällä fontilla} yhdessä \textbf{\textsf{teksti ladottuna lihavoidulla päätteettömällä fontilla}}. \section{Lisälukemista} Ohjeistuksen \texttt{noto}-pakettiin löydät sen \href{http://mirrors.ctan.org/fonts/noto/README}{\color{blue}\texttt{readme}-tiedostosta CTANissa}. \end{document} ``` [Avaa tämä XeLaTeX-esimerkki Overleafissa tutustuaksesi Noto-fontteihin](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) ![Google Noto -fonttien käyttäminen LaTeX-dokumentin ladontaan](/files/e8a09a0b7296125ba06fa5d109c925e9b3ada620) ### Overleafin palvelimille asentamattomien fonttien käyttäminen: Google Fonts -esimerkki Käyttääksesi OpenType-fontteja, joita ei ole asennettu Overleafin palvelimille, sinun on ensin ladattava fonttitiedostot Overleaf-projektiisi—jos fonttilisenssit tämän sallivat. Kun OpenType-fontit on ladattu, aseta projektin kääntäjäksi XƎLaTeX (tai LuaLaTeX) ja käytä `fontspec` määrittämään fonttisi. Alla hahmoteltu esimerkkiprojekti näyttää, miten luodaan kansioita, ladataan fontteja ja määritetään ne käyttäen `fontspec`. Esimerkissämme käytämme seuraavaa fonttivalikoimaa palvelusta [Google Fonts](https://fonts.google.com/): * Päätteelliset fontit: [Brygada1918](https://fonts.google.com/specimen/Brygada+1918) * Päätteettömät fontit: [Asap](https://fonts.google.com/specimen/Asap) * Yksiväliset fontit: [JetBrains Mono](https://fonts.google.com/specimen/JetBrains+Mono) Huom: Emme väitä, että tämä esimerkki tarjoaa typografisesti harmonisen kirjasintyylien yhdistelmän; se näyttää vain, miten voit ladata, määrittää ja käyttää haluamiasi fontteja. Kunkin kirjasintyypin kohdalla sinun on ladattava fonttiperhe Google Fontsista: ![GoogleDownload.png](/files/7535668c9637255bcecb588a77910d6da282a43a) Huom: Osa Google-fonttifonteista on saatavana "staattisina" OpenType-fontteina ja niin sanottuina "muuttuvina" OpenType-fontteina. Jos ladatussa ZIP-tiedostossa on "static"-niminen kansio, sinun tulee ladata fontit kyseisestä kansiosta, ei muuttuvan fontin versioita: ![OpenTypeStatic.png](/files/3c824bb020563628dd9affc074bd047ce2190a3c) Seuraavaksi sinun on ladattava fonttitiedostot projektiisi, mutta koska fonttiperheet sisältävät useita fonttitiedostoja, saatat haluta luoda Overleaf-projektiin erillisiä kansioita tiedostoja varten — yksi kansio kutakin fonttiperhettä kohti. Seuraava video näyttää, miten se tehdään. Myöhemmin meidän täytyy kertoa XƎLaTeXille, mistä projektisi fontit löytyvät — koska ne eivät ole esiasennettuina Overleafin palvelimilla. {% embed url="" %} ### fontspecin määrittäminen fonttien käyttämiseen Kun fonttiperheen tiedostot on ladattu Overleaf-projektin kansioihin, voimme määrittää ne käyttöön `fontspec`. Seuraavassa LaTeX-koodissa huomaa, miten olemme käyttäneet `Path` parametria kertomaan `fontspec` että fonttitiedostot sijaitsevat projektimme tiedostojärjestelmän paikallisessa kansiossa: ```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/9ffc639b7be65eea2d778746484487c9455b4522) [Avaa XeLaTeX- ja Google Fonts -demo Overleafissa](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=) Se [`fontspec` paketti](https://ctan.org/pkg/fontspec?lang=en) tarjoaa runsaasti vaihtoehtoja OpenType-fonttien määrittämiseen käytettäväksi LuaLaTeXin tai XƎLaTeXin kanssa — sen [erinomainen dokumentaatio](http://mirrors.ctan.org/macros/unicodetex/latex/fontspec/fontspec.pdf) sisältää lukuisia esimerkkejä, joita voit tutkia hienosäätääksesi dokumenttiesi ulkoasua ja ladontaa. ## Lisälukemista Lisätietoja löydät: * [Lihavointi, kursivointi ja alleviivaus](/latex/fi/latexin-perusteet/03-bold-italics-and-underlining.md) * [Kirjasinkoot, -perheet ja -tyylit](/latex/fi/fontit/01-font-sizes-families-and-styles.md) * [Kirjasinlajit](/latex/fi/fontit/02-font-typefaces.md) * [Kappaleen muotoilu](/latex/fi/muotoilu/04-articles-how-to-change-paragraph-spacing-in-latex.md) * [Rivinvaihdot ja tyhjät välit](/latex/fi/muotoilu/05-line-breaks-and-blank-spaces.md) * [Tekstin tasaus](/latex/fi/muotoilu/06-text-alignment.md) * [Useita palstoja](/latex/fi/muotoilu/09-multiple-columns.md) * [Hallinta suuressa projektissa](/latex/fi/asiakirjan-rakenne/07-management-in-a-large-project.md) * [Useita tiedostoja sisältävät LaTeX-projektit](/latex/fi/asiakirjan-rakenne/08-multi-file-latex-projects.md) * [Kansainvälinen kielituki](/latex/fi/kielet/03-international-language-support.md) * [LaTeX-kääntäjän valitseminen](/latex/fi/lisaa-aiheita/08-choosing-a-latex-compiler.md) * [Luettelo Overleafiin asennetuista OTF- ja TTF-fonteista](/latex/fi/kysymykset-ja-vastaukset/85-which-otf-or-ttf-fonts-are-supported-via-fontspec.md) * [Googlen fonttivalikoima](http://www.google.com/fonts/) * [`fontspec` paketin käsikirja](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/fi/fontit/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.