> 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/texlive/fi/latexin-perusteet/opi-latex-30-minuutissa.md).

# Opi LaTeX 30 minuutissa

> **UUSI:** Vieraile uudessa [Overleafin oppimiskeskuksessa](https://learn.overleaf.com/) ja tutustu maksuttomiin verkkokursseihin ja live-webinaareihin — kaikkeen, mitä tarvitset LaTeXin hallitsemiseen ja Overleafin täyteen hyödyntämiseen.

Tämä johdanto-opas ei edellytä aiempaa kokemusta LaTeXista, mutta toivottavasti siihen mennessä, kun olet valmis, et ole ainoastaan kirjoittanut ensimmäistä LaTeX-asiakirjaasi, vaan olet 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 taittoon. LaTeXin toimintatapa on kuitenkin melko erilainen kuin monissa muissa asiakirjantuotantosovelluksissa, joita saatat olla käyttänyt, kuten Microsoft Wordissa tai LibreOffice Writerissa: nämä “[WYSIWYG](https://en.wikipedia.org/wiki/WYSIWYG)” -työkalut tarjoavat käyttäjille vuorovaikutteisen sivun, johon he kirjoittavat ja muokkaavat tekstiään sekä soveltavat erilaisia muotoiluja. LaTeX toimii hyvin eri tavalla: sen sijaan asiakirjasi on pelkkä tekstitiedosto, johon on lisätty LaTeX *komentoja* ilmaisemaan halutut (ladotut) tulokset. Näkyvän, ladotun asiakirjan tuottamiseksi LaTeX-tiedostosi käsittelee ohjelmisto, jota kutsutaan *TeX-moottoriksi* joka käyttää tekstitiedostoosi upotettuja komentoja ohjaamaan ja hallitsemaan ladontaprosessia, muuntaen LaTeX-komennot ja asiakirjatekstin ammattimaisesti ladotuksi PDF-tiedostoksi. Tämä tarkoittaa, että sinun tarvitsee keskittyä vain asiakirjasi *sisältöön* ja tietokone huolehtii LaTeX-komentojen ja TeX-moottorin avulla *ulkoasusta* (muotoilusta).

## Miksi opetella LaTeX?

LaTeXin käytön opettelun puolesta tai sitä vastaan voidaan esittää monenlaisia perusteluja muiden asiakirjantekosovellusten sijaan; lopulta kyse on kuitenkin henkilökohtaisesta valinnasta, joka perustuu mieltymyksiin, taipumuksiin ja dokumentointivaatimuksiin.

LaTeXin puolesta puhuvia perusteluja ovat:

* tuki erittäin monimutkaisten matematiikan kaavojen, taulukoiden ja teknisen sisällön ladontaan fysiikan aloilla;
* mahdollisuudet alaviitteisiin, ristiviittauksiin ja lähdeluetteloiden hallintaan;
* mahdollisuus tuottaa helposti monimutkaisia tai työläitä asiakirjan osia, kuten hakemistoja, sanastoja, sisällysluetteloita ja kuvaluetteloita;
* erittäin muokattavissa räätälöityyn asiakirjatuotantoon sen luontaisen ohjelmoitavuuden ja tuhansien [maksuttomien lisäosapakettien](https://www.ctan.org/pkg).

Kaiken kaikkiaan LaTeX tarjoaa käyttäjille paljon hallintaa erittäin korkeatasoisesti ladottujen asiakirjojen tuottamiseen. Toki on olemassa asiakirjatyyppejä tai julkaisuja, joissa LaTeX ei loista, mukaan lukien monet “vapaamuotoiset” sivuasettelut, joita tyypillisesti löytyy aikakauslehtityyppisistä julkaisuista.

Yksi tärkeä LaTeXin hyöty on asiakirjan sisällön erottaminen sen tyylistä: kun olet kirjoittanut asiakirjasi sisällön, sen ulkoasua voidaan muuttaa helposti. Samoin voit luoda LaTeX-tiedoston, joka määrittää tietyn asiakirjatyypin asettelun/tyylin, ja sitä tiedostoa voidaan käyttää *mallina* kyseisen tyyppisten lisäasiakirjojen kirjoittamisen/tuotannon yhdenmukaistamiseen; esimerkiksi tämä antaa tieteellisille kustantajille mahdollisuuden luoda artikkelimalleja LaTeXilla, joita kirjoittajat käyttävät lehtiin lähetettävien artikkelien kirjoittamiseen. Overleafissa on [galleria, jossa on tuhansia mallipohjia](https://www.overleaf.com/gallery), jotka kattavat valtavan valikoiman asiakirjatyyppejä—kaiken tieteellisistä artikkeleista, raporteista ja kirjoista ansioluetteloihin ja esityksiin. Koska nämä mallipohjat määrittävät asiakirjan asettelun ja tyylin, kirjoittajien tarvitsee vain avata ne Overleafissa—luoda uusi projekti—ja aloittaa kirjoittaminen sisällön lisäämiseksi.

## Ensimmäisen LaTeX-asiakirjasi kirjoittaminen

Ensimmäinen askel on luoda uusi LaTeX-projekti. Voit tehdä tämän omalla tietokoneellasi luomalla uuden `.tex` tiedoston; vaihtoehtoisesti voit [aloittaa uuden projektin Overleafissa](broken://pages/f54745eea412096bf3284ba79d3a3de48aff102f).

Aloitetaan yksinkertaisimmalla toimivalla esimerkillä, joka voidaan avata suoraan Overleafissa:

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

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 tuloksen:

![Esimerkkiasiakirja](https://images.ctfassets.net/nrgyaltdicpt/5oBbZABsWEnHZpwhfvV2PD/95ba7d5496616b4f10dffe6fb90f578a/LL30Fig1-plain.svg)

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

Koodin ensimmäinen rivi, `\documentclass{article}`, määrittää asiakirjatyypin, joka tunnetaan sen *luokkana*, ja se ohjaa asiakirjan yleisilmettä. Erilaiset asiakirjatyypit vaativat eri luokkia; esimerkiksi CV/ansioluettelo vaatii eri luokan kuin tieteellinen artikkeli, joka saattaisi käyttää LaTeXin vakiomuotoista `article` luokkaa. Muut asiakirjatyypit, joiden parissa saatat työskennellä, voivat vaatia eri luokkia, kuten `book` tai `report`. Saadaksesi käsityksen monista saatavilla olevista LaTeX-luokkatyypeistä, [vieraile CTANin (Comprehensive TeX Archive Network) asianmukaisella sivulla](https://www.ctan.org/topic/class).

Kun asiakirjaluokka on asetettu, sisältömme, jota kutsutaan asiakirjan *tekstiksi* , 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ä asiakirjan uudelleen*. Tee tämä Overleafissa yksinkertaisesti painamalla **Käännä uudelleen**, kuten tässä lyhyessä videokatkelmassa näytetään:

Jokainen Overleaf-projekti voidaan määrittää kääntymään automaattisesti uudelleen aina, kun sitä muokataan: napsauta pientä nuolta **Käännä uudelleen** painikkeen vieressä ja aseta **Automaattinen käännös** arvoon **Päällä**, kuten seuraavassa kuvakaappauksessa näkyy:

![Kuvakaappaus, joka näyttää, miten Automaattinen käännös asetetaan tilaan Päällä tai Pois](/files/23be19e95f948c846b3f475759dd94d52cb6b816)

Kun olemme nähneet, miten sisältö lisätään asiakirjaamme, seuraava askel on antaa sille otsikko. Tätä varten meidän on puhuttava lyhyesti **esipuheesta**.

## Asiakirjan esipuhe

Yllä oleva kuvakaappaus näyttää Overleafin tallentavan LaTeX-asiakirjan tiedostona nimeltä `main.tex`: `.tex` tiedostopääte on käytännön mukaisesti käytössä nimettäessä tiedostoja, jotka sisältävät asiakirjasi LaTeX-koodin.

Edellinen esimerkki näytti, kuinka asiakirjan sisältö syötettiin `\begin{document}` komennon `.tex` jälkeen; kuitenkin kaikki tiedostossasi *ennen* tuota kohtaa kutsutaan *esipuheesta*, joka toimii asiakirjan “asetukset”-osana. Esipuheessa määrittelet asiakirjaluokan (tyypin) sekä yksityiskohdat, kuten kielet, joita käytetään asiakirjaa kirjoitettaessa; lataat *paketteja* joita haluat käyttää (lisää tästä [myöhemmin](#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages)), ja siellä määrität myös muita asetuksia.

Pieni 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, sijoitetaan hakasulkeisiin (`[...]`) ja niitä käytetään tämän article-luokan tämän esiintymän asetusten määrittämiseen; eli asetukset, joita haluamme käyttää tässä tietyn `article`-luokkaan perustuvassa asiakirjassa.

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

* `12pt` asettaa fonttikoon
* `letterpaper` asettaa paperikoon

Toki muitakin fonttikokoja, `9pt`, `11pt`, `12pt`, voidaan käyttää, mutta jos mitään ei ole määritetty, oletuskoko on `10pt`. Paperikoon osalta muita mahdollisia arvoja ovat `a4paper` ja `legalpaper`. Lisätietoja löytyy artikkelista aiheesta [sivukoko ja reunukset](broken://pages/bab884b1f185c987b64d2733169a2ef34abecdab).

Esipuherivi

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

on esimerkki ulkoisen paketin lataamisesta (tässä, [graphicx](https://ctan.org/pkg/graphicx?lang=en)) LaTeXin ominaisuuksien laajentamiseksi, jotta se voi tuoda ulkoisia grafiikkatiedostoja. LaTeX-paketeista kerrotaan osiossa [LaTeX-pakettien löytäminen ja käyttäminen](#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages).

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

Otsikon, tekijän ja päivämäärän lisääminen asiakirjaamme vaatii kolme lisäriviä *esipuheesta* (*ei* asiakirjan pääosaan). Nuo rivit ovat:

* `\title{My first LaTeX document}`: asiakirjan otsikko
* `\author{Hubert Farnsworth}`: tähän kirjoitat tekijän (tekijöiden) nimen ja valinnaisesti `\thanks` komennon aaltosulkeiden sisään:
  * `\thanks{Funded by the Overleaf team.}`: voidaan lisätä tekijän nimen jälkeen, `tekijä` komennon aaltosulkeiden sisään. Se lisää yläindeksin ja alaviitteen, jonka teksti on aaltosulkeiden sisällä. Hyödyllinen, jos haluat kiittää artikkelissasi jotakin instituutiota.
* `\date{August 2022}`: voit syöttää päivämäärän käsin tai käyttää komentoa `\today` ladotaksesi nykyisen päivämäärän aina, kun asiakirja käännetään

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

```latex
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
```

Otsikon, tekijän ja päivämäärän ladonta tehdään käyttämällä `\maketitle` komentoa *tekstiksi* asiakirjan

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

Esipuhe ja leipäteksti voidaan nyt yhdistää täydelliseksi asiakirjaksi, joka voidaan avata Overleafissa:

```latex
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
\begin{document}
\maketitle
Olemme nyt lisänneet otsikon, tekijän ja päivämäärän ensimmäiseen \LaTeX{}-asiakirjaamme!
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 tuloksen:

![Kuva yksinkertaisesta LaTeXilla tuotetusta asiakirjasta](https://images.ctfassets.net/nrgyaltdicpt/3WzMd0bx2zlj3zLTKS8SxT/dc2b7c16adbc96bdd750b6d2c8b4227e/LL30Fig2r-plain.svg)

## Kommenttien lisääminen

LaTeX on eräänlaista “ohjelmakoodia”, mutta sellaista, joka erikoistuu asiakirjojen ladontaan; siksi, kuten missä tahansa muussa ohjelmointikielessä kirjoitetussa koodissa, kommenttien lisääminen asiakirjaan voi olla erittäin hyödyllistä. LaTeX-kommentti on tekstiosa, jota ei ladota eikä se vaikuta asiakirjaan millään tavalla—sitä käytetään usein “tehtävä”-muistioihin; selittävien huomautusten lisäämiseen; hankalien makrojen sisäisiin selityksiin; tai LaTeX-koodin rivien/osien kommentoimiseen pois käytöstä virheenkorjauksen aikana.

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

```latex
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
\begin{document}
\maketitle
Olemme nyt lisänneet otsikon, tekijän ja päivämäärän ensimmäiseen \LaTeX{}-asiakirjaamme!

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

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 tuloksen, joka on identtinen edellisen LaTeX-koodin kanssa, jossa kommenttia ei ollut.

## Lihavointi, kursivointi ja alleviivaus

Seuraavaksi tarkastelemme joitakin tekstin muotoilukomentoja:

* **Lihavointi**: lihavoitu teksti LaTeXissa ladotaan käyttäen `\textbf{...}` komentoa.
* *Kursivointi*: kursivoitu teksti tuotetaan käyttäen `\textit{...}` komentoa.
* Alleviivaus: tekstin alleviivaamiseen käytä `\underline{...}` komentoa.

Seuraava esimerkki havainnollistaa näitä komentoja:

```latex
Jotkin \textbf{suurimmista}
löydöistä \underline{tieteessä} 
tehtiin \textbf{\textit{vahingossa}}.
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 tuloksen:

![Kuva, joka näyttää tekstin muotoilun LaTeX-asiakirjassa](https://images.ctfassets.net/nrgyaltdicpt/6vo15r0tLCByTpcvn1w2E8/8f14edc7ece1f10ce4ba2c76e1e58a56/LL30Fig3r-plain.svg)

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

```latex
Jotkin suurimmista \emph{löydöistä} tieteessä 
tehtiin vahingossa.

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

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

[Avaa tämä **\emph** esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=Using+the+emph+command\&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%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 tuloksen:

![Kuva, joka havainnollistaa LaTeX \emph -komennon käyttöä](https://images.ctfassets.net/nrgyaltdicpt/1K0A8RXXOomakJBAr2usmp/62d0e8b5275092dd0b1b4a59c745b632/LL30Fig4r-plain.svg)

* **Huom:** jotkin paketit, kuten [Beamer](broken://pages/b6a43de9161d205de99ff15a1ad2dc213316667d), muuttavat `\emph` komentoa.

## Kuvien lisääminen

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

1. Käytä [**Lisää kuva**  -painiketta](https://learn.overleaf.com/learn/Kb/How%5Fto%5Finsert%5Ffigures%5Fin%5FOverleaf#Using%5FInsert%5FFigure%5Fto%5Fadd%5Fa%5Ffigure%5Fto%5Fyour%5Fproject)(![The Insert Figure button on the editor toolbar](https://sharelatex-wiki-cdn-671420.cdn77.org/learn-scripts/images/a/a8/InsertFigureButton.png)), joka sijaitsee editorin työkalupalkissa, lisätäksesi kuvan **Visual Editoriin** tai **koodieditoriin**.
2. [Kopioi ja liitä kuva](broken://pages/8536067db038cb81581eff23115b90db38680083) kohtaan **Visual Editoriin** tai **koodieditoriin**.
3. Käytä **koodieditoriin** LaTeX-koodin kirjoittamiseen, joka lisää grafiikan.

Vaihtoehdot 1 ja 2 tuottavat automaattisesti kuvan lisäämiseen tarvittavan LaTeX-koodin, mutta tässä esittelemme vaihtoehdon 3—huomaa, että sinun täytyy [ladata nuo kuvat](https://docs.overleaf.com/writing-and-editing/inserting-images) Overleaf-projektiisi. Seuraava esimerkki havainnollistaa, miten kuva lisätään:

```latex
\documentclass{article}
\usepackage{graphicx} %LaTeX-paketti grafiikan tuontiin
\graphicspath{{images/}} %graphicx-paketin asetukset
 
\begin{document}
Universumi on valtava ja näyttää olevan homogeeninen, 
suurella mittakaavalla, kaikkialla minne katsomme.

% \includegraphics-komento on 
% tarjottu (toteutettu) 
% graphicx-paketin kautta
\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 tuloksen:

![Kuva, joka näyttää kuvan tuonnin LaTeX-asiakirjaan](https://images.ctfassets.net/nrgyaltdicpt/4p5toat08FUgehv4yuNwXS/efc9e75e4342c9caeec94f26627fa337/LL30Fig5v2-plain.svg)

Grafiikan tuominen LaTeX-asiakirjaan edellyttää [lisäosaa *pakettia*](#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages) joka tarjoaa komennot ja ominaisuudet, joita tarvitaan ulkoisten grafiikkatiedostojen sisällyttämiseen. Yllä oleva esimerkki lataa [graphicx-paketin](https://ctan.org/pkg/graphicx?lang=en) joka tarjoaa monien muiden komentojen ohella `\includegraphics{...}` grafiikan tuontiin ja `\graphicspath{...}` ohjeistaakseen LaTeXia, missä grafiikka sijaitsee.

Käyttääksesi `graphicx` pakettia, lisää seuraava rivi Overleaf-asiakirjasi 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 hakevan kansioon tallennettuja kuvia](https://sharelatex-wiki-cdn-671420.cdn77.org/learn-scripts/images/1/17/ImagesInAFolder.png)

Komento `\includegraphics{universe}` tekee varsinaisen työn kuvan lisäämiseksi asiakirjaan. Tässä, `universe` on kuvatiedoston nimi ilman tiedostopäätettä.

**Huom**:

* Vaikka koko tiedostonimi, mukaan lukien tiedostopääte, on sallittu `\includegraphics` komennossa, on parasta jättää tiedostopääte pois, koska se kehottaa LaTeXia etsimään kaikkia tuettuja formaatteja.
* Yleisesti ottaen grafiikan tiedostonimessä ei pitäisi olla välilyöntejä tai useita pisteitä; on myös suositeltavaa käyttää pieniä kirjaimia tiedostopäätteessä, kun kuvatiedostoja ladataan Overleafiin.

Lisätietoja LaTeX-paketeista löytyy tämän oppaan lopusta osiosta [LaTeX-pakettien löytäminen ja käyttäminen](#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages).

## Kuvatekstit, tunnisteet ja viittaukset

Kuville voidaan lisätä kuvateksti, tunniste ja viittaus käyttäen `figure` -ympäristöä, kuten alla näkyy:

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

\begin{figure}[h]
    \centering
    \includegraphics[width=0.75\textwidth]{mesh}
    \caption{A nice plot.}
    \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 tuloksen:

![Kuva, joka havainnollistaa kuvatekstien käyttöä LaTeXissa](https://images.ctfassets.net/nrgyaltdicpt/4DkAWWkQqZP6QHU2EErogQ/9aa2371f2cde0f3f8bf22aa1c0b91789/LL30Fig6r-plain.svg)

Esimerkissä on useita huomionarvoisia komentoja:

* **`\includegraphics[width=0.75\textwidth]{mesh}`**: Tämä muoto `\includegraphics` ohjaa LaTeXin asettamaan kuvan leveydeksi 75 % tekstin leveydestä — jonka arvo on tallennettu `\textwidth` komentoa.
* **`\caption{A nice plot.}`**: 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}`**: Viitataksesi tähän kuvaan asiakirjassasi annat sille tunnisteen käyttämällä `\label` komentoa. Tunnistetta käytetään kuvalle numeron luomiseen, ja yhdessä seuraavan komennon kanssa sen avulla voit viitata siihen.
* **`\ref{fig:mesh1}`**: Tämä koodi korvataan vastaavalla viitattua kuvaa vastaavalla numerolla.

LaTeX-asiakirjaan sisällytetyt kuvat tulisi sijoittaa `figure` ympäristön tai vastaavan sisään, jotta LaTeX voi automaattisesti sijoittaa kuvan sopivaan kohtaan asiakirjassa.

Lisäohjeita löytyy seuraavista Overleafin ohjeartikkeleista:

* [Kuvien sijoittaminen](broken://pages/54be3bdead523d2cd4cb1de1e665d209e4e0c06e)
* [Kuvien lisääminen](https://docs.overleaf.com/writing-and-editing/inserting-images)

## Luetteloiden luominen LaTeXissa

Voit luoda erilaisia luettelotyyppejä 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 `\end{_environment-name_}` jossa `_environment-name_` voi 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 luettelomerkinnän edellä on oltava `\item` komento, kuten alla näkyy:

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

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 tuloksen:

![Esimerkki luettelomerkeillä merkityistä listoista LaTeXissa](https://images.ctfassets.net/nrgyaltdicpt/1lDj29Mg9ZuLNHXwZrTJew/cd7d950c65fd05b251c4aa55746f4eb7/LL30Fig7-plain.svg)

Voit myös avata tämän [laajemman 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 erilaisia 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äen `enumerate` ympäristöä:

```latex
\documentclass{article}
\begin{document}
\begin{enumerate}
  \item Tämä on ensimmäinen merkintä luettelossamme.
  \item Luettelon numerot kasvavat joka kerta, kun lisäämme uuden merkinnän.
\end{enumerate}
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 tuloksen:

![Esimerkki numeroidusta luettelosta, joka on tuotettu LaTeXilla](https://images.ctfassets.net/nrgyaltdicpt/2vkfa7RiAIJxv5wIZbg9UK/530c384f159d091a587de279d13fefec/LL30Fig8-plain.svg)

Kuten `järjestämättömät` luetteloissa, jokaisen merkinnän edessä täytyy olla `\item` komento, joka tässä tuottaa automaattisesti numeroidun luettelon numeromerkinnän alkaen 1:stä.

Lisätietoja varten voit avata tämän [laajemman 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 esittelee erilaisia LaTeX-luetteloiden tyyppejä tai vierailla omistetussa [ohjeartikkelissamme LaTeX-luetteloista](broken://pages/ba5e91ef74d472edeca967d620705c79c91755d9), joka tarjoaa paljon lisää esimerkkejä ja näyttää, miten luodaan mukautettuja luetteloita.

## Matematiikan lisääminen LaTeXiin

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

* *rivinsisäinen* matematiikkatila kaavojen kirjoittamiseen, jotka ovat osa kappaletta
* *erillinen* matematiikkatila lausekkeiden kirjoittamiseen, jotka eivät ole osa tekstiä tai kappaletta ja jotka ladotaan omille riveilleen

### Rivinsisäinen matematiikkatila

Katsotaanpa esimerkki rivinsisäisestä matematiikkatilasta:

```latex
\documentclass[12pt, letterpaper]{article}
\begin{document}
Fysiikassa massa-energiaekvivalenssi 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%5Fname=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 tuloksen:

![Kuva, joka näyttää rivinsisäisessä matematiikkatilassa ladottua matematiikkaa](https://images.ctfassets.net/nrgyaltdicpt/77oK8pfew1B1VvxiBtALag/15714f2da4e469bbb8cf70a0d3733e5d/LL30Fig9-plain.svg)

Rivinsisäisen matematiikan ladontaan voit käyttää yhtä näistä erotinpareista: `\( ... \)`, `$ ... $` tai `\begin{math} ... \end{math}`, kuten seuraava esimerkki osoittaa:

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

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 tuloksen:

![Kuva, joka havainnollistaa LaTeXin rivinsisäisessä matematiikkatilassa tuotettua sisältöä](https://images.ctfassets.net/nrgyaltdicpt/46VPfEGxYJ3di18TLzaLo9/ed67df07532c52b6543fd2bae7cb7c04/LL30Fig10r-plain.svg)

### Erillinen matematiikkatila

Erillistilassa ladotut yhtälöt voivat olla numeroituja tai numeroimattomia, kuten seuraavassa esimerkissä:

```latex
\documentclass[12pt, letterpaper]{article}
\begin{document}
Massa-energiaekvivalenssia kuvaa kuuluisa yhtälö
\[ E=mc^2 \], jonka Albert Einstein löysi vuonna 1905. 

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

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 tuloksen:

![Kuva, joka näyttää LaTeXin erillisessä matematiikkatilassa ladottua matematiikkaa](https://images.ctfassets.net/nrgyaltdicpt/6n1FPYFzmzCHPpWoEoYQZM/79b33f1096be06326bff7d2e1976c67c/LL30Fig11-plain.svg)

Erillisen matematiikan ladontaan voit käyttää yhtä näistä erotinpareista: `\[ ... \]`, `\begin{displaymath} ... \end{displaymath}` tai `\begin{equation} ... \end{equation}`. Historiallisesti erillistilan matematiikan ladonta vaati käyttämään `$$` merkkierottimia, kuten `$$ _... display math here ..._$$`, mutta tämä menetelmä [ei ole enää suositeltu](https://texfaq.org/FAQ-dolldoll): käytä sen sijaan LaTeXin erotinmerkkejä `\[ ... \]` sen sijaan.

### Lisää täydellisiä esimerkkejä

Seuraavat esimerkit havainnollistavat monenlaista matemaattista sisältöä ladottuna LaTeXilla.

```latex
\documentclass{article}
\begin{document}
Alaindeksit matematiikkatilassa kirjoitetaan muodossa $a_b$ ja yläindeksit muodossa $a^b$. Näitä voidaan yhdistää ja sisäkkäistää, jotta voidaan kirjoittaa 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}) \]
 
Integraalit kirjoitetaan käyttäen $\int$-merkkiä ja murtoluvut käyttäen $\frac{a}{b}$. Raja-arvot sijoitetaan integraaleihin ylä- ja alaindeksien avulla:

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

Pienet kreikkalaiset kirjaimet kirjoitetaan muodossa $\omega$ $\delta$ jne., kun taas isot 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%5Fname=More+advanced+LaTeX+math+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cbegin%7Bdocument%7D%0ASubscripts+in+math+mode+are+written+as+%24a%5Fb%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%5F1+i%5F2+%5Cdots+i%5Fp%7D%5F%7Bj%5F1+j%5F2+%5Cdots+j%5Fq%7D+%3D+T%28x%5E%7Bi%5F1%7D%2C%5Cdots%2Cx%5E%7Bi%5Fp%7D%2Ce%5F%7Bj%5F1%7D%2C%5Cdots%2Ce%5F%7Bj%5Fq%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%5F0%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 tuloksen:

![Kuva, joka näyttää laajan valikoiman LaTeXilla ladottua matematiikkaa](https://images.ctfassets.net/nrgyaltdicpt/5xfm4NybWckHL5ndpdnBRq/bc0b5e27044820ea5cdd11648a68f543/LL30Fig12r-plain.svg)

Seuraava esimerkki käyttää `equation*` ympäristöä, jonka tarjoaa `amsmath` -paketti, joten meidän on lisättävä seuraava rivi dokumentin johdantoon:

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

Lisätietoja käytöstä `amsmath` katso [ohjeartikkelimme](broken://pages/a29f4c1ffc0b1db653112769fb49e3bc402340f0).

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

Tunnettu Pythagoraan lause \\(x^2 + y^2 = z^2\\) osoittautui virheelliseksi muilla eksponenteilla, mikä tarkoittaa, että seuraavalla yhtälöllä ei 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äkin on 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%5Fname=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 tuloksen:

![Kuva, joka näyttää laajan valikoiman LaTeXilla ladottua matematiikkaa](https://images.ctfassets.net/nrgyaltdicpt/hT85gkewCDlxCHeNU5slE/9256c129b25bec7a93dcfe9e44b0654a/LL30Fig13r-plain.svg)

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

* [Matemaattiset lausekkeet](broken://pages/d3d0db72457f8f8d35e51c3b40ab655dd31b04df)
* [Alaindeksit ja yläindeksit](broken://pages/373d9714381d7c6bdbc5ae2e716b88b44e0f9b6c)
* [Hakasulkeet ja sulkeet](broken://pages/ce761a78e4ef03bdafcecda7ee1450945447f39d)
* [Murtoluvut ja binomit](broken://pages/f3cbf5b4ee26baf344f106a5a260340ffc2c6959)
* [Yhtälöiden tasaaminen](broken://pages/f48ea0980cdeabb8db60c7ffa87babc7c0b09484)
* [Operaattorit](broken://pages/ec6f2778031081799bfb85380aeeb3c4d4e1f154)
* [Välistys matematiikkatilassa](broken://pages/0a0c840b28f19a217a56c6d12e82a57538fbd4d1)
* [Integraalit, summat ja raja-arvot](broken://pages/68ad91933536ea5060455403a4c111fa9aef202b)
* [Näyttötyyli matematiikkatilassa](broken://pages/212034534ff37ede6e6cf5e364e93a73d7dd065d)
* [Luettelo kreikkalaisista kirjaimista ja matemaattisista symboleista](broken://pages/99465dcfe60c31b8b23d11ec3cc9d0c9798fe0a9)
* [Matemaattiset fontit](broken://pages/f2ee61e3857c1e0f57c9cc2610287c99d881084c)

## Asiakirjan perusrakenne

Seuraavaksi tarkastelemme tiivistelmiä ja sitä, miten LaTeX-asiakirja jaetaan eri lukuihin, osioihin ja kappaleisiin.

### Tiivistelmät

Tieteelliset artikkelit sisältävät yleensä *tiivistelmän* , joka on lyhyt yleiskatsaus/yhteenveto niiden keskeisistä aiheista tai väitteistä. Seuraava esimerkki havainnollistaa tiivistelmän ladontaa käyttäen LaTeXin `tiivistelmän` 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%5Fname=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 tuloksen:

![Kuva, joka näyttää LaTeXilla ladotun tiivistelmän](https://images.ctfassets.net/nrgyaltdicpt/4cPu8x8ZxuDVF6efcZ03yi/91aa6aa84719613b0e25c725b70aa0b8/LL30Fig14-plain.svg)

### Kappaleet ja uudet rivit

Kun tiivistelmä on paikallaan, voimme alkaa kirjoittaa ensimmäistä kappalettamme. 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 aloitetaan uusi rivi aloittamatta uutta kappaletta lisäämällä manuaalinen rivinvaihto käyttäen `\\` komentoa, joka on kaksinkertainen kenoviiva; vaihtoehtoisesti käytä `\newline` komentoa.

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än 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 \\ manuaalisen rivinvaihdon, joka saa tämän tekstin alkamaan uudelta riviltä, mutta se pysyy osana samaa kappaletta. Vaihtoehtoisesti voin käyttää komentoa \verb|\newline|\newline aloittaakseni uuden rivin, joka on myös osa samaa kappaletta.
\end{document}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 tuloksen:

![Kuva, joka näyttää kappaleiden luomisen LaTeXissa](https://images.ctfassets.net/nrgyaltdicpt/5DdSH06hFli8k4lR0dxw4m/a55cddf9aa10b64302ae7b72ba0c6447/LL30Fig15r-plain.svg)

Huomaa, että LaTeX sisentää kappaleet automaattisesti — paitsi heti asiakirjan otsikoiden, kuten section- ja subsection-otsikoiden, jälkeen —[kuten tulemme näkemään](#Chapters%5Fand%5Fsections).

Uusille käyttäjille suositellaan, että useita `\\` tai `\newline`s ei pitäisi käyttää “simuloimaan” kappaleita, joiden väli on suurempi, 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}` johdantoon.

Lisätietoja kappaleista löytyy seuraavista artikkeleista:

* [Kappaleet ja uudet rivit](broken://pages/8ae5a0c9e997118fef76f7a7736c6ed6cb589049)
* [Miten kappaleväliä muutetaan LaTeXissa](broken://pages/86d40b7e64ed18b06f54379b18f33409a8587bd2)
* [LaTeX-virhe: Tässä ei ole riviä, joka päättyisi](broken://pages/5802979ab4bda3f4d69e0795f7ebc1da160cc019) tarjoaa lisäneuvoja 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 rakenteistamiseen tarkoitettuja komentoja, mutta käytettävissä olevat komennot ja niiden toteutukset (mitä ne tekevät) voivat riippua käytetystä 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 sitä varten.

Seuraava esimerkki havainnollistaa komentoja, joita käytetään asiakirjan rakenteistamiseen perustuen `book` -luokkaan:

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

\chapter{Ensimmäinen luku}

\section{Johdanto}

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%5Fname=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 tuloksen:

![Kuva, joka näyttää osiot LaTeX-kirjaluokassa](https://images.ctfassets.net/nrgyaltdicpt/1A1T7YsurQdM058OwmLqd8/7f6e962c31356bafa702bab9062f6061/LL30Fig16-plain.svg)

Rakenteistamiskomentojen nimet ovat enimmäkseen itsestään selviä; esimerkiksi `\chapter{Ensimmäinen luku}` luo uuden luvun nimeltä `Ensimmäinen luku`, `\section{Johdanto}` tuottaa osion nimeltä `Johdanto`, ja niin edelleen. Osiot voidaan jakaa edelleen `\subsection{...}` ja jopa `\subsubsection{...}`. Osioiden, alaosioiden jne. numerointi on automaattista, mutta sen voi poistaa käytöstä käyttämällä niin sanottua *tähtiversiota* asianmukaisesta komennosta, jossa on lopussa asteriski (\*), kuten `\section*{...}` ja `\subsection*{...}`.

*Kaiken kaikkiaan*, LaTeX-asiakirjaluokat tarjoavat seuraavat rakenteistamiskomennot, ja tietyt luokat tukevat kukin niistä vain olennaista alajoukkoa:

* `\part{part}`
* `\chapter{chapter}`
* `\section{section}`
* `\subsection{subsection}`
* `\subsubsection{subsubsection}`
* `\paragraph{paragraph}`
* `\subparagraph{subparagraph}`

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

Vieraile Overleafin artikkelissa [artikkelissa osioista ja luvuista](broken://pages/0e2d608a34b4a1b2dca9b444f52442c18240bfff) saadaksesi lisätietoa asiakirjan rakenteistamiskomennoista.

## Taulukoiden luominen

Overleaf tarjoaa kolme vaihtoehtoa taulukoiden luomiseen:

1. Käyttäen [**Lisää taulukko**  -painiketta](https://www.overleaf.com/learn/how-to/How%5Fto%5Finsert%5Ftables%5Fin%5FOverleaf%23inserttable#Using%5FInsert%5FTable%5Fto%5Fcreate%5Fa%5Ftable%5Fin%5Fyour%5Fproject) -toimintoa **Visual Editoriin** (tai **koodieditoriin**) työkalupalkissa.
2. [Taulukon kopioiminen ja liittäminen](https://www.overleaf.com/learn/how-to/How%5Fto%5Fpaste%5Fformatted%5Fcontent%5Finto%5FOverleaf%23pastingtables) toisesta asiakirjasta käyttäen **Visual Editoriin**.
3. Taulukon LaTeX-koodin kirjoittaminen koodieditorissa.

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

Tässä keskitymme vaihtoehtoon 3 — joustavimpaan tapaan luoda taulukoita — ja tarjoamme esimerkkejä, jotka havainnollistavat, miten taulukoita luodaan LaTeXissa, mukaan lukien viivojen (rulejen) ja kuvatekstien lisääminen. Kun kartutat kokemusta, tutustu yksityiskohtaiseen ohjeeseemme aiheesta [kuinka luoda taulukoita LaTeXin avulla](https://www.overleaf.com/learn/latex/Tables).

### Yksinkertaisen taulukon luominen LaTeXissa

Aloitamme esimerkillä, joka näyttää, miten yksinkertainen taulukko ladotaan:

```latex
\begin{center}
\begin{tabular}{c c c}
 cell1 & cell2 & cell3 \\ 
 cell4 & cell5 & cell6 \\  
 cell7 & cell8 & cell9    
\end{tabular}
\end{center}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 tuloksen:

![Grafiikka, joka näyttää LaTeXilla ladotun taulukon](https://images.ctfassets.net/nrgyaltdicpt/5K46QavbKv9vF4RI1GbUf2/f22d4f8a06d00251166f86d2c891321e/LL30Fig17-plain.svg)

Komento `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ä kertoo LaTeXille, että sarakkeita on kolme ja että kunkin sarakkeen sisällä olevan tekstin on oltava keskitetty. Voit myös käyttää `r` tekstin tasaamiseen oikealle ja `l` tekstin tasaamiseen vasemmalle. Tasausmerkkiä `&` käytetään erottamaan yksittäiset taulukon solut taulukon rivin sisällä. Taulukon rivin lopettamiseen käytä *rivinvaihto* -komentoa `\\`. Taulukkomme on sijoitettu `center` -ympäristöön, jotta se keskitetään sivun tekstialueen leveydelle.

### Reunojen lisääminen

Komento `tabular` ympäristö tukee vaakasuoria ja pystysuoria viivoja (rules) osana taulukkoa:

* vaakaviivojen lisäämiseen rivien ylä- ja alapuolelle käytä `\hline` -komentoa
* pystysuorien viivojen lisäämiseen sarakkeiden väliin käytä pystyviivaparametria `|`

Tässä esimerkissä argumentti on `{|c|c|c|}` joka ilmoittaa kolmesta (keskitetystä) sarakkeesta, joista kukin on erotettu pystysuoralla viivalla (rule); lisäksi käytämme `\hline` asettaaksemme vaakaviivan ensimmäisen rivin yläpuolelle ja viimeisen rivin alapuolelle:

```latex
\begin{center}
\begin{tabular}{|c|c|c|} 
 \hline
 cell1 & cell2 & cell3 \\ 
 cell4 & cell5 & cell6 \\ 
 cell7 & cell8 & cell9 \\ 
 \hline
\end{tabular}
\end{center}
```

[Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 tuloksen:

![Grafiikka, joka näyttää LaTeXilla ladotun taulukon, jossa on vaaka- ja pystyviivoja](https://images.ctfassets.net/nrgyaltdicpt/5uWYGUhK1XJJJaWz5R1EmX/3ee88bf6b2eaf8d0644b57fa8064800b/LL30Fig18-plain.svg)

Tässä on vielä yksi esimerkki:

```latex
\begin{center}
 \begin{tabular}{||c c c c||} 
 \hline
 Sarake1 & Sarake2 & Sarake2 & Sarake3 \\ [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%5Fname=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 tuloksen:

![Grafiikka, joka näyttää LaTeXilla ladotun taulukon, jossa on vaaka- ja pystyviivoja](https://images.ctfassets.net/nrgyaltdicpt/1Cy9FcRnDVDRUPQdCgaKq6/c21e5f7d9a53514756c6e1f2996e51e0/LL30Fig19-plain.svg)

### Kuvatekstit, tunnisteet ja viittaukset

Voit lisätä taulukoihin kuvatekstin ja viitteen lähes samalla tavalla kuin kuviin. Ainoa ero on se, että **`figure`** -ympäristön sijasta käytät **`table`** -ympäristöä.

Taulukko \ref{table:data} näyttää, miten taulukkoon lisätään kuvateksti ja miten taulukkoon viitataan.

```latex
\begin{table}[h!]
\centering
\begin{tabular}{||c c c c||} 
 \hline
 Sarake1 & Sarake2 & Sarake2 & Sarake3 \\ [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%5Fname=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 tuloksen:

![LaTeX-taulukko kuvatekstillä](https://images.ctfassets.net/nrgyaltdicpt/1f5w74UIaTCkpApaPdVeWf/580a87c2413ddc9d6bdef3bf462689fc/LL30Fig20-plain.svg)

## Sisällysluettelon lisääminen

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

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

\section{Johdanto}
   
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%5Fname=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 tuloksen:

![Grafiikka, joka näyttää LaTeXilla tuotetun sisällysluettelon](https://images.ctfassets.net/nrgyaltdicpt/MxY592Q6EGsDKMA2mZw0t/fffa41a0a0d30770526f73aff72a7be1/LL30Fig21r-plain.svg)

Osiot, alaosiot ja luvut sisällytetään automaattisesti sisällysluetteloon. Lisätäksesi merkintöjä manuaalisesti, 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:

Lisätietoja löytyy Overleafin ohjeartikkelista [Työn vieminen Overleafista](https://docs.overleaf.com/managing-projects-and-files/downloading-a-project).

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

LaTeX ei ainoastaan tarjoa merkittäviä ladontaominaisuuksia, vaan myös *laajennettavuuden kehikon* lisäosien avulla *paketteja*. Sen sijaan, että pyrittäisiin tarjoamaan komentoja ja ominaisuuksia, jotka “yrittävät tehdä kaiken”, 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 osiossa todettiin [Kuvien lisääminen](#Adding%5Fimages), `graphicx` paketti laajentaa LaTeXia tarjoamalla komennot grafiikkatiedostojen tuomiseen ja se ladattiin (johdannossa) kirjoittamalla

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

### Pakettien lataaminen

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

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

Hakasulkeet “`[...]`” kertovat LaTeXille, mitä asetusjoukkoa tulee soveltaa, kun se lataa `somepackage`. Käyttäjän pyytämien asetusten joukossa yksittäiset asetukset erotetaan tyypillisesti 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}
```

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

Jos LaTeX-paketti ei tarjoa mitään valitsimia tai jos käyttäjä haluaa käyttää paketin valitsimien oletusarvoja, se ladattaisiin näin:

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

Kun kirjoitat `\usepackage[...]{somepackage}` LaTeX etsii vastaavaa tiedostoa nimeltä `_somepackage_.sty`, jonka sen on ladattava ja käsiteltävä – jotta paketin komennot saadaan käyttöön ja paketin tarjoama muu koodi suoritetaan. Jos LaTeX ei löydä `_somepackage_.sty` sitä, se lopettaa virheilmoitukseen, kuten seuraavassa Overleaf-esimerkissä osoitetaan:

```latex
\documentclass[12pt, letterpaper]{article}
\usepackage{somepackage}% a NON-EXISTENT package
\begin{document}
Tämä epäonnistuu!
\end{document}
```

[Avaa tämä ***virheen tuottava esimerkki*** Overleafissa](https://www.overleaf.com/docs?engine=pdflatex\&snip%5Fname=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 tuloksen:

![Kuva, joka näyttää puuttuvan paketin aiheuttaman virheen](https://sharelatex-wiki-cdn-671420.cdn77.org/learn-scripts/images/6/60/LL30packagefail.png)

### Tietoa paketeista: CTAN

Paketit jaetaan kautta [Comprehensive TeX Archive Network](https://www.ctan.org/), johon yleensä viitataan lyhenteellä CTAN, ja joka tätä kirjoitettaessa isännöi 6287 pakettia 2881 avustajalta. CTAN [kuvaa itseään](https://www.ctan.org/ctan) seuraavasti:

> ... joukko Internet-sivustoja ympäri maailmaa, jotka tarjoavat TEX-aiheista 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ödyllistä, jos tiedät paketin nimen)

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

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

Kerran vuodessa (suuri) *osajoukko* CTANissa isännöidyistä paketeista sekä LaTeXiin liittyvistä fonteista ja muista ohjelmistoista 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ä](https://www.overleaf.com/learn/latex/Overleaf%5Fand%5FTeX%5FLive) ja ne päivitetään, kun TeX Liven uusi versio julkaistaan. Overleafin TeX Live -päivitykset eivät tapahdu heti, vaan muutaman kuukauden kuluttua julkaisusta, mikä antaa meille aikaa suorittaa uuden TeX Live -version yhteensopivuustestit [galleriamme sisältämille tuhansille mallipohjille](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) *osajoukko* osan CTAN-paketeista, on mahdollista löytää kiinnostava paketti [igo Go-kaavioiden ladontaan](https://ctan.org/pkg/igo?lang=en), joka on isännöity CTANissa mutta jota ei sisälly TeX Liveen (eikä jaeta sen mukana), joten se ei ole saatavilla Overleafissa. Jotkin CTANissa isännöidyt paketit eivät kuulu TeX Liveen monista syistä: ehkä paketti on vanhentunut, siinä on lisenssiongelmia, se on erittäin uusi (äskettäin ladattu) tai sillä on alustariippuvuuksia, kuten toimiminen Windowsissa mutta ei Linuxissa.

Uusia paketteja sekä päivityksiä olemassa oleviin paketteihin ladataan CTANiin ympäri vuoden, mutta TeX Liven päivitykset jaetaan vuosittain; siksi TeX Liven nykyisessä versiossa olevat paketit eivät ole yhtä ajan tasalla kuin CTANissa isännöidyt. Koska Overleafin palvelimet käyttävät TeX Liveä, on mahdollista, että palvelimillemme asennetut paketit — eli käyttäjiemme käytettävissä olevat paketit — eivät ole aivan uusimpia CTANissa saatavilla olevia versioita, mutta yleensä tästä ei todennäköisesti aiheudu 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/texlive/fi/latexin-perusteet/opi-latex-30-minuutissa.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.
