> 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/latexin-perusteet/01-learn-latex-in-30-minutes.md).

# Ensimmäisen LaTeX-asiakirjan luominen

**UUSI: Vieraile uudessa** [**Overleafin oppimiskeskus**](https://learn.overleaf.com/) **tutustu maksuttomiin verkkokursseihin ja live-webinaareihin — kaikkeen, mitä tarvitset LaTeXin hallitsemiseen ja Overleafista kaiken irti saamista varten.**

Tämä johdantotutoriaali ei edellytä aiempaa kokemusta LaTeXista, mutta toivottavasti, kun olet valmis, olet paitsi kirjoittanut ensimmäisen LaTeX-dokumenttisi myös saanut riittävästi tietoa ja itsevarmuutta ottaaksesi seuraavat askeleet kohti LaTeX-osaamista.

## Mikä on LaTeX?

LaTeX (lausutaan “*LAY*-tek” tai “*LAH*-tek”) on työkalu ammattimaisen näköisten asiakirjojen ladontaan. LaTeXin toimintatapa eroaa kuitenkin melko paljon monista muista asiakirjojen tuottamiseen tarkoitetuista sovelluksista, joita olet ehkä käyttänyt, kuten Microsoft Wordista tai LibreOffice Writerista: nämä “[WYSIWYG](https://en.wikipedia.org/wiki/WYSIWYG)” -työkalut tarjoavat käyttäjille interaktiivisen sivun, johon he kirjoittavat ja muokkaavat tekstiään sekä lisäävät erilaisia muotoiluja. LaTeX toimii hyvin eri tavalla: sen sijaan dokumenttisi on pelkkä tekstitiedosto, jonka seassa on LaTeX *komennot* joita käytetään haluttujen (ladottujen) tulosten ilmaisemiseen. Näkyvän, ladotun dokumentin tuottamiseksi LaTeX-tiedostosi käsitellään ohjelmistolla, jota kutsutaan *TeX-moottori* joka käyttää tekstitiedostoosi upotettuja komentoja ohjaamaan ja hallitsemaan taittoprosessia ja muuntaa LaTeX-komennot ja dokumentin tekstin ammattimaisesti ladotuksi PDF-tiedostoksi. Tämä tarkoittaa, että sinun tarvitsee keskittyä vain *sisältö* dokumenttisi *ulkoasuun* (muotoiluun).

## Miksi opetella LaTeXia?

LaTeXin käyttämisen opettelun puolesta tai sitä vastaan voidaan esittää monenlaisia perusteluja muihin asiakirjantekosovelluksiin verrattuna; lopulta kyse on kuitenkin henkilökohtaisesta valinnasta, joka perustuu mieltymyksiin, taipumuksiin ja dokumentaatiovaatimuksiin.

LaTeXin puolesta puhuvia perusteluja ovat:

* erittäin monimutkaisen matematiikan, taulukoiden ja fysikaalisten tieteiden teknisen sisällön ladonta;
* alaviitteiden, ristiviittausten ja lähdeluetteloiden hallinnan mahdollisuudet;
* vaivattomuus tuottaa monimutkaisia tai työläitä asiakirjan osia, kuten hakemistoja, sanastoja, sisällysluetteloita ja kuvaluetteloita;
* erittäin laaja räätälöitävyys yksilölliseen asiakirjatuotantoon sen sisäisen ohjelmoitavuuden ja tuhansiin [maksuttomiin lisäosapaketteihin](https://www.ctan.org/pkg).

Kaiken kaikkiaan LaTeX tarjoaa käyttäjille paljon hallintaa asiakirjojen tuotantoon, ja asiakirjat ladotaan erittäin korkeiden standardien mukaisesti. Toki on olemassa asiakirjatyyppejä tai julkaisuja, joissa LaTeX ei loista, mukaan lukien monet vapaamuotoiset sivuasettelut, joita löytyy tyypillisesti aikakauslehtityyppisistä julkaisuista.

Yksi LaTeXin tärkeä etu on asiakirjan sisällön ja tyylin erottaminen toisistaan: kun olet kirjoittanut dokumenttisi sisällön, sen ulkoasua voidaan muuttaa helposti. Samoin voit luoda LaTeX-tiedoston, joka määrittelee tietyn asiakirjatyypin asettelun/tyylin, ja tuota tiedostoa voidaan käyttää *pohjana* vakioimaan kyseisen tyypin lisäasiakirjojen kirjoittamista/tuotantoa; esimerkiksi tämä mahdollistaa sen, että tieteelliset kustantajat voivat luoda LaTeXissa artikkelipohjia, joita kirjoittajat käyttävät kirjoittaessaan lehdille toimitettavia artikkeleita. Overleafissa on [galleria, jossa on tuhansia pohjia](https://www.overleaf.com/gallery), jotka kattavat valtavan määrän asiakirjatyyppejä — tieteellisistä artikkeleista, raporteista ja kirjoista ansioluetteloihin ja esityksiin. Koska nämä pohjat määrittelevät asiakirjan asettelun ja tyylin, kirjoittajien tarvitsee vain avata ne Overleafissa — luoda uusi projekti — ja aloittaa kirjoittaminen lisätäkseen sisältönsä.

## Ensimmäisen LaTeX-koodisi kirjoittaminen

Ensimmäinen vaihe on luoda uusi LaTeX-projekti. Voit tehdä tämän omalla tietokoneellasi luomalla uuden `.tex` tiedoston; vaihtoehtoisesti voit [aloittaa uuden projektin Overleafissa](/latex/fi/tietopankki/031-creating-a-document-in-overleaf.md).

Aloitetaan yksinkertaisimmasta toimivasta esimerkistä, joka voidaan avata suoraan Overleafissa:

```latex
\documentclass{article}
\begin{document}
Ensimmäinen dokumentti. Tämä on yksinkertainen esimerkki, jossa ei ole
lisäparametreja tai paketteja.
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Simplest+working+example+LaTeX+document\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AFirst+document.+This+is+a+simple+example%2C+with+no+%0Aextra+parameters+or+packages+included.%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Esimerkkiasiakirja](/files/a13e5fbc4891cda9539405c91515bff64cb88a7f)

Näet, että LaTeX on automaattisesti sisentänyt kappaleen ensimmäisen rivin ja huolehtinut siitä muotoilusta puolestasi. Katsotaan tarkemmin, mitä kukin koodimme osa tekee.

Koodin ensimmäinen rivi, `\documentclass{article}`, määrittää asiakirjatyypin, joka tunnetaan sen *luokka*, joka ohjaa asiakirjan yleistä ulkoasua. Erilaiset asiakirjatyypit vaativat erilaisia luokkia; esimerkiksi CV/ansioluettelo vaatii eri luokan kuin tieteellinen artikkeli, joka saattaa käyttää LaTeXin vakioluokkaa `article` luokka. Muut asiakirjatyypit, joiden parissa saatat työskennellä, voivat vaatia erilaisia luokkia, kuten `book` tai `raportti`. Saadaksesi käsityksen tarjolla olevista monista LaTeX-luokkatyypeistä, [käy asianomaisella sivulla CTANissa (Comprehensive TeX Archive Network)](https://www.ctan.org/topic/class).

Kun asiakirjaluokka on asetettu, sisältömme, jota kutsutaan *rungoksi* asiakirjan, kirjoitetaan `\begin{document}` ja `\end{document}` tunnisteiden väliin. Kun olet avannut yllä olevan esimerkin, voit tehdä muutoksia tekstiin ja, kun olet valmis, tarkastella syntynyttä ladottua PDF-tiedostoa *kääntämällä dokumentin uudelleen*. Tehdäksesi tämän Overleafissa, paina yksinkertaisesti **Uudelleen käännä**, kuten tässä lyhyessä videoklipissä havainnollistetaan:

{% embed url="<https://videos.ctfassets.net/nrgyaltdicpt/6yo2PA5aMV3OEZl5NtZKWu/54395f569b830b8183b5e0058d5bc0cc/LL30recompile.mp4>" %}

Minkä tahansa Overleaf-projektin voi määrittää kääntymään uudelleen automaattisesti aina, kun sitä muokataan: napsauta pientä nuolta **Uudelleen käännä** painikkeen vieressä ja aseta **Automaattinen käännös** kohteeseen **Käytössä**, kuten seuraavassa kuvakaappauksessa:

![Kuvakaappaus, joka näyttää, miten Automaattinen käännös asetetaan päälle tai pois päältä](/files/89439e3b08d43985c8baa7b4e4a95f28c5030cc4)

Kun olemme nähneet, miten sisältöä lisätään dokumenttiimme, seuraava vaihe on antaa sille otsikko. Tehdäksemme tämän meidän on puhuttava lyhyesti **preambuliin**.

## Asiakirjan esipuhe

Yllä oleva kuvakaappaus näyttää, että Overleaf tallentaa LaTeX-dokumentin tiedostona nimeltä `main.tex`: `.tex` tiedostopääte

Edellinen esimerkki näytti, miten dokumentin sisältö syötettiin `\begin{document}` komennon jälkeen; kuitenkin kaikki tiedostossasi `.tex` esiintyvä *ennen kuin* tuon pisteen jälkeen kutsutaan *preambuliin*, joka toimii asiakirjan “asetukset”-osiona. Esipuheessa määrittelet asiakirjaluokan (tyypin) sekä yksityiskohdat, kuten dokumentin kirjoittamiseen käytettävät kielet; lataat *paketteja* joita haluat käyttää (lisää tästä [myöhemmin](#finding-and-using-latex-packages)), ja siellä teet myös muunlaiset asetukset.

Pienimmillään asiakirjan esipuhe voisi näyttää tältä:

```latex
\documentclass[12pt, letterpaper]{article}
\usepackage{graphicx}
```

jossa `\documentclass[12pt, letterpaper]{article}` määrittää asiakirjan yleisen luokan (tyypin). Lisäparametrit, jotka on erotettava pilkuilla, sisällytetään hakasulkeisiin (`[...]`) ja niitä käytetään tämän artikkeliluokan instanssin määrittämiseen; eli asetuksiin, joita haluamme käyttää tässä nimenomaisessa `article`-luokan pohjaisessa dokumentissa.

Tässä esimerkissä kaksi parametria tekevät seuraavaa:

* `12 pt` määrittää fonttikoon
* `letterpaper` määrittää paperikoon

Toki muitakin fonttikokoja, `9 pt`, `11 pt`, `12 pt`, voidaan käyttää, mutta jos mitään ei ole määritetty, oletuskoko on `10 pt`. Paperikoon osalta muita mahdollisia arvoja ovat `a4paper` ja `legalpaper`. Lisätietoja saat artikkelista aiheesta [sivukoko ja marginaalit](/latex/fi/muotoilu/07-page-size-and-margins.md).

Esipuherivi

```latex
\usepackage{graphicx}
```

on esimerkki ulkoisen paketin lataamisesta (tässä, [`graphicx`](https://ctan.org/pkg/graphicx?lang=en)) LaTeXin toimintojen laajentamiseksi, jolloin se voi tuoda ulkoisia grafiikkatiedostoja. LaTeX-paketteja käsitellään osiossa [LaTeX-pakettien löytäminen ja käyttäminen](#finding-and-using-latex-packages).

## Otsikon, tekijän ja päivämäärän tietojen lisääminen

Otsikon, tekijän ja päivämäärän lisääminen dokumenttiimme vaatii vielä kolme riviä *preambuliin* (*sisällä* asiakirjan pääosassa). Nuo rivit ovat:

* `\title{Ensimmäinen LaTeX-dokumenttini}`: dokumentin otsikko
* `\author{Hubert Farnsworth}`: tähän kirjoitat tekijän/tekijöiden nimen ja valinnaisesti `\thanks` komennon aaltosulkeiden sisään:
  * `\thanks{Rahoittanut Overleaf-tiimi.}`: voidaan lisätä tekijän nimen jälkeen, komennon aaltosulkeiden sisään `tekijä` komennossa. Se lisää yläindeksin ja alaviitteen, jossa on aaltosulkeiden sisällä oleva teksti. Kätevä, jos sinun täytyy kiittää jotakin instituutiota artikkelissasi.
* `\date{elokuu 2022}`: voit syöttää päivämäärän manuaalisesti tai käyttää komentoa `\today` ladotaaksesi nykyisen päivämäärän aina, kun dokumentti käännetään

Kun nämä rivit on lisätty, esipuheesi pitäisi näyttää jotakuinkin tältä:

```latex
\documentclass[12pt, letterpaper]{article}
\title{Ensimmäinen LaTeX-dokumenttini}
\author{Hubert Farnsworth\thanks{Rahoittanut Overleaf-tiimi.}}
\date{elokuu 2022}
```

Ladotaksesi otsikon, tekijän ja päivämäärän käytä `\maketitle` komentoa *rungoksi* dokumentin rungossa:

```latex
\begin{document}
\maketitle
Olemme nyt lisänneet ensimmäiseen \LaTeX{}-dokumenttiimme otsikon, tekijän ja päivämäärän!
\end{document}
```

Esipuhe ja runko voidaan nyt yhdistää täydelliseksi dokumentiksi, joka voidaan avata Overleafissa:

```latex
\documentclass[12pt, letterpaper]{article}
\title{Ensimmäinen LaTeX-dokumenttini}
\author{Hubert Farnsworth\thanks{Rahoittanut Overleaf-tiimi.}}
\date{elokuu 2022}
\begin{document}
\maketitle
Olemme nyt lisänneet ensimmäiseen \LaTeX{}-dokumenttiimme otsikon, tekijän ja päivämäärän!
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=My+first+LaTeX+document\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Ctitle%7BMy+first+LaTeX+document%7D%0A%5Cauthor%7BHubert+Farnsworth%5Cthanks%7BFunded+by+the+Overleaf+team.%7D%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0AWe+have+now+added+a+title%2C+author+and+date+to+our+first+%5CLaTeX%7B%7D+document%21%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva yksinkertaisesta LaTeXilla tuotetusta dokumentista](/files/6a6f3d50d46fef916fa12ad1eca911ab0036c3de)

## Kommenttien lisääminen

LaTeX on eräänlaista “ohjelmakoodia”, mutta sellaista, joka erikoistuu asiakirjojen ladontaan; siksi, kuten minkä tahansa muun ohjelmointikielen koodissa, kommenttien lisääminen dokumenttiin voi olla erittäin hyödyllistä. LaTeX-kommentti on tekstiosa, jota ei ladota eikä joka vaikuta dokumenttiin millään tavalla — sitä käytetään usein “tehtävä”-muistioiden lisäämiseen; selittävien huomautusten liittämiseen; hankalien makrojen selitysten lisäämiseen rivin sisällä tai LaTeX-koodin rivien/osien kommentoimiseen pois käytöstä virheenkorjauksen aikana.

Tehdäksesi kommentin LaTeXissa, kirjoita yksinkertaisesti `%` symboli rivin alkuun, kuten seuraavassa koodissa, joka käyttää yllä olevaa esimerkkiä:

```latex
\documentclass[12pt, letterpaper]{article}
\title{Ensimmäinen LaTeX-dokumenttini}
\author{Hubert Farnsworth\thanks{Rahoittanut Overleaf-tiimi.}}
\date{elokuu 2022}
\begin{document}
\maketitle
Olemme nyt lisänneet ensimmäiseen \LaTeX{}-dokumenttiimme otsikon, tekijän ja päivämäärän!

% Tämä rivi on kommentti. Sitä ei ladota dokumenttiin.
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=My+first+LaTeX+document+with+a+comment\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Ctitle%7BMy+first+LaTeX+document%7D%0A%5Cauthor%7BHubert+Farnsworth%5Cthanks%7BFunded+by+the+Overleaf+team.%7D%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0AWe+have+now+added+a+title%2C+author+and+date+to+our+first+%5CLaTeX%7B%7D+document%21%0A%0A%25+This+line+here+is+a+comment.+It+will+not+be+typeset+in+the+document.%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa samanlaisen tulosteen kuin edellinen LaTeX-koodi, joka ei sisältänyt kommenttia.

## Lihavointi, kursivointi ja alleviivaus

Seuraavaksi tarkastelemme joitakin tekstinmuotoilukomentoja:

* **Lihava**: lihavoitu teksti ladotaan LaTeXissa käyttämällä `\textbf{...}` komento.
* *Kursivointi*: kursivoitu teksti tuotetaan käyttämällä `\textit{...}` komento.
* Alleviivaus: tekstin alleviivaamiseen käytä `\underline{...}` komento.

Seuraava esimerkki havainnollistaa näitä komentoja:

```latex
Jotkut \textbf{suurimmista}
tieteen \underline{löydöistä}
tehtiin \textbf{\textit{sattumalta}}.
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=First+example+with+formatted+text\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Ctitle%7BMy+first+LaTeX+document%7D%0A%5Cauthor%7BHubert+Farnsworth%5Cthanks%7BFunded+by+the+Overleaf+team.%7D%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0ASome+of+the+%5Ctextbf%7Bgreatest%7D%0Adiscoveries+in+%5Cunderline%7Bscience%7D+%0Awere+made+by+%5Ctextbf%7B%5Ctextit%7Baccident%7D%7D.%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, jossa näkyy LaTeX-dokumentissa muotoiltua tekstiä](/files/3071aade5db8962a210414bbbc786e7d514c1a44)

Toinen erittäin hyödyllinen komento on `\emph{*argument*}`, jonka vaikutus sen `*argumenttiin*` riippuu asiayhteydestä. Tavallisen tekstin sisällä korostettu teksti kursivoidaan, mutta tämä käyttäytyminen kääntyy päinvastaiseksi, jos komentoa käytetään kursivoidun tekstin sisällä — katso seuraava esimerkki:

```latex
Jotkin tieteen suurimmista \emph{löydöistä}
tehtiin sattumalta.

\textit{Jotkut suurimmista \emph{löydöistä}
tieteessä tehtiin vahingossa.}

\textbf{Jotkut suurimmista \emph{löydöistä}
tieteessä tehtiin vahingossa.}
```

[Avaa tämä `**\emph**` esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Using+the+emph+command\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%2C+twoside%5D%7Barticle%7D%0A%5Ctitle%7BMy+first+LaTeX+document%7D%0A%5Cauthor%7BHubert+Farnsworth%5Cthanks%7BFunded+by+the+Overleaf+team.%7D%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cparindent0pt%25+To+remove+the+paragraph+indentation%0A%5Cmaketitle%0ASome+of+the+greatest+%5Cemph%7Bdiscoveries%7D+in+science+%0Awere+made+by+accident.%0A%0A%5Ctextit%7BSome+of+the+greatest+%5Cemph%7Bdiscoveries%7D+%0Ain+science+were+made+by+accident.%7D%0A%0A%5Ctextbf%7BSome+of+the+greatest+%5Cemph%7Bdiscoveries%7D+%0Ain+science+were+made+by+accident.%7D%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, joka havainnollistaa LaTeX \emph-komennon käyttöä](/files/17b5790604c8cf170da0a2e6214ec401ee8dfd09)

* **Huom:** jotkin paketit, kuten [Beamer](/latex/fi/esitykset/01-beamer.md), muuttavat `\emph` komento.

## Kuvien lisääminen

Tässä osiossa tarkastelemme, miten kuvia lisätään LaTeX-dokumenttiin. Overleaf tukee kolmea tapaa lisätä kuvia:

1. Käytä [**Lisää kuva**  -painiketta](https://learn.overleaf.com/learn/Kb/How_to_insert_figures_in_Overleaf#Using_Insert_Figure_to_add_a_figure_to_your_project)(![The Insert Figure button on the editor toolbar](/files/bef8cf45643223bc6c90d79fe3239adacc6e732e)), joka sijaitsee editorin työkalupalkissa, lisätäksesi kuvan **visuaalista editoria** tai **koodieditoria**.
2. [Kopioi ja liitä kuva](/latex/fi/tietopankki/075-how-to-paste-formatted-content-into-overleaf.md#pasting-images-into-your-overleaf-project) sisään **visuaalista editoria** tai **koodieditoria**.
3. Käytä **koodieditoria** kirjoittaaksesi LaTeX-koodia, joka lisää grafiikan.

Vaihtoehdot 1 ja 2 luovat automaattisesti tarvittavan LaTeX-koodin kuvien lisäämiseen, mutta tässä esittelemme vaihtoehdon 3 — huomaa, että sinun täytyy [ladata nuo kuvat](/latex/fi/tietopankki/088-including-images-on-overleaf.md) Overleaf-projektiisi. Seuraava esimerkki näyttää, miten kuva sisällytetään:

```latex
\documentclass{article}
\usepackage{graphicx} %LaTeX-paketti grafiikan tuontiin
\graphicspath{{images/}} %graphicx-paketin asetusten määrittäminen

\begin{document}
Universumi on valtava, ja se näyttää olevan homogeeninen,
suurella mittakaavalla kaikkialla, minne katsomme.

% \includegraphics-komento on
% paketin tarjoama (toteuttama)
% graphicx-paketti
\includegraphics{universe}

Yllä on kuva galaksista.
\end{document}
```

[Avaa tämä kuvaesimerkki Overleafissa.](https://www.overleaf.com/project/new/template/25686?id=107971142\&templateName=Example+using+images+in+LaTeX\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, joka näyttää LaTeX-dokumenttiin tuodun kuvan](/files/548362fbe03674d88976c244772586a75f89f9fc)

Grafiikan tuominen LaTeX-dokumenttiin tarvitsee [lisäosan *paketti*](#finding-and-using-latex-packages) joka tarjoaa tarvittavat komennot ja ominaisuudet ulkoisten grafiikkatiedostojen sisällyttämiseen. Yllä oleva esimerkki lataa [`graphicx` paketti](https://ctan.org/pkg/graphicx?lang=en) joka tarjoaa monien muiden komentojen ohella `\includegraphics{...}` grafiikan tuontiin ja `\graphicspath{...}` neuvoakseen LaTeXia, missä grafiikat sijaitsevat.

Jotta voit käyttää `graphicx` paketti, lisää seuraava rivi Overleaf-dokumenttisi esipuheeseen:

```latex
\usepackage{graphicx}
```

Esimerkissämme komento `\graphicspath{{images/}}` kertoo LaTeXille, että kuvat säilytetään kansiossa nimeltä `images`, joka sijaitsee nykyisessä hakemistossa:

![Kuva, joka näyttää LaTeXin käyttävän kansioon tallennettuja kuvia](/files/d7ac90170882a0c7ad90cb00bbecd06c417ee99f)

Se `\includegraphics{universe}` komento tekee varsinaisen työn kuvan lisäämisessä dokumenttiin. Tässä, `universe` on kuvatiedoston nimi ilman tiedostopäätettä.

**Huomaa**:

* Vaikka koko tiedostonimi, mukaan lukien tiedostopääte, on sallittu `\includegraphics` komennossa, on parasta jättää tiedostopääte pois, koska silloin LaTeX etsii kaikkia tuettuja tiedostomuotoja.
* Yleensä grafiikkatiedoston nimessä ei pitäisi olla välilyöntejä tai useita pisteitä; on myös suositeltavaa käyttää pienaakkosia tiedostopäätteessä, kun lataat kuvatiedostoja Overleafiin.

Lisätietoja LaTeX-paketeista löytyy tämän oppaan lopusta osiosta [LaTeX-pakettien löytäminen ja käyttäminen](#finding-and-using-latex-packages).

## Kuvatekstit, tunnisteet ja viitteet

Kuvia voidaan varustaa kuvateksteillä, tunnisteilla ja viittauksilla `figure` ympäristön avulla, kuten alla on esitetty:

```latex
\documentclass{article}
\usepackage{graphicx}
\graphicspath{{images/}}

\begin{document}

\begin{figure}[h]
    \centering
    \includegraphics[width=0.75\textwidth]{mesh}
    \caption{Kaunis kuvaaja.}
    \label{fig:mesh1}
\end{figure}

Kuten näet kuvassa \ref{fig:mesh1}, funktio kasvaa lähellä origoa. Tämä esimerkki on sivulla \pageref{fig:mesh1}.

\end{document}
```

[Avaa tämä kuvaesimerkki Overleafissa.](https://www.overleaf.com/project/new/template/25519?id=107980830\&templateName=Example+using+image+captions+in+LaTeX\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, joka näyttää kuvatekstien käytön LaTeXissa](/files/8cdcb08b3e35a0779c17c0b42e238738ef1c2c49)

Esimerkissä on useita huomionarvoisia komentoja:

* **`\includegraphics[width=0.75\textwidth]{mesh}`**: Tämä muoto `\includegraphics` kehottaa LaTeXia asettamaan kuvan leveydeksi 75 % tekstin leveydestä — jonka arvo on tallennettu `\textwidth` komento.
* **`\caption{Kaunis kuvaaja.}`**: Kuten nimi vihjaa, tämä komento asettaa kuvatekstin, joka voidaan sijoittaa kuvan ylä- tai alapuolelle. Jos luot kuvaluettelon, tätä kuvatekstiä käytetään siinä luettelossa.
* **`\label{fig:mesh1}`**: Viitataaksesi tähän kuvaan dokumentissasi annat sille tunnisteen käyttämällä `\label` komentoa. Tunnistetta käytetään kuvalle numeron luomiseen, ja yhdessä seuraavan komennon kanssa se mahdollistaa siihen viittaamisen.
* **`\ref{fig:mesh1}`**: Tämä koodi korvataan viitattaessa kuvaa vastaavalla numerolla.

LaTeX-dokumenttiin sisällytettävät kuvat tulisi sijoittaa `figure` ympäristöön tai vastaavaan, jotta LaTeX voi automaattisesti sijoittaa kuvan sopivaan kohtaan dokumentissasi.

Lisäohjeita on seuraavissa Overleafin ohjeartikkeleissa:

* [Kuvien sijoittelu](/latex/fi/kuvat-ja-taulukot/02-positioning-images-and-tables.md)
* [Kuvien lisääminen](/latex/fi/lisaa-aiheita/27-inserting-images.md)

## Listojen luominen LaTeXissa

Voit luoda erityyppisiä luetteloita käyttämällä *ympäristöjä*, joita käytetään kapseloimaan LaTeX-koodi, jota tarvitaan tietyn ladontaominaisuuden toteuttamiseen. Ympäristö alkaa `\begin{*environment-name*}` ja päättyy merkintään `\end{*environment-name*}` jossa `*environment-name*` saattaa olla `figure`, `tabular` tai jokin luettelotyypeistä: `itemize` järjestämättömille luetteloille tai `enumerate` järjestetyille luetteloille.

### Järjestämättömät luettelot

Järjestämättömät luettelot tuotetaan `itemize` ympäristöllä. Jokaisen listakohdan eteen on lisättävä `\item` komento, kuten alla on esitetty:

```latex
\documentclass{article}
\begin{document}
\begin{itemize}
  \item Yksittäiset kohdat merkitään mustalla pisteellä, niin sanotulla luettelomerkillä.
  \item Merkintöjen teksti voi olla minkä pituista tahansa.
\end{itemize}
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+a+LaTeX+unordered+list\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bitemize%7D%0A++%5Citem+The+individual+entries+are+indicated+with+a+black+dot%2C+a+so-called+bullet.%0A++%5Citem+The+text+in+the+entries+may+be+of+any+length.%0A%5Cend%7Bitemize%7D%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Esimerkki luettelomerkeillä varustetuista listoista LaTeXissa](/files/d0c94b9f64513d7519e6348970aad51089e92934)

Voit myös avata tämän [suuremman Overleaf-projektin](https://www.overleaf.com/project/new/template/25521?id=107987258\&templateName=Demonstrating+various+types+of+LaTeX+list\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=) joka havainnollistaa erityyppisiä LaTeX-luetteloita.

### Järjestetyt luettelot

Järjestetyt luettelot käyttävät samaa syntaksia kuin järjestämättömät luettelot, mutta ne luodaan käyttämällä `enumerate` ympäristöä:

```latex
\documentclass{article}
\begin{document}
\begin{enumerate}
  \item Tämä on ensimmäinen kohta luettelossamme.
  \item Luettelon numerot kasvavat jokaisen lisäämämme kohdan myötä.
\end{enumerate}
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+the+enumerate+environment\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Benumerate%7D%0A++%5Citem+This+is+the+first+entry+in+our+list.%0A++%5Citem+The+list+numbers+increase+with+each+entry+we+add.%0A%5Cend%7Benumerate%7D%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Esimerkki LaTeXilla tuotetusta numeroidusta luettelosta](/files/f620ffe5ffd2b523d3fd13bc6ea0d033f27cb435)

Kuten `järjestämättömissä` luetteloissa, jokaisen kohdan eteen on lisättävä `\item` komento, joka tässä luo automaattisesti numeroidun luettelon numeron arvon alkaen 1:stä.

Lisätietoja saat avaamalla tämän [suuremman Overleaf-projektin](https://www.overleaf.com/project/new/template/25521?id=107987258\&templateName=Demonstrating+various+types+of+LaTeX+list\&latexEngine=pdflatex\&texImage=texlive-full%3A2022.1\&mainFile=) , joka havainnollistaa erityyppisiä LaTeX-luetteloita, tai vierailemalla omistetussa [ohjeartikkelissamme LaTeX-luetteloista](/latex/fi/latexin-perusteet/04-lists.md), joka tarjoaa paljon lisää esimerkkejä ja näyttää, miten luoda räätälöityjä luetteloita.

## Matematiikan lisääminen LaTeXiin

Yksi LaTeXin tärkeimmistä eduista on se, miten helposti matemaattisia lausekkeita voidaan kirjoittaa. LaTeX tarjoaa matematiikan ladontaan kaksi kirjoitustilaa:

* *sulautettuun* matematiikkatila, jota käytetään kappaleeseen kuuluvien kaavojen kirjoittamiseen
* *näyttö* matematiikkatila, jota käytetään lausekkeisiin, jotka eivät ole osa tekstiä tai kappaletta ja ladotaan omille riveilleen

### Rivin sisäinen matematiikkatila

Katsotaanpa esimerkki rivinsisäisestä matematiikkatilasta:

```latex
\documentclass[12pt, letterpaper]{article}
\begin{document}
Fysiikassa massa-energian ekvivalenssi ilmaistaan
yhtälöllä $E=mc^2$, jonka Albert Einstein löysi vuonna 1905.
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Inline+LaTeX+maths+example\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AIn+physics%2C+the+mass-energy+equivalence+is+stated+%0Aby+the+equation+%24E%3Dmc%5E2%24%2C+discovered+in+1905+by+Albert+Einstein.%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, joka näyttää rivinsisäisessä matematiikkatilassa ladottua matematiikkaa](/files/c234215845aa622f156185cbb0f922aef25aba87)

Rivinsisäisen matematiikan ladontaan voit käyttää jotakin näistä erotinpareista: `\( ... \)`, `$ ... $` tai `\begin{math} ... \end{math}`, kuten seuraavassa esimerkissä on havainnollistettu:

```latex
\documentclass[12pt, letterpaper]{article}
\begin{document}
\begin{math}
E=mc^2
\end{math} ladotaan kappaleen sisällä rivinsisäisessä matematiikkatilassa — samoin kuin $E=mc^2$, ja samoin myös \(E=mc^2\).
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Demonstrating+inline+math+mode\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bmath%7D%0AE%3Dmc%5E2%0A%5Cend%7Bmath%7D+is+typeset+in+a+paragraph+using+inline+math+mode---as+is+%24E%3Dmc%5E2%24%2C+and+so+too+is+%5C%28E%3Dmc%5E2%5C%29.%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, joka havainnollistaa LaTeXin rivinsisäisessä matematiikkatilassa tuotettua sisältöä](/files/1355b3ddebec0fd268fee6028ed6827ba9ef89d3)

### Näyttömatematiikkatila

Näytetilassa ladotut yhtälöt voidaan numeroida tai jättää numeroimatta, kuten seuraavassa esimerkissä:

```latex
\documentclass[12pt, letterpaper]{article}
\begin{document}
Massa-energian ekvivalenssi kuvataan kuuluisalla yhtälöllä
\[ E=mc^2 \] Albert Einsteinin vuonna 1905 löytämä.

Luonnollisissa yksiköissä ($c = 1$) kaava ilmaisee identiteetin
\begin{equation}
E=m
\end{equation}
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Display+math+mode+example\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0AThe+mass-energy+equivalence+is+described+by+the+famous+equation%0A%5C%5B+E%3Dmc%5E2+%5C%5D+discovered+in+1905+by+Albert+Einstein.+%0A%0AIn+natural+units+%28%24c+%3D+1%24%29%2C+the+formula+expresses+the+identity%0A%5Cbegin%7Bequation%7D%0AE%3Dm%0A%5Cend%7Bequation%7D%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, joka näyttää näytetilan matematiikkaa LaTeXissa](/files/6eb88f701e594ad8d6a85eccd863b0ce94b09be2)

Näytetilan matematiikan ladontaan voit käyttää jotakin näistä erotinpareista: `\[ ... \]`, `\begin{displaymath} ... \end{displaymath}` tai `\begin{equation} ... \end{equation}`. Historiallisesti näytetilan matematiikan ladonta edellytti `$$` merkkierottimien käyttöä, kuten `$$ *... näyttömatematiikka tähän ...*$$`, mutta tätä menetelmää [ei enää suositella](https://texfaq.org/FAQ-dolldoll): käytä LaTeXin erottimia `\[ ... \]` .

### Täydellisempiä esimerkkejä

Seuraavat esimerkit havainnollistavat eri matematiikan sisältötyyppejä ladottuna LaTeXilla.

```latex
\documentclass{article}
\begin{document}
Alaindeksit matematiikkatilassa kirjoitetaan muodossa $a_b$ ja yläindeksit muodossa $a^b$. Näitä voidaan yhdistää ja upottaa toisiinsa kirjoittaaksesi lausekkeita, kuten

\[ T^{i_1 i_2 \dots i_p}_{j_1 j_2 \dots j_q} = T(x^{i_1},\dots,x^{i_p},e_{j_1},\dots,e_{j_q}) \]

Kirjoitamme integraalit käyttämällä $\int$ ja murtoluvut käyttämällä $\frac{a}{b}$. Rajoja asetetaan integraaleille ylä- ja alaindekseillä:

\[ \int_0^1 \frac{dx}{e^x} =  \frac{e-1}{e} \]

Pienet kreikkalaiset kirjaimet kirjoitetaan muodossa $\omega$ $\delta$ jne., kun taas suuret kreikkalaiset kirjaimet kirjoitetaan muodossa $\Omega$ $\Delta$.

Matemaattisten operaattorien eteen lisätään kenoviiva, kuten $\sin(\beta)$, $\cos(\alpha)$, $\log(x)$ jne.
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=More+advanced+LaTeX+math+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ASubscripts+in+math+mode+are+written+as+%24a_b%24+and+superscripts+are+written+as+%24a%5Eb%24.+These+can+be+combined+and+nested+to+write+expressions+such+as%0A%0A%5C%5B+T%5E%7Bi_1+i_2+%5Cdots+i_p%7D_%7Bj_1+j_2+%5Cdots+j_q%7D+%3D+T%28x%5E%7Bi_1%7D%2C%5Cdots%2Cx%5E%7Bi_p%7D%2Ce_%7Bj_1%7D%2C%5Cdots%2Ce_%7Bj_q%7D%29+%5C%5D%0A+%0AWe+write+integrals+using+%24%5Cint%24+and+fractions+using+%24%5Cfrac%7Ba%7D%7Bb%7D%24.+Limits+are+placed+on+integrals+using+superscripts+and+subscripts%3A%0A%0A%5C%5B+%5Cint_0%5E1+%5Cfrac%7Bdx%7D%7Be%5Ex%7D+%3D++%5Cfrac%7Be-1%7D%7Be%7D+%5C%5D%0A%0ALower+case+Greek+letters+are+written+as+%24%5Comega%24+%24%5Cdelta%24+etc.+while+upper+case+Greek+letters+are+written+as+%24%5COmega%24+%24%5CDelta%24.%0A%0AMathematical+operators+are+prefixed+with+a+backslash+as+%24%5Csin%28%5Cbeta%29%24%2C+%24%5Ccos%28%5Calpha%29%24%2C+%24%5Clog%28x%29%24+etc.%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, joka näyttää LaTeXilla ladottuja erilaisia matemaattisia lausekkeita](/files/b90f3ce818fb6e3c33aa0aaddc8c1ee68fa5a01a)

Seuraava esimerkki käyttää `equation*` ympäristö, jonka tarjoaa `amsmath` pakettia, joten meidän on lisättävä seuraava rivi dokumenttimme esipuheeseen:

```latex
\usepackage{amsmath}% Yhtälö* -ympäristöä varten
```

Lisätietoja käytöstä `amsmath` see [ohjeartikkelistamme](/latex/fi/matematiikka/06-aligning-equations-with-amsmath.md).

```latex
\documentclass{article}
\usepackage{amsmath}% Yhtälö* -ympäristöä varten
\begin{document}
\section{Ensimmäinen esimerkki}

Tunnettu Pythagoraan lause \(x^2 + y^2 = z^2\) osoittautui pätemättömäksi muille eksponenteille, mikä tarkoittaa, ettei seuraavalla yhtälöllä ole kokonaislukuratkaisuja, kun \(n>2\):

\[ x^n + y^n = z^n \]

\section{Toinen esimerkki}

Tämä on yksinkertainen matemaattinen lauseke \(\sqrt{x^2+1}\) tekstin sisällä.
Ja tämä on myös sama:
\begin{math}
\sqrt{x^2+1}
\end{math}
mutta käyttäen toista komentoa.

Tämä on yksinkertainen matemaattinen lauseke ilman numerointia
\[\sqrt{x^2+1}\]
erotettuna tekstistä.

Tämä on myös sama:
\begin{displaymath}
\sqrt{x^2+1}
\end{displaymath}

\ldots ja tämä:
\begin{equation*}
\sqrt{x^2+1}
\end{equation*}
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=More+math+content+typeset+in+LaTeX\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bamsmath%7D%25+For+the+equation%2A+environment%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BFirst+example%7D%0A%0AThe+well-known+Pythagorean+theorem+%5C%28x%5E2+%2B+y%5E2+%3D+z%5E2%5C%29+was+proved+to+be+invalid+for+other+exponents%2C+meaning+the+next+equation+has+no+integer+solutions+for+%5C%28n%3E2%5C%29%3A%0A%0A%5C%5B+x%5En+%2B+y%5En+%3D+z%5En+%5C%5D%0A%0A%5Csection%7BSecond+example%7D%0A%0AThis+is+a+simple+math+expression+%5C%28%5Csqrt%7Bx%5E2%2B1%7D%5C%29+inside+text.+%0AAnd+this+is+also+the+same%3A+%0A%5Cbegin%7Bmath%7D%0A%5Csqrt%7Bx%5E2%2B1%7D%0A%5Cend%7Bmath%7D%0Abut+by+using+another+command.%0A%0AThis+is+a+simple+math+expression+without+numbering%0A%5C%5B%5Csqrt%7Bx%5E2%2B1%7D%5C%5D+%0Aseparated+from+text.%0A%0AThis+is+also+the+same%3A%0A%5Cbegin%7Bdisplaymath%7D%0A%5Csqrt%7Bx%5E2%2B1%7D%0A%5Cend%7Bdisplaymath%7D%0A%0A%5Cldots+and+this%3A%0A%5Cbegin%7Bequation%2A%7D%0A%5Csqrt%7Bx%5E2%2B1%7D%0A%5Cend%7Bequation%2A%7D%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, joka näyttää LaTeXilla ladottuja erilaisia matemaattisia lausekkeita](/files/6b5f57f0f862672be81ad90e85aea4bec13e8b5b)

LaTeXin matematiikan mahdollisuudet ovat rajattomat, joten muista käydä ohjesivuillamme saadaksesi neuvoja ja esimerkkejä tietyistä aiheista:

* [Matemaattiset lausekkeet](/latex/fi/matematiikka/01-mathematical-expressions.md)
* [Alaindeksit ja yläindeksit](/latex/fi/matematiikka/02-subscripts-and-superscripts.md)
* [Hakasulkeet ja sulut](/latex/fi/matematiikka/03-brackets-and-parentheses.md)
* [Murtoluvut ja binomit](/latex/fi/matematiikka/05-fractions-and-binomials.md)
* [Yhtälöiden tasaus](/latex/fi/matematiikka/06-aligning-equations-with-amsmath.md)
* [Operaattorit](/latex/fi/matematiikka/07-operators.md)
* [Välistys matematiikkatilassa](/latex/fi/matematiikka/08-spacing-in-math-mode.md)
* [Integraalit, summat ja raja-arvot](/latex/fi/matematiikka/09-integrals-sums-and-limits.md)
* [Näyttötyyli matematiikkatilassa](/latex/fi/matematiikka/10-display-style-in-math-mode.md)
* [Luettelo kreikkalaisista kirjaimista ja matemaattisista symboleista](/latex/fi/matematiikka/11-list-of-greek-letters-and-math-symbols.md)
* [Matemaattiset fontit](/latex/fi/matematiikka/12-mathematical-fonts.md)

## Dokumentin perusrakenne

Seuraavaksi tutkimme tiivistelmiä ja sitä, miten LaTeX-dokumentti jaetaan eri lukuihin, osioihin ja kappaleisiin.

### Tiivistelmät

Tieteelliset artikkelit sisältävät yleensä *tiivistelmä* joka on lyhyt yleiskatsaus/yhteenveto niiden keskeisistä aiheista tai argumenteista. Seuraava esimerkki havainnollistaa tiivistelmän ladontaa LaTeXin `tiivistelmä` ympäristöä:

```latex
\documentclass{article}
\begin{document}
\begin{abstract}
Tämä on yksinkertainen kappale
asiakirjan alussa. Lyhyt johdanto pääaiheeseen.
\end{abstract}
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=How+to+create+a+document+abstract\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Babstract%7D%0AThis+is+a+simple+paragraph+at+the+beginning+of+the+%0Adocument.+A+brief+introduction+about+the+main+subject.%0A%5Cend%7Babstract%7D%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, joka näyttää LaTeXilla ladotun tiivistelmän](/files/c1831e180dab68db77cbd0ae225985b755f62a48)

### Kappaleet ja uudet rivit

Kun tiivistelmä on paikallaan, voimme aloittaa ensimmäisen kappaleen kirjoittamisen. Seuraava esimerkki havainnollistaa:

* miten uusi kappale luodaan painamalla "enter"-näppäintä kahdesti, jolloin nykyinen rivi päättyy ja sen jälkeen lisätään tyhjä rivi;
* miten aloittaa uusi rivi aloittamatta uutta kappaletta lisäämällä käsin rivinvaihto käyttämällä `\\` komentoa, joka on kaksoiskenoviiva; vaihtoehtoisesti käytä `\newline` komento.

Tämän esimerkin kolmas kappale havainnollistaa komentojen käyttöä `\\` ja `\newline`:

```latex
\documentclass{article}
\begin{document}

\begin{abstract}
Tämä on yksinkertainen kappale
asiakirjan alussa. Lyhyt johdanto pääaiheeseen.
\end{abstract}

Tiivistelmämme jälkeen voimme aloittaa ensimmäisen kappaleen ja painaa sitten “enter” kahdesti aloittaaksemme toisen.

Tämä rivi aloittaa toisen kappaleen.

Aloitan kolmannen kappaleen ja lisään sitten \\ käsin rivinvaihdon, joka saa tämän tekstin alkamaan uudelta riviltä mutta säilyy silti osana samaa kappaletta. Vaihtoehtoisesti voin käyttää \verb|\newline|\newline-komentoa uuden rivin aloittamiseen, joka on myös osa samaa kappaletta.
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+to+create+a+new+paragraph\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cbegin%7Babstract%7D%0AThis+is+a+simple+paragraph+at+the+beginning+of+the+%0Adocument.+A+brief+introduction+about+the+main+subject.%0A%5Cend%7Babstract%7D%0A%0AAfter+our+abstract+we+can+begin+the+first+paragraph%2C+then+press+%60%60enter%27%27+twice+to+start+the+second+one.%0A%0AThis+line+will+start+a+second+paragraph.%0A%0AI+will+start+the+third+paragraph+and+then+add+%5C%5C+a+manual+line+break+which+causes+this+text+to+start+on+a+new+line+but+remains+part+of+the+same+paragraph.+Alternatively%2C+I+can+use+the+%5Cverb%7C%5Cnewline%7C%5Cnewline+command+to+start+a+new+line%2C+which+is+also+part+of+the+same+paragraph.%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, joka näyttää kappaleiden luomisen LaTeXissa](/files/94094fa5b6bf79a438367f5b8f91bac843add342)

Huomaa, miten LaTeX sisentää kappaleet automaattisesti—paitsi heti asiakirjan otsikoiden, kuten section- ja subsection-otsikoiden, jälkeen—[kuten näemme](#chapters-and-sections).

Uusille käyttäjille suositellaan, että useita `\\` tai `\newline`tyhjiä rivejä ei pitäisi käyttää ”simuloimaan” kappaleita, joiden välissä on suurempi väli, koska tämä voi häiritä LaTeXin ladonta-algoritmeja. Suositeltu tapa on jatkaa tyhjien rivien käyttämistä uusien kappaleiden luomiseen ilman mitään `\\`, ja lataa [`parskip` paketti](https://ctan.org/pkg/parskip?lang=en) lisäämällä `\usepackage{parskip}` esiotsakkeeseen.

Lisätietoja kappaleista löytyy seuraavista artikkeleista:

* [Kappaleet ja uudet rivit](/latex/fi/latexin-perusteet/02-paragraphs-and-new-lines.md)
* [Kappalevälin muuttaminen LaTeXissa](/latex/fi/muotoilu/04-articles-how-to-change-paragraph-spacing-in-latex.md)
* [LaTeX-virhe: Täällä ei ole riviä, joka voitaisiin päättää](/latex/fi/latex-virheet/18-latex-error-there-s-no-line-here-to-end.md) antaa lisävinkkejä ja ohjeita käytöstä `\\`.

### Luvut ja osiot

Pidemmät asiakirjat, riippumatta kirjoitusohjelmistosta, jaetaan yleensä osiin, lukuihin, osioihin, alaosioihin ja niin edelleen. LaTeX tarjoaa myös asiakirjan jäsentämiskomentoja, mutta käytettävissä olevat komennot ja niiden toteutukset (mitä ne tekevät) voivat riippua käytettävästä asiakirjaluokasta. Esimerkiksi asiakirjat, jotka on luotu käyttäen `book` luokka voidaan jakaa osiin, lukuihin, osioihin, alaosioihin ja niin edelleen, mutta `letter` luokka ei tarjoa (tukea) mitään komentoja siihen.

Seuraava esimerkki havainnollistaa komentoja, joita käytetään asiakirjan jäsentämiseen perustuen `book` luokkaan:

```latex
\documentclass{book}
\begin{document}

\chapter{Ensimmäinen luku}

\section{Introduction}

Tämä on ensimmäinen osio.

Lorem  ipsum  dolor  sit  amet,  consectetuer  adipiscing
elit. Etiam  lobortisfacilisis sem.  Nullam nec mi et
neque pharetra sollicitudin.  Praesent imperdietmi nec ante.
Donec ullamcorper, felis non sodales...

\section{Toinen osio}

Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisissem.  Nullam nec mi et neque pharetra
sollicitudin.  Praesent imperdiet mi necante...

\subsection{Ensimmäinen alaosio}
Praesent imperdietmi nec ante. Donec ullamcorper, felis non sodales...

\section*{Numeroimaton osio}
Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisissem...
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Book+class+example+document\&snip=%5Cdocumentclass%7Bbook%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cchapter%7BFirst+Chapter%7D%0A%0A%5Csection%7BIntroduction%7D%0A%0AThis+is+the+first+section.%0A%0ALorem++ipsum++dolor++sit++amet%2C++consectetuer++adipiscing++%0Aelit.+Etiam++lobortisfacilisis+sem.++Nullam+nec+mi+et+%0Aneque+pharetra+sollicitudin.++Praesent+imperdietmi+nec+ante.+%0ADonec+ullamcorper%2C+felis+non+sodales...%0A%0A%5Csection%7BSecond+Section%7D%0A%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.++%0AEtiam+lobortis+facilisissem.++Nullam+nec+mi+et+neque+pharetra+%0Asollicitudin.++Praesent+imperdiet+mi+necante...%0A%0A%5Csubsection%7BFirst+Subsection%7D%0APraesent+imperdietmi+nec+ante.+Donec+ullamcorper%2C+felis+non+sodales...%0A%0A%5Csection%2A%7BUnnumbered+Section%7D%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.++%0AEtiam+lobortis+facilisissem...%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, joka näyttää osiot LaTeXin book-asiakirjassa](/files/9d781933931fc017bc6a3b32806ac5efc1e87a5e)

Otsikkokomennot ovat enimmäkseen itsestään selviä; esimerkiksi `\chapter{Ensimmäinen luku}` luo uuden luvun nimeltä `Ensimmäinen luku`, `\section{Introduction}` luo osion nimeltä `Johdanto`, ja niin edelleen. Osiot voidaan jakaa edelleen `\subsection{...}` ja jopa `\subsubsection{...}`. Osioiden, alaosioiden jne. numerointi tapahtuu automaattisesti, mutta se voidaan poistaa käytöstä käyttämällä niin sanottua *tähdellistä versiota* sopivasta komennosta, jonka lopussa on asteriski (\*), kuten `\section*{...}` ja `\subsection*{...}`.

*Kaikkiaan*, LaTeXin asiakirjaluokat tarjoavat seuraavat jäsentämiskomennot, ja tietyt luokat tukevat niistä vain asiaankuuluvaa osajoukkoa:

* `\part{osa}`
* `\chapter{luku}`
* `\section{osio}`
* `\subsection{alaosio}`
* `\subsubsection{ala-alaosio}`
* `\paragraph{kappale}`
* `\subparagraph{alakappale}`

Erityisesti, `\part` ja `\chapter` komennot ovat käytettävissä vain `raportti` ja `book` asiakirjaluokissa.

Vieraile Overleaf-artikkelissa [artikkelissa osioista ja luvuista](/latex/fi/asiakirjan-rakenne/01-sections-and-chapters.md) saadaksesi lisätietoja asiakirjan rakenteen komennoista.

## Taulukoiden luominen

Overleaf tarjoaa kolme vaihtoehtoa taulukoiden luomiseen:

1. Käyttämällä [**Lisää taulukko**  -painiketta](/latex/fi/tietopankki/067-how-to-generate-and-insert-latex-tables-in-overleaf.md#inserttable) kansioon **visuaalista editoria** (tai **koodieditoria**) -työkalupalkki.
2. [Taulukon kopioiminen ja liittäminen](/latex/fi/tietopankki/075-how-to-paste-formatted-content-into-overleaf.md#pastingtables) toisesta asiakirjasta käyttäen **visuaalista editoria**.
3. Kirjoittamalla taulukon LaTeX-koodi Code Editorissa.

Jos olet uusi LaTeXin käyttäjä, työkalupalkin käyttäminen **visuaalista editoria** (vaihtoehto 1) on loistava tapa aloittaa — voit vaihtaa **visuaalista editoria** ja **koodieditoria** nähdäksesi taulukon taustalla olevan koodin.

Tässä keskitymme vaihtoehtoon 3 — joustavimpaan tapaan luoda taulukoita — ja tarjoamme esimerkkejä, jotka havainnollistavat taulukoiden luomista LaTeXissa, mukaan lukien viivojen (sääntöjen) ja kuvatekstien lisäämisen. Kun saat kokemusta, tutustu yksityiskohtaisiin ohjeisiimme aiheesta [kuinka taulukoita luodaan LaTeXilla](/latex/fi/kuvat-ja-taulukot/01-tables.md).

### Perustaulukon luominen LaTeXissa

Aloitamme esimerkillä, joka näyttää, miten perustaulukko ladotaan:

```latex
\begin{center}
\begin{tabular}{c c c}
 solu1 & solu2 & solu3 \\
 solu4 & solu5 & solu6 \\
 cell7 & cell8 & cell9
\end{tabular}
\end{center}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=An+example+of+a+basic+table\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A%5Cbegin%7Btabular%7D%7Bc+c+c%7D%0A+cell1+%26+cell2+%26+cell3+%5C%5C+%0A+cell4+%26+cell5+%26+cell6+%5C%5C++%0A+cell7+%26+cell8+%26+cell9++++%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D%0A%3C%2Fsource%3E)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Grafiikka, joka näyttää LaTeXissa ladotun taulukon](/files/59fae1c79c5d017d775dff43d391159a117e265b)

Se `tabular` ympäristö on LaTeXin oletustapa luoda taulukoita. Tälle ympäristölle on määritettävä parametri, tässä tapauksessa `{c c c}` mikä ilmoittaa LaTeXille, että sarakkeita on kolme ja että kunkin sisällä olevan tekstin tulee olla keskitetty. Voit käyttää myös `r` tekstin tasaamiseen oikealle ja `l` sen tasaamiseen vasemmalle. Tasaussymbolia `&` käytetään yksittäisten taulukon solujen erottamiseen taulukkorivin sisällä. Taulukkorivin päättämiseen käytä *uusi rivi* komento `\\`. Taulukkomme on sijoitettu `center` ympäristöön, jotta se keskitetään sivun tekstialueen leveyden mukaan.

### Reunusten lisääminen

Se `tabular` ympäristö tukee vaaka- ja pystysuoria viivoja (sääntöjä) osana taulukkoa:

* lisätäksesi vaakasäännöt rivien ylä- ja alapuolelle, käytä `\hline` komento
* lisätäksesi pystysäännöt sarakkeiden väliin, käytä pystysuoran viivan parametria `|`

Tässä esimerkissä argumentti on `{|c|c|c|}` joka ilmoittaa kolme (keskitettyä) saraketta, joita erottaa pystysuora viiva (sääntö); lisäksi käytämme `\hline` asettaaksemme vaakasäännön ensimmäisen rivin yläpuolelle ja viimeisen rivin alapuolelle:

```latex
\begin{center}
\begin{tabular}{|c|c|c|}
 \hline
 solu1 & solu2 & solu3 \\
 solu4 & solu5 & solu6 \\
 solu7 & solu8 & solu9 \\
 \hline
\end{tabular}
\end{center}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Table+example+with+rules\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A%5Cbegin%7Btabular%7D%7B%7Cc%7Cc%7Cc%7C%7D+%0A+%5Chline%0A+cell1+%26+cell2+%26+cell3+%5C%5C+%0A+cell4+%26+cell5+%26+cell6+%5C%5C+%0A+cell7+%26+cell8+%26+cell9+%5C%5C+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Grafiikka, joka näyttää LaTeXissa ladotun taulukon, jossa on vaaka- ja pystysuoria sääntöjä](/files/1a57969025cdbf1b15a0e4d883e7311750cf9d2f)

Tässä on toinen esimerkki:

```latex
\begin{center}
 \begin{tabular}{||c c c c||}
 \hline
 Col1 & Col2 & Col2 & Col3 \\ [0.5ex]
 \hline\hline
 1 & 6 & 87837 & 787 \\
 \hline
 2 & 7 & 78 & 5415 \\
 \hline
 3 & 545 & 778 & 7507 \\
 \hline
 4 & 545 & 18744 & 7560 \\
 \hline
 5 & 88 & 788 & 6344 \\ [1ex]
 \hline
\end{tabular}
\end{center}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Another+table+example+containing+rules\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0A%5Cbegin%7Bcenter%7D%0A+%5Cbegin%7Btabular%7D%7B%7C%7Cc+c+c+c%7C%7C%7D+%0A+%5Chline%0A+Col1+%26+Col2+%26+Col2+%26+Col3+%5C%5C+%5B0.5ex%5D+%0A+%5Chline%5Chline%0A+1+%26+6+%26+87837+%26+787+%5C%5C+%0A+%5Chline%0A+2+%26+7+%26+78+%26+5415+%5C%5C%0A+%5Chline%0A+3+%26+545+%26+778+%26+7507+%5C%5C%0A+%5Chline%0A+4+%26+545+%26+18744+%26+7560+%5C%5C%0A+%5Chline%0A+5+%26+88+%26+788+%26+6344+%5C%5C+%5B1ex%5D+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Cend%7Bcenter%7D%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Grafiikka, joka näyttää LaTeXissa ladotun taulukon, jossa on vaaka- ja pystysuoria sääntöjä](/files/4e73222aa1de6be1174f16e1e6397f2107f1ac88)

### Kuvatekstit, tunnisteet ja viitteet

Voit lisätä taulukoihin kuvatekstin ja viitata niihin lähes samalla tavalla kuin kuviin. Ainoa ero on, että **`figure`** ympäristön sijaan käytät **`table`** ympäristössä.

```latex
Taulukko \ref{table:data} näyttää, miten taulukkoon lisätään kuvateksti ja miten siihen viitataan.
\begin{table}[h!]
\centering
\begin{tabular}{||c c c c||}
 \hline
 Col1 & Col2 & Col2 & Col3 \\ [0.5ex]
 \hline\hline
 1 & 6 & 87837 & 787 \\
 2 & 7 & 78 & 5415 \\
 3 & 545 & 778 & 7507 \\
 4 & 545 & 18744 & 7560 \\
 5 & 88 & 788 & 6344 \\ [1ex]
 \hline
\end{tabular}
\caption{Taulukko kuvatekstien ja tunnisteiden testaamiseen.}
\label{table:data}
\end{table}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Table+captions+and+references\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ATable+%5Cref%7Btable%3Adata%7D+shows+how+to+add+a+table+caption+and+reference+a+table.%0A%5Cbegin%7Btable%7D%5Bh%21%5D%0A%5Ccentering%0A%5Cbegin%7Btabular%7D%7B%7C%7Cc+c+c+c%7C%7C%7D+%0A+%5Chline%0A+Col1+%26+Col2+%26+Col2+%26+Col3+%5C%5C+%5B0.5ex%5D+%0A+%5Chline%5Chline%0A+1+%26+6+%26+87837+%26+787+%5C%5C+%0A+2+%26+7+%26+78+%26+5415+%5C%5C%0A+3+%26+545+%26+778+%26+7507+%5C%5C%0A+4+%26+545+%26+18744+%26+7560+%5C%5C%0A+5+%26+88+%26+788+%26+6344+%5C%5C+%5B1ex%5D+%0A+%5Chline%0A%5Cend%7Btabular%7D%0A%5Ccaption%7BTable+to+test+captions+and+labels.%7D%0A%5Clabel%7Btable%3Adata%7D%0A%5Cend%7Btable%7D%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![LaTeX-taulukko kuvatekstillä](/files/ef5870afedaea9da05d52bc1498ebb70afc1a99b)

## Sisällysluettelon lisääminen

Sisällysluettelon luominen on suoraviivaista, koska komento `\tableofcontents` tekee melkein kaiken työn puolestasi:

```latex
\documentclass{article}
\title{Osiot ja luvut}
\author{Gubert Farnsworth}
\date{elokuu 2022}
\begin{document}

\maketitle

\tableofcontents

\section{Introduction}

Tämä on ensimmäinen osio.

Lorem  ipsum  dolor  sit  amet,  consectetuer  adipiscing
elit.   Etiam  lobortisfacilisis sem.  Nullam nec mi et
neque pharetra sollicitudin.  Praesent imperdietmi nec ante.
Donec ullamcorper, felis non sodales...

\section*{Numeroimaton osio}
\addcontentsline{toc}{section}{Numeroimaton osio}

Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisissem.  Nullam nec mi et neque pharetra
sollicitudin.  Praesent imperdiet mi necante...

\section{Toinen osio}

Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Etiam lobortis facilisissem.  Nullam nec mi et neque pharetra
sollicitudin.  Praesent imperdiet mi necante...
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Generating+a+table+of+contents\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BSections+and+Chapters%7D%0A%5Cauthor%7BGubert+Farnsworth%7D%0A%5Cdate%7BAugust+2022%7D%0A%5Cbegin%7Bdocument%7D%0A++%0A%5Cmaketitle%0A++%0A%5Ctableofcontents%0A%0A%5Csection%7BIntroduction%7D%0A+++%0AThis+is+the+first+section.%0A++++++%0ALorem++ipsum++dolor++sit++amet%2C++consectetuer++adipiscing++%0Aelit.+++Etiam++lobortisfacilisis+sem.++Nullam+nec+mi+et+%0Aneque+pharetra+sollicitudin.++Praesent+imperdietmi+nec+ante.+%0ADonec+ullamcorper%2C+felis+non+sodales...%0A+++++++%0A%5Csection%2A%7BUnnumbered+Section%7D%0A%5Caddcontentsline%7Btoc%7D%7Bsection%7D%7BUnnumbered+Section%7D%0A%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.++%0AEtiam+lobortis+facilisissem.++Nullam+nec+mi+et+neque+pharetra+%0Asollicitudin.++Praesent+imperdiet+mi+necante...%0A%0A%5Csection%7BSecond+Section%7D%0A+++++++%0ALorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit.++%0AEtiam+lobortis+facilisissem.++Nullam+nec+mi+et+neque+pharetra+%0Asollicitudin.++Praesent+imperdiet+mi+necante...%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Grafiikka, joka näyttää LaTeXin tuottaman sisällysluettelon](/files/811a26a104a2283d1d9cc8d92d0423fe2650c667)

Osiot, alaosiot ja luvut sisällytetään automaattisesti sisällysluetteloon. Jos haluat lisätä merkintöjä käsin, kuten numeroimattoman osion, käytä komentoa `\addcontentsline` kuten esimerkissä on esitetty.

## Valmiin asiakirjan lataaminen

Seuraava lyhyt videoleike näyttää, miten voit ladata projektisi lähdekoodin tai ladotun PDF-tiedoston:

{% embed url="<https://videos.ctfassets.net/nrgyaltdicpt/2n6iw0AUELNtABCuva0oV5/cf27bff3a6099da94362d64645e69dfe/LL30download.mp4>" %}

Lisätietoja löytyy Overleafin ohjeartikkelista [Työsi vieminen Overleafista](/latex/fi/tietopankki/036-exporting-your-work-from-overleaf.md).

## LaTeX-pakettien löytäminen ja käyttäminen

LaTeX ei ainoastaan tarjoa merkittäviä ladontaominaisuuksia, vaan myös *laajennettavuuden kehyksen* lisäosien avulla *paketteja*. Sen sijaan, että yritettäisiin tarjota komentoja ja ominaisuuksia, jotka ”yrittävät tehdä kaikkea”, LaTeX on suunniteltu olemaan *laajennettava*, jolloin käyttäjät voivat ladata ulkoisia koodikokonaisuuksia (paketteja), jotka tarjoavat erikoistuneempia ladontaominaisuuksia tai laajentavat LaTeXin sisäänrakennettuja ominaisuuksia—kuten taulukoiden ladontaa. Kuten todettiin osiossa [Kuvien lisääminen](#adding-images), `graphicx` paketti laajentaa LaTeXia tarjoamalla komentoja grafiikkatiedostojen tuomiseen, ja se ladattiin (esiotsakkeessa) kirjoittamalla

```latex
\usepackage{graphicx}
```

### Pakettien lataaminen

Kuten edellä todettiin, paketit ladataan asiakirjan esiotsakkeessa `\usepackage` komennolla, mutta koska (monet) LaTeX-paketit tarjoavat joukon *asetuksia*, joita voidaan käyttää niiden toiminnan määrittämiseen, komento `\usepackage` näyttää usein tältä:

```latex
\usepackage[options]{somepackage}
```

Hakasulkeet “`[...]`” ilmoittavat LaTeXille, mitä asetuksia tulee soveltaa, kun se lataa `somepackage`. Käyttäjän pyytämien asetusten joukossa yksittäiset asetukset erotetaan tavallisesti pilkulla; esimerkiksi [`geometry` paketti](https://ctan.org/pkg/geometry) tarjoaa monia vaihtoehtoja sivun asettelun määrittämiseen LaTeXissa, joten tyypillinen käyttö `geometry` voisi näyttää tältä:

```latex
\usepackage[total={6.5in,8.75in},
top=1.2in, left=0.9in, includefoot]{geometry}
```

Se `geometry` paketti on yksi esimerkki paketista, jonka ovat kirjoittaneet ja jonka ovat lahjoittaneet maailmanlaajuisen LaTeX-yhteisön jäsenet, ja joka on saatavilla maksutta kaikille, jotka haluavat käyttää sitä.

Jos LaTeX-paketti ei tarjoa lainkaan asetuksia tai käyttäjä haluaa käyttää asetusten oletusarvoja, se ladataan näin:

```latex
\usepackage{somepackage}
```

Kun kirjoitat `\usepackage[...]{somepackage}` LaTeX etsii vastaavaa tiedostoa nimeltä `*somepackage*.sty`, jonka se tarvitsee ladatakseen ja käsitelläkseen—toimittaakseen paketin komennot käytettäviksi ja suorittaakseen kaikki muut kyseisen paketin tarjoamat koodit. Jos LaTeX ei löydä `*somepackage*.sty` sitä, se lopettaa virheeseen, kuten seuraava Overleaf-esimerkki osoittaa:

```latex
\documentclass[12pt, letterpaper]{article}
\usepackage{somepackage}% olematon paketti
\begin{document}
Tämä epäonnistuu!
\end{document}
```

[Avaa tämä ***virheen aiheuttava esimerkki*** Overleafissa](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Error+due+to+missing+package\&snip=%5Cdocumentclass%5B12pt%2C+letterpaper%5D%7Barticle%7D%0A%5Cusepackage%7Bsomepackage%7D%25+a+NON-EXISTENT+package%0A%5Cbegin%7Bdocument%7D%0AThis+will+fail%21%0A%5Cend%7Bdocument%7D)

Tämä esimerkki tuottaa seuraavan tulosteen:

![Kuva, joka näyttää puuttuvan paketin aiheuttaman virheen](/files/6c51a7830db373b3f40ad49d1cdf6cb86630608e)

### Tietoa paketeista: CTAN

Paketit jaetaan [Comprehensive TeX Archive Networkin](https://www.ctan.org/), jota kutsutaan yleensä CTANiksi, ja joka kirjoitushetkellä isännöi 6287 pakettia 2881 tekijältä. CTAN [kuvailee itseään](https://www.ctan.org/ctan) as

> ... Internet-sivustojen kokonaisuudeksi ympäri maailmaa, jotka tarjoavat TEXiin liittyvää materiaalia ladattavaksi.

Voit selata CTANia etsiäksesi hyödyllisiä paketteja; esimerkiksi:

* [aiheittain](https://www.ctan.org/topics/cloud)
* [aakkosjärjestyksessä](https://www.ctan.org/pkg) (hyödyllinen, jos tiedät paketin nimen)

Voit käyttää myös [hakutoimintoa](https://www.ctan.org/pkg) (sivun yläreunassa).

### Overleafissa saatavilla olevat paketit: TeX Live -esittely

Kerran vuodessa (suuri) *osa* CTANissa isännöidyistä paketeista sekä LaTeXiin liittyvistä fonteista ja muusta ohjelmistosta kootaan ja jaetaan järjestelmänä nimeltä [TeX Live](https://tug.org/texlive/), jota voidaan käyttää oman (paikallisen) LaTeX-asennuksen asentamiseen. Itse asiassa [myös Overleafin palvelimet käyttävät TeX Liveä](/latex/fi/luokkatiedostot/02-overleaf-and-tex-live.md) ja niitä päivitetään, kun uusi TeX Liven versio julkaistaan. Overleafin TeX Live -päivitykset eivät ole välittömiä, vaan ne tehdään muutama kuukausi julkaisun jälkeen, mikä antaa meille aikaa tehdä yhteensopivuustestejä uuden TeX Live -version kanssa [galleriassamme olevien tuhansien mallipohjien](https://www.overleaf.com/gallery). Esimerkiksi tässä on meidän [TeX Live 2025 -päivitysilmoituksemme](https://www.overleaf.com/blog/tex-live-2025-is-now-available).

Vaikka TeX Live sisältää (suuren) *osa* CTAN-pakettien joukon, on mahdollista löytää kiinnostava paketti, kuten [`igo` Go-kaavioiden ladontaan](https://ctan.org/pkg/igo?lang=en), joka on CTANissa, mutta ei sisälly TeX Liveen (eikä sitä jaeta sen mukana), joten se ei ole saatavilla Overleafissa. Jotkin CTANissa isännöidyt paketit eivät kuulu TeX Liveen monista syistä: paketti voi olla vanhentunut, sillä voi olla lisensointiongelmia, se voi olla erittäin uusi (juuri ladattu) tai sillä voi olla alustariippuvuuksia, kuten toimiminen Windowsissa mutta ei Linuxissa.

Uudet paketit ja olemassa olevien päivitykset ladataan CTANiin ympäri vuoden, mutta TeX Live -päivitykset jaetaan vuosittain; näin ollen nykyisen TeX Live -version paketit eivät ole yhtä ajantasaisia kuin CTANissa isännöidyt. Koska Overleafin palvelimet käyttävät TeX Liveä, on mahdollista, että palvelimillemme asennetut paketit — eli käyttäjillemme saatavilla olevat paketit — eivät ole aivan uusimpia CTANissa olevia versioita, mutta yleensä tämä tuskin aiheuttaa ongelmia.


---

# 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/latexin-perusteet/01-learn-latex-in-30-minutes.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.
