> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Opi LaTeX 30 minuutissa

> <strong>UUTTA:</strong> Tutustu uuteen [Overleaf Learning Centeriin](https://learn.overleaf.com/), josta löydät ilmaisia verkkokursseja ja live-webinaareja — kaiken, mitä tarvitset LaTeXin hallitsemiseen ja Overleafin tehokkaaseen hyödyntämiseen.

Tämä johdanto-opas ei edellytä aiempaa kokemusta LaTeXista, mutta toivottavasti sen lopussa olet paitsi kirjoittanut ensimmäisen LaTeX-dokumenttisi, myös hankkinut riittävästi tietoa ja itsevarmuutta ottaaksesi seuraavat askeleet kohti LaTeXin sujuvaa hallintaa.

## Mikä on LaTeX?

LaTeX (lausutaan ”*LEI*-tek” tai ”*LAA*-tek”) on työkalu ammattimaisen näköisten dokumenttien latomiseen. LaTeXin toimintatapa poikkeaa kuitenkin melko paljon monista muista mahdollisesti käyttämistäsi dokumenttien tuotantosovelluksista, kuten Microsoft Wordista tai LibreOffice Writeristä: nuo ”[WYSIWYG](https://en.wikipedia.org/wiki/WYSIWYG)”-työkalut tarjoavat käyttäjälle interaktiivisen sivun, jolle tekstiä kirjoitetaan ja muokataan ja johon sovelletaan erilaisia muotoiluja. LaTeX toimii hyvin eri tavalla: dokumenttisi on sen sijaan pelkkä tekstitiedosto, jonka sekaan on kirjoitettu LaTeX-*komentoja*, joilla ilmaistaan haluttu (ladottu) lopputulos. Näkyvän, ladotun dokumentin tuottamiseksi LaTeX-tiedostosi käsitellään ohjelmalla, jota kutsutaan *TeX-moottoriksi*. Se käyttää tekstitiedostoon upotettuja komentoja latomisprosessin ohjaamiseen ja muuntaa LaTeX-komennot ja dokumentin tekstin ammattimaisesti ladotuksi PDF-tiedostoksi. Tämä tarkoittaa, että sinun tarvitsee keskittyä vain dokumenttisi *sisältöön*, ja tietokone huolehtii LaTeX-komentojen ja TeX-moottorin avulla *ulkoasusta* (muotoilusta).

## Miksi opetella LaTeX?

LaTeXin opettelemisen puolesta tai sitä vastaan muiden dokumenttien laatimissovellusten sijaan voidaan esittää monenlaisia perusteita; lopulta kyse on kuitenkin henkilökohtaisesta valinnasta, joka perustuu mieltymyksiin, taipumuksiin ja dokumentaatiotarpeisiin.

LaTeXin puolesta puhuvat muun muassa:

* tuki erittäin monimutkaisen matematiikan, taulukoiden ja luonnontieteiden teknisen sisällön latomiselle;
* alaviitteiden, ristiviittausten ja lähdeluetteloiden hallinnan työkalut;
* monimutkaisten tai työläiden dokumenttielementtien, kuten hakemistojen, sanastojen, sisällysluetteloiden ja kuvaluetteloiden, tuottamisen helppous;
* erittäin laaja muokattavuus räätälöityjen dokumenttien tuottamiseen sen sisäänrakennetun ohjelmoitavuuden ja tuhansien [ilmaisten lisäpakettien](https://www.ctan.org/pkg) tarjoaman laajennettavuuden ansiosta.

Kaiken kaikkiaan LaTeX antaa käyttäjille paljon hallintaa dokumenttien tuottamiseen, ja dokumentit ladotaan erittäin korkeiden standardien mukaisesti. On toki dokumentti- tai julkaisutyyppejä, joissa LaTeX ei loista, kuten monet aikakauslehtityyppisille julkaisuille tyypilliset ”vapaamuotoiset” sivuasettelut.

Yksi LaTeXin tärkeistä eduista on dokumentin sisällön erottaminen sen tyylistä: kun olet kirjoittanut dokumenttisi sisällön, sen ulkoasua voi muuttaa helposti. Vastaavasti voit luoda LaTeX-tiedoston, joka määrittää tietyn dokumenttityypin asettelun/tyylin, ja tätä tiedostoa voidaan käyttää *mallina* saman tyypin muiden dokumenttien laatimisen/tuottamisen yhdenmukaistamiseen. Tämä mahdollistaa esimerkiksi sen, että tieteelliset kustantajat voivat luoda LaTeXilla artikkelimalleja, joita kirjoittajat käyttävät kirjoittaessaan lehtiin lähetettäviä artikkeleita. Overleafilla on [galleria, jossa on tuhansia malleja](https://www.overleaf.com/gallery), ja ne kattavat valtavan valikoiman dokumenttityyppejä — kaikkea tieteellisistä artikkeleista, raporteista ja kirjoista ansioluetteloihin ja esityksiin. Koska nämä mallit määrittävät dokumentin asettelun ja tyylin, kirjoittajien tarvitsee vain avata ne Overleafissa — jolloin luodaan uusi projekti — ja aloittaa sisällön kirjoittaminen.

## Ensimmäisen LaTeX-tekstisi kirjoittaminen

Ensimmäinen vaihe on luoda uusi LaTeX-projekti. Voit tehdä sen omalla tietokoneellasi luomalla uuden `.tex`-tiedoston tai vaihtoehtoisesti aloittaa uuden projektin Overleafissa.

Aloitetaan yksinkertaisimmasta toimivasta esimerkistä, jonka voi avata suoraan Overleafissa:

```latex theme={null}
\documentclass{article}
\begin{document}
First document. This is a simple example, with no 
extra parameters or packages included.
\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 tulosteen:

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

Kuten näet, LaTeX on automaattisesti sisentänyt kappaleen ensimmäisen rivin ja hoitanut tämän muotoilun puolestasi. Tarkastellaan lähemmin, mitä koodin kukin osa tekee.

Koodin ensimmäinen rivi, `\documentclass{article}`, ilmoittaa dokumentin tyypin, jota kutsutaan sen *luokaksi* (class) ja joka määrää dokumentin yleisilmeen. Eri dokumenttityypit vaativat eri luokkia; esimerkiksi ansioluettelo vaatii eri luokan kuin tieteellinen artikkeli, joka saattaa käyttää LaTeXin vakioluokkaa `article`. Muut työstämäsi dokumenttityypit voivat vaatia muita luokkia, kuten `book` tai `report`. Saadaksesi käsityksen monista saatavilla olevista LaTeX-luokista [vieraile asiaankuuluvalla sivulla CTANissa (Comprehensive TeX Archive Network)](https://www.ctan.org/topic/class).

Kun dokumenttiluokka on asetettu, sisältömme eli dokumentin *runko* (body) kirjoitetaan tagien `\begin{document}` ja `\end{document}` väliin. Kun olet avannut yllä olevan esimerkin, voit tehdä muutoksia tekstiin ja lopuksi tarkastella syntyvää ladottua PDF-tiedostoa *kääntämällä dokumentin uudelleen*. Overleafissa tämä tapahtuu yksinkertaisesti painamalla **Recompile**, kuten tässä lyhyessä videoleikkeessä näytetään:

Minkä tahansa Overleaf-projektin voi määrittää kääntymään automaattisesti uudelleen aina, kun sitä muokataan: napsauta **Recompile**-painikkeen vieressä olevaa pientä nuolta ja aseta **Auto Compile** tilaan **On**, kuten seuraavassa kuvakaappauksessa näytetään:

<img src="https://mintcdn.com/ayakaleaf-pro/GmaXa-Cu4QQRFT4C/images/texlive/ll30autocompile.png?fit=max&auto=format&n=GmaXa-Cu4QQRFT4C&q=85&s=a109144b1a0939f182ce202207687428" alt="Kuvakaappaus, joka näyttää, miten Auto Compile asetetaan tilaan On tai Off" width="1820" height="831" data-path="images/texlive/ll30autocompile.png" />

Nyt kun olemme nähneet, miten dokumenttiin lisätään sisältöä, seuraava vaihe on antaa sille otsikko. Tätä varten meidän on puhuttava hetki **johdanto-osasta** (preamble).

## Dokumentin johdanto-osa

Yllä oleva kuvakaappaus näyttää, kuinka Overleaf tallentaa LaTeX-dokumentin tiedostoon nimeltä `main.tex`: `.tex`-tiedostopäätettä käytetään sopimuksen mukaan nimettäessä tiedostoja, jotka sisältävät dokumenttisi LaTeX-koodin.

Edellinen esimerkki näytti, kuinka dokumentin sisältö kirjoitettiin `\begin{document}`-komennon jälkeen; kaikkea `.tex`-tiedostossasi tätä kohtaa *ennen* olevaa kutsutaan kuitenkin *johdanto-osaksi* (preamble), joka toimii dokumentin ”asetusosiona”. Johdanto-osassa määrität dokumentin luokan (tyypin) sekä yksityiskohtia, kuten dokumentin kirjoittamisessa käytettävät kielet; lataat *paketit*, joita haluat käyttää (lisää tästä [myöhemmin](/fi/texlive/latex-basics/learn-latex-in-30-minutes#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages)), ja siellä teet myös muun tyyppiset määritykset.

Minimaalinen dokumentin johdanto-osa voisi näyttää tältä:

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

jossa `\documentclass[12pt, letterpaper]{article}` määrittää dokumentin yleisen luokan (tyypin). Lisäparametrit, jotka on erotettava pilkuilla, kirjoitetaan hakasulkeisiin (`[...]`), ja niillä määritetään tämä article-luokan ilmentymä; eli asetukset, joita haluamme käyttää tässä nimenomaisessa `article`-luokkaan perustuvassa dokumentissa.

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

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

Muitakin fonttikokoja, `9pt`, `11pt`, `12pt`, voi tietenkin käyttää, mutta jos kokoa ei määritetä, oletuskoko on `10pt`. Paperikoon muita mahdollisia arvoja ovat `a4paper` ja `legalpaper`. Lisätietoja on sivukokoa ja marginaaleja käsittelevässä artikkelissa.

Johdanto-osan rivi

```latex theme={null}
\usepackage{graphicx}
```

on esimerkki ulkoisen paketin (tässä [graphicx](https://ctan.org/pkg/graphicx?lang=en)) lataamisesta LaTeXin ominaisuuksien laajentamiseksi, jolloin se pystyy tuomaan ulkoisia grafiikkatiedostoja. LaTeX-paketteja käsitellään osiossa [LaTeX-pakettien löytäminen ja käyttäminen](/fi/texlive/latex-basics/learn-latex-in-30-minutes#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 dokumenttiin vaatii kolme riviä lisää *johdanto-osaan* (*ei* dokumentin varsinaiseen runkoon). Nämä rivit ovat:

* `\title{My first LaTeX document}`: dokumentin otsikko
* `\author{Hubert Farnsworth}`: tähän kirjoitetaan tekijän (tekijöiden) nimi ja valinnaisesti `\thanks`-komento aaltosulkeiden sisään:
  * `\thanks{Funded by the Overleaf team.}`: voidaan lisätä tekijän nimen perään `author`-komennon aaltosulkeiden sisään. Se lisää yläindeksin ja alaviitteen, jossa on aaltosulkeiden sisällä oleva teksti. Hyödyllinen, jos haluat kiittää jotakin instituutiota artikkelissasi.
* `\date{August 2022}`: voit syöttää päivämäärän käsin tai käyttää komentoa `\today`, jolloin kuluva päivämäärä ladotaan aina, kun dokumentti käännetään

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

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

Otsikko, tekijä ja päivämäärä ladotaan käyttämällä `\maketitle`-komentoa dokumentin *rungossa*:

```latex theme={null}
\begin{document}
\maketitle
We have now added a title, author and date to our first \LaTeX{} document!
\end{document}
```

Johdanto-osa ja runko voidaan nyt yhdistää kokonaiseksi dokumentiksi, jonka voi avata Overleafissa:

```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
\begin{document}
\maketitle
We have now added a title, author and date to our first \LaTeX{} document!
\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 tulosteen:

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

## Kommenttien lisääminen

LaTeX on eräänlaista ”ohjelmakoodia”, mutta se on erikoistunut dokumenttien latomiseen; siksi, kuten millä tahansa muulla ohjelmointikielellä kirjoitetussa koodissa, kommenttien lisääminen dokumenttiin voi olla erittäin hyödyllistä. LaTeX-kommentti on tekstin osa, jota ei ladota ja joka ei vaikuta dokumenttiin millään tavalla — sitä käytetään usein ”tehtävä”-muistiinpanojen lisäämiseen, selittävien huomautusten sisällyttämiseen, hankalien makrojen selittämiseen koodin seassa tai LaTeX-koodin rivien/osioiden kommentoimiseen pois virheenetsinnän aikana.

Kommentin tekemiseksi LaTeXissa kirjoita yksinkertaisesti `%`-merkki rivin alkuun, kuten seuraavassa yllä olevaa esimerkkiä käyttävässä koodissa näytetään:

```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\title{My first LaTeX document}
\author{Hubert Farnsworth\thanks{Funded by the Overleaf team.}}
\date{August 2022}
\begin{document}
\maketitle
We have now added a title, author and date to our first \LaTeX{} document!

% This line here is a comment. It will not be typeset in the document.
\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 täsmälleen saman tulosteen kuin edellinen LaTeX-koodi, jossa kommenttia ei ollut.

## Lihavointi, kursivointi ja alleviivaus

Seuraavaksi tarkastelemme muutamia tekstin muotoilukomentoja:

* **Lihavointi**: lihavoitu teksti ladotaan LaTeXissa komennolla `\textbf{...}`.
* *Kursivointi*: kursivoitu teksti tuotetaan komennolla `\textit{...}`.
* Alleviivaus: alleviivaa teksti komennolla `\underline{...}`.

Seuraava esimerkki havainnollistaa näitä komentoja:

```latex theme={null}
Some of the \textbf{greatest}
discoveries in \underline{science} 
were made by \textbf{\textit{accident}}.
```

[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 tulosteen:

![Kuva LaTeX-dokumentin muotoillusta tekstistä](https://images.ctfassets.net/nrgyaltdicpt/6vo15r0tLCByTpcvn1w2E8/8f14edc7ece1f10ce4ba2c76e1e58a56/LL30Fig3r-plain.svg)

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

```latex theme={null}
Some of the greatest \emph{discoveries} in science 
were made by accident.

\textit{Some of the greatest \emph{discoveries} 
in science were made by accident.}

\textbf{Some of the greatest \emph{discoveries} 
in science were made by accident.}
```

[Avaa tämä <strong>\emph</strong>-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 tulosteen:

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

* <strong>Huomautus:</strong> jotkin paketit, kuten Beamer, muuttavat `\emph`-komennon toimintaa.

## Kuvien lisääminen

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

1. Käytä editorin työkalupalkissa olevaa [**Insert Figure** -painiketta](https://learn.overleaf.com/learn/Kb/How_to_insert_figures_in_Overleaf#Using%5FInsert%5FFigure%5Fto%5Fadd%5Fa%5Ffigure%5Fto%5Fyour%5Fproject)(![Insert Figure -painike editorin työkalupalkissa](https://sharelatex-wiki-cdn-671420.cdn77.org/learn-scripts/images/a/a8/InsertFigureButton.png)) lisätäksesi kuvan **Visual Editoriin** tai **Code Editoriin**.
2. Kopioi ja liitä kuva **Visual Editoriin** tai **Code Editoriin**.
3. Kirjoita **Code Editorissa** LaTeX-koodia, joka lisää grafiikan.

Vaihtoehdot 1 ja 2 luovat automaattisesti kuvien lisäämiseen tarvittavan LaTeX-koodin, mutta tässä esittelemme vaihtoehdon 3 — huomaa, että sinun on [ladattava kyseiset kuvat](https://docs.overleaf.com/writing-and-editing/inserting-images) Overleaf-projektiisi. Seuraava esimerkki näyttää, miten kuva sisällytetään:

```latex theme={null}
\documentclass{article}
\usepackage{graphicx} %LaTeX package to import graphics
\graphicspath{{images/}} %configuring the graphicx package
 
\begin{document}
The universe is immense and it seems to be homogeneous, 
on a large scale, everywhere we look.

% The \includegraphics command is 
% provided (implemented) by the 
% graphicx package
\includegraphics{universe}  
 
There's a picture of a galaxy above.
\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:

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

Grafiikan tuominen LaTeX-dokumenttiin vaatii [lisä\_paketin\_](/fi/texlive/latex-basics/learn-latex-in-30-minutes#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages), joka tarjoaa ulkoisten grafiikkatiedostojen sisällyttämiseen tarvittavat komennot ja ominaisuudet. Yllä oleva esimerkki lataa [graphicx-paketin](https://ctan.org/pkg/graphicx?lang=en), joka monien muiden komentojen ohella tarjoaa komennon `\includegraphics{...}` grafiikan tuomiseen ja komennon `\graphicspath{...}`, jolla LaTeXille kerrotaan, missä grafiikka sijaitsee.

Käyttääksesi `graphicx`-pakettia lisää seuraava rivi Overleaf-dokumenttisi johdanto-osaan:

```latex theme={null}
\usepackage{graphicx}
```

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

![Kuva, joka näyttää LaTeXin käyttävän kansioon tallennettuja kuvia](https://sharelatex-wiki-cdn-671420.cdn77.org/learn-scripts/images/1/17/ImagesInAFolder.png)

Komento `\includegraphics{universe}` hoitaa varsinaisen työn eli kuvan lisäämisen dokumenttiin. Tässä `universe` on kuvatiedoston nimi ilman tiedostopäätettä.

**Huomautus**:

* Vaikka koko tiedostonimi päätteineen on sallittu `\includegraphics`-komennossa, parhaana käytäntönä pidetään tiedostopäätteen jättämistä pois, koska tällöin LaTeX etsii kaikkia tuettuja formaatteja.
* Yleisesti ottaen grafiikkatiedoston nimessä ei tulisi olla välilyöntejä tai useita pisteitä; on myös suositeltavaa käyttää tiedostopäätteessä pieniä kirjaimia, kun kuvatiedostoja ladataan Overleafiin.

Lisätietoja LaTeX-paketeista löytyy tämän opetusohjelman lopusta osiosta [LaTeX-pakettien löytäminen ja käyttäminen](/fi/texlive/latex-basics/learn-latex-in-30-minutes#Finding%5Fand%5Fusing%5FLaTeX%5Fpackages).

## Kuvatekstit, nimiöt ja viittaukset

Kuviin voidaan lisätä kuvatekstejä, nimiöitä ja viittauksia `figure`-ympäristön avulla, kuten alla näytetään:

```latex theme={null}
\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}
 
As you can see in figure \ref{fig:mesh1}, the function grows near the origin. This example is on page \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:

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

Esimerkissä on useita huomionarvoisia komentoja:

* **`\includegraphics[width=0.75\textwidth]{mesh}`**: Tämä `\includegraphics`-muoto ohjeistaa LaTeXia asettamaan kuvan leveydeksi 75 % tekstin leveydestä — jonka arvo on tallennettu `\textwidth`-komentoon.
* **`\caption{A nice plot.}`**: Kuten nimestä voi päätellä, tämä komento asettaa kuvatekstin, joka voidaan sijoittaa kuvan ylä- tai alapuolelle. Jos luot kuvaluettelon, tätä kuvatekstiä käytetään siinä.
* **`\label{fig:mesh1}`**: Viitataksesi tähän kuvaan dokumentissasi annat sille nimiön `\label`-komennolla. Nimiöstä luodaan kuvalle numero, ja yhdessä seuraavan komennon kanssa sen avulla voit viitata kuvaan.
* **`\ref{fig:mesh1}`**: Tämä koodi korvataan viitatun kuvan numerolla.

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

Lisäohjeita löytyy seuraavista Overleafin ohjeartikkeleista:

* Kuvien sijoittelu
* [Kuvien lisääminen](https://docs.overleaf.com/writing-and-editing/inserting-images)

## Luetteloiden luominen LaTeXissa

Voit luoda erityyppisiä luetteloita *ympäristöjen* (environments) avulla. Ympäristöjä käytetään kapseloimaan tietyn latomisominaisuuden toteuttamiseen tarvittava LaTeX-koodi. Ympäristö alkaa komennolla `\begin{_environment-name_}` ja päättyy komentoon `\end{_environment-name_}`, missä `_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ä. Jokaista luettelon kohtaa on edellettävä `\item`-komento, kuten alla näytetään:

```latex theme={null}
\documentclass{article}
\begin{document}
\begin{itemize}
  \item The individual entries are indicated with a black dot, a so-called bullet.
  \item The text in the entries may be of any length.
\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 tulosteen:

![Esimerkki luettelomerkein merkitystä luettelosta 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 esittelee LaTeXin erityyppisiä luetteloita.

### Järjestetyt luettelot

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

```latex theme={null}
\documentclass{article}
\begin{document}
\begin{enumerate}
  \item This is the first entry in our list.
  \item The list numbers increase with each entry we add.
\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 tulosteen:

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

Kuten `unordered`-luetteloissa, jokaista kohtaa on edellettävä `\item`-komento, joka tässä tapauksessa luo automaattisesti järjestetyn luettelon numeerisen tunnisteen alkaen numerosta 1.

Lisätietoja saat avaamalla 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 LaTeXin erityyppisiä luetteloita, tai tutustumalla LaTeX-luetteloita käsittelevään ohjeartikkeliimme, jossa on paljon lisää esimerkkejä ja näytetään, miten mukautettuja luetteloita luodaan.

## Matematiikan lisääminen LaTeXiin

Yksi LaTeXin tärkeimmistä eduista on matemaattisten lausekkeiden kirjoittamisen helppous. LaTeX tarjoaa kaksi kirjoitustilaa matematiikan latomiseen:

* *tekstinsisäinen* (inline) matematiikkatila, jota käytetään kappaleeseen kuuluvien kaavojen kirjoittamiseen
* *erillinen* (display) matematiikkatila, jota käytetään lausekkeisiin, jotka eivät ole osa tekstiä tai kappaletta ja jotka ladotaan omille riveilleen

### Tekstinsisäinen matematiikkatila

Katsotaan esimerkki tekstinsisäisestä matematiikkatilasta:

```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\begin{document}
In physics, the mass-energy equivalence is stated 
by the equation $E=mc^2$, discovered in 1905 by Albert Einstein.
\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 tulosteen:

![Kuva tekstinsisäisessä matematiikkatilassa ladotusta matematiikasta](https://images.ctfassets.net/nrgyaltdicpt/77oK8pfew1B1VvxiBtALag/15714f2da4e469bbb8cf70a0d3733e5d/LL30Fig9-plain.svg)

Tekstinsisäisen matematiikan latomiseen voit käyttää jotakin näistä erotinpareista: `\( ... \)`, `$ ... $` tai `\begin{math} ... \end{math}`, kuten seuraavassa esimerkissä näytetään:

```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\begin{document}
\begin{math}
E=mc^2
\end{math} is typeset in a paragraph using inline math mode---as is $E=mc^2$, and so too is \(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 tulosteen:

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

### Erillinen matematiikkatila

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

```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\begin{document}
The mass-energy equivalence is described by the famous equation
\[ E=mc^2 \] discovered in 1905 by Albert Einstein. 

In natural units ($c = 1$), the formula expresses the identity
\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 tulosteen:

![Kuva erillisen tilan matematiikasta LaTeXissa](https://images.ctfassets.net/nrgyaltdicpt/6n1FPYFzmzCHPpWoEoYQZM/79b33f1096be06326bff7d2e1976c67c/LL30Fig11-plain.svg)

Erillisen tilan matematiikan latomiseen voit käyttää jotakin näistä erotinpareista: `\[ ... \]`, `\begin{displaymath} ... \end{displaymath}` tai `\begin{equation} ... \end{equation}`. Historiallisesti erillisen tilan matematiikan latominen edellytti `$$`-merkkien käyttöä erottimina, kuten `$$ _... display math here ..._$$`, mutta tätä menetelmää [ei enää suositella](https://texfaq.org/FAQ-dolldoll): käytä sen sijaan LaTeXin erottimia `\[ ... \]`.

### Kattavampia esimerkkejä

Seuraavat esimerkit esittelevät LaTeXilla ladottua monipuolista matemaattista sisältöä.

```latex theme={null}
\documentclass{article}
\begin{document}
Subscripts in math mode are written as $a_b$ and superscripts are written as $a^b$. These can be combined and nested to write expressions such as

\[ 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}) \]
 
We write integrals using $\int$ and fractions using $\frac{a}{b}$. Limits are placed on integrals using superscripts and subscripts:

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

Lower case Greek letters are written as $\omega$ $\delta$ etc. while upper case Greek letters are written as $\Omega$ $\Delta$.

Mathematical operators are prefixed with a backslash as $\sin(\beta)$, $\cos(\alpha)$, $\log(x)$ etc.
\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 tulosteen:

![Kuva LaTeXilla ladotusta monipuolisesta matematiikasta](https://images.ctfassets.net/nrgyaltdicpt/5xfm4NybWckHL5ndpdnBRq/bc0b5e27044820ea5cdd11648a68f543/LL30Fig12r-plain.svg)

Seuraava esimerkki käyttää `amsmath`-paketin tarjoamaa `equation*`-ympäristöä, joten meidän on lisättävä seuraava rivi dokumentin johdanto-osaan:

```latex theme={null}
\usepackage{amsmath}% For the equation* environment
```

Lisätietoja `amsmath`-paketin käytöstä on ohjeartikkelissamme.

```latex theme={null}
\documentclass{article}
\usepackage{amsmath}% For the equation* environment
\begin{document}
\section{First example}

The well-known Pythagorean theorem \(x^2 + y^2 = z^2\) was proved to be invalid for other exponents, meaning the next equation has no integer solutions for \(n>2\):

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

\section{Second example}

This is a simple math expression \(\sqrt{x^2+1}\) inside text. 
And this is also the same: 
\begin{math}
\sqrt{x^2+1}
\end{math}
but by using another command.

This is a simple math expression without numbering
\[\sqrt{x^2+1}\] 
separated from text.

This is also the same:
\begin{displaymath}
\sqrt{x^2+1}
\end{displaymath}

\ldots and this:
\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 tulosteen:

![Kuva LaTeXilla ladotusta monipuolisesta matematiikasta](https://images.ctfassets.net/nrgyaltdicpt/hT85gkewCDlxCHeNU5slE/9256c129b25bec7a93dcfe9e44b0654a/LL30Fig13r-plain.svg)

Matematiikan mahdollisuudet LaTeXissa ovat rajattomat, joten tutustu ohjesivuihimme, joista löydät neuvoja ja esimerkkejä tietyistä aiheista:

* Matemaattiset lausekkeet
* Ala- ja yläindeksit
* Hakasulkeet ja kaarisulkeet
* Murtoluvut ja binomikertoimet
* Yhtälöiden tasaus
* Operaattorit
* Välistys matematiikkatilassa
* Integraalit, summat ja raja-arvot
* Erillinen tyyli matematiikkatilassa
* Luettelo kreikkalaisista kirjaimista ja matemaattisista symboleista
* Matemaattiset fontit

## Dokumentin perusrakenne

Seuraavaksi tutustumme tiivistelmiin ja siihen, miten LaTeX-dokumentti jaetaan lukuihin, osioihin ja kappaleisiin.

### Tiivistelmät

Tieteellisissä artikkeleissa on yleensä *tiivistelmä* (abstract), joka on lyhyt yleiskatsaus/yhteenveto niiden keskeisistä aiheista tai argumenteista. Seuraava esimerkki näyttää, miten tiivistelmä ladotaan LaTeXin `abstract`-ympäristöllä:

```latex theme={null}
\documentclass{article}
\begin{document}
\begin{abstract}
This is a simple paragraph at the beginning of the 
document. A brief introduction about the main subject.
\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 tulosteen:

![Kuva LaTeXilla ladotusta tiivistelmästä](https://images.ctfassets.net/nrgyaltdicpt/4cPu8x8ZxuDVF6efcZ03yi/91aa6aa84719613b0e25c725b70aa0b8/LL30Fig14-plain.svg)

### Kappaleet ja uudet rivit

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

* miten uusi kappale luodaan painamalla "enter"-näppäintä kahdesti, jolloin nykyinen rivi päättyy ja sen perään lisätään tyhjä rivi;
* miten uusi rivi aloitetaan aloittamatta uutta kappaletta lisäämällä manuaalinen rivinvaihto komennolla `\\` eli kaksoiskenoviivalla; vaihtoehtoisesti voit käyttää komentoa `\newline`.

Esimerkin kolmas kappale havainnollistaa komentojen `\\` ja `\newline` käyttöä:

```latex theme={null}
\documentclass{article}
\begin{document}

\begin{abstract}
This is a simple paragraph at the beginning of the 
document. A brief introduction about the main subject.
\end{abstract}

After our abstract we can begin the first paragraph, then press ``enter'' twice to start the second one.

This line will start a second paragraph.

I will start the third paragraph and then add \\ a manual line break which causes this text to start on a new line but remains part of the same paragraph. Alternatively, I can use the \verb|\newline|\newline command to start a new line, which is also part of the same paragraph.
\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 tulosteen:

![Kuva kappaleiden luomisesta LaTeXissa](https://images.ctfassets.net/nrgyaltdicpt/5DdSH06hFli8k4lR0dxw4m/a55cddf9aa10b64302ae7b72ba0c6447/LL30Fig15r-plain.svg)

Huomaa, kuinka LaTeX sisentää kappaleet automaattisesti — paitsi välittömästi dokumentin otsikoiden, kuten osion ja alaosion, jälkeen — [kuten tulemme näkemään](/fi/texlive/latex-basics/learn-latex-in-30-minutes#Chapters%5Fand%5Fsections).

Uusille käyttäjille suositellaan, ettei useita `\\`- tai `\newline`-komentoja käytetä ”simuloimaan” kappaleita, joiden välissä on suurempi väli, koska tämä voi häiritä LaTeXin latomisalgoritmeja. Suositeltu tapa on jatkaa tyhjien rivien käyttämistä uusien kappaleiden luomiseen ilman `\\`-komentoja ja ladata [parskip-paketti](https://ctan.org/pkg/parskip?lang=en) lisäämällä `\usepackage{parskip}` johdanto-osaan.

Lisätietoja kappaleista löytyy seuraavista artikkeleista:

* Kappaleet ja uudet rivit
* Kappaleiden välistyksen muuttaminen LaTeXissa
* LaTeX Error: There's no line here to end tarjoaa lisäneuvoja ja -ohjeita `\\`-komennon käyttöön.

### Luvut ja osiot

Pidemmät dokumentit jaetaan yleensä kirjoitusohjelmasta riippumatta osiin, lukuihin, osioihin, alaosioihin ja niin edelleen. LaTeX tarjoaa myös dokumentin jäsentelykomentoja, mutta käytettävissä olevat komennot ja niiden toteutukset (mitä ne tekevät) voivat riippua käytettävästä dokumenttiluokasta. Esimerkiksi `book`-luokalla luodut dokumentit voidaan jakaa osiin, lukuihin, osioihin, alaosioihin ja niin edelleen, mutta `letter`-luokka ei tarjoa (tue) mitään komentoja tähän.

Seuraava esimerkki esittelee komentoja, joilla jäsennetään `book`-luokkaan perustuva dokumentti:

```latex theme={null}
\documentclass{book}
\begin{document}

\chapter{First Chapter}

\section{Introduction}

This is the first section.

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{Second Section}

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

\subsection{First Subsection}
Praesent imperdietmi nec ante. Donec ullamcorper, felis non sodales...

\section*{Unnumbered Section}
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 tulosteen:

![Kuva osioista LaTeXin book-dokumentissa](https://images.ctfassets.net/nrgyaltdicpt/1A1T7YsurQdM058OwmLqd8/7f6e962c31356bafa702bab9062f6061/LL30Fig16-plain.svg)

Jäsentelykomentojen nimet ovat enimmäkseen itsestään selviä; esimerkiksi `\chapter{First Chapter}` luo uuden luvun otsikolla `First Chapter`, `\section{Introduction}` tuottaa osion otsikolla `Introduction` ja niin edelleen. Osiot voidaan jakaa edelleen alaosioihin `\subsection{...}` ja jopa `\subsubsection{...}`. Osioiden, alaosioiden jne. numerointi on automaattista, mutta sen voi poistaa käytöstä käyttämällä vastaavan komennon niin sanottua *tähtiversiota*, jonka lopussa on tähti (\*), kuten `\section*{...}` ja `\subsection*{...}`.

*Yhteensä* LaTeXin dokumenttiluokat tarjoavat seuraavat jäsentelykomennot, ja kukin luokka tukee niistä tarkoituksenmukaista osajoukkoa:

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

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

Lisätietoja dokumentin jäsentelykomennoista löydät Overleafin osioita ja lukuja käsittelevästä artikkelista.

## Taulukoiden luominen

Overleaf tarjoaa kolme vaihtoehtoa taulukoiden luomiseen:

1. **Visual Editorin** (tai **Code Editorin**) työkalupalkin [**Insert Table** -painikkeen](https://www.overleaf.com/learn/how-to/How_to_insert_tables_in_Overleaf%23inserttable#Using%5FInsert%5FTable%5Fto%5Fcreate%5Fa%5Ftable%5Fin%5Fyour%5Fproject) käyttäminen.
2. [Taulukon kopioiminen ja liittäminen](https://www.overleaf.com/learn/how-to/How_to_paste_formatted_content_into_Overleaf%23pastingtables) toisesta dokumentista **Visual Editoria** käytettäessä.
3. Taulukon LaTeX-koodin kirjoittaminen Code Editorissa.

Jos LaTeX on sinulle uusi, **Visual Editorin** työkalupalkin käyttäminen (vaihtoehto 1) on erinomainen tapa aloittaa — voit vaihtaa **Visual Editorin** ja **Code Editorin** välillä nähdäksesi taulukon taustalla olevan koodin.

Tässä keskitymme vaihtoehtoon 3 — joustavimpaan tapaan luoda taulukoita — ja annamme esimerkkejä taulukoiden luomisesta LaTeXissa, mukaan lukien viivojen (rules) ja otsikoiden lisääminen. Kun kokemusta kertyy, tutustu yksityiskohtaisiin ohjeisiimme [taulukoiden luomisesta LaTeXilla](https://www.overleaf.com/learn/latex/Tables).

### Perustaulukon luominen LaTeXissa

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

```latex theme={null}
\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 tulosteen:

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

`tabular`-ympäristö on LaTeXin oletustapa luoda taulukoita. Ympäristölle on annettava parametri, tässä tapauksessa `{c c c}`, joka kertoo LaTeXille, että sarakkeita on kolme ja jokaisen sarakkeen teksti keskitetään. Voit myös käyttää `r`:ää tekstin tasaamiseen oikealle ja `l`:ää vasemmalle. Tasausmerkkiä `&` käytetään taulukon rivin yksittäisten solujen erottamiseen. Taulukon rivi päätetään *uuden rivin* komennolla `\\`. Taulukkomme on `center`-ympäristön sisällä, jotta se keskitetään sivun tekstileveyden sisällä.

### Reunaviivojen lisääminen

`tabular`-ympäristö tukee vaaka- ja pystyviivoja (rules) osana taulukkoa:

* lisää vaakaviivoja rivien ylä- ja alapuolelle komennolla `\hline`
* lisää pystyviivoja sarakkeiden väliin pystyviivaparametrilla `|`

Tässä esimerkissä argumentti on `{|c|c|c|}`, joka määrittää kolme (keskitettyä) saraketta, joiden välissä on pystyviiva; lisäksi käytämme `\hline`-komentoa vaakaviivan sijoittamiseen ensimmäisen rivin yläpuolelle ja viimeisen rivin alapuolelle:

```latex theme={null}
\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 tulosteen:

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

Tässä on vielä yksi esimerkki:

```latex theme={null}
\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%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 tulosteen:

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

### Otsikot, nimiöt ja viittaukset

Taulukoihin voi lisätä otsikoita ja viittauksia pitkälti samalla tavalla kuin kuviin. Ainoa ero on, että **`figure`**-ympäristön sijaan käytetään **`table`**-ympäristöä.

Taulukko \ref\{table:data} näyttää, miten taulukolle lisätään otsikko ja miten siihen viitataan.

```latex theme={null}
\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{Table to test captions and labels.}
\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 tulosteen:

![LaTeX-taulukko otsikkoineen](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 theme={null}
\documentclass{article}
\title{Sections and Chapters}
\author{Gubert Farnsworth}
\date{August 2022}
\begin{document}
  
\maketitle
  
\tableofcontents

\section{Introduction}
   
This is the first section.
      
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*{Unnumbered Section}
\addcontentsline{toc}{section}{Unnumbered Section}

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

\section{Second Section}
       
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 tulosteen:

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

Osiot, alaosiot ja luvut sisällytetään sisällysluetteloon automaattisesti. Lisätäksesi merkintöjä käsin, esimerkiksi numeroimattoman osion, käytä komentoa `\addcontentsline` esimerkin mukaisesti.

## Valmiin dokumentin lataaminen

Seuraava lyhyt videoleike näyttää, miten projektisi lähdekoodi tai ladottu PDF-tiedosto ladataan:

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ä latomisominaisuuksia, vaan myös *laajennettavuuskehyksen* lisä\_pakettien\_ avulla. Sen sijaan, että LaTeX yrittäisi tarjota komentoja ja ominaisuuksia, jotka ”yrittävät tehdä kaiken”, se on suunniteltu *laajennettavaksi*: käyttäjät voivat ladata ulkoisia koodikokonaisuuksia (paketteja), jotka tarjoavat erikoistuneempia latomisominaisuuksia tai laajentavat LaTeXin sisäänrakennettuja ominaisuuksia — kuten taulukoiden latomista. Kuten osiossa [Kuvien lisääminen](/fi/texlive/latex-basics/learn-latex-in-30-minutes#Adding%5Fimages) todettiin, `graphicx`-paketti laajentaa LaTeXia tarjoamalla komentoja grafiikkatiedostojen tuomiseen, ja se ladattiin (johdanto-osassa) kirjoittamalla

```latex theme={null}
\usepackage{graphicx}
```

### Pakettien lataaminen

Kuten yllä todettiin, paketit ladataan dokumentin johdanto-osassa `\usepackage`-komennolla. Koska (monet) LaTeX-paketit tarjoavat joukon *asetuksia* (options), joilla niiden toimintaa voidaan määrittää, `\usepackage`-komento näyttää usein tältä:

```latex theme={null}
\usepackage[options]{somepackage}
```

Hakasulkeet ”`[...]`” kertovat LaTeXille, mitä asetuksia sovelletaan, kun se lataa paketin `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 asetuksia sivun asettelun määrittämiseen LaTeXissa, joten `geometry`-paketin tyypillinen käyttö voisi näyttää tältä:

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

`geometry`-paketti on yksi esimerkki paketista, jonka maailmanlaajuisen LaTeX-yhteisön jäsenet ovat kirjoittaneet ja lahjoittaneet ja joka on ilmaiseksi kaikkien sitä haluavien käytettävissä.

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

```latex theme={null}
\usepackage{somepackage}
```

Kun kirjoitat `\usepackage[...]{somepackage}`, LaTeX etsii vastaavaa tiedostoa nimeltä `_somepackage_.sty`, joka sen on ladattava ja käsiteltävä — jotta paketin komennot tulevat käyttöön ja paketin tarjoama muu koodi suoritetaan. Jos LaTeX ei löydä tiedostoa `_somepackage_.sty`, se päättyy virheeseen, kuten seuraava Overleaf-esimerkki osoittaa:

```latex theme={null}
\documentclass[12pt, letterpaper]{article}
\usepackage{somepackage}% a NON-EXISTENT package
\begin{document}
This will fail!
\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 tulosteen:

![Kuva puuttuvan paketin aiheuttamasta virheestä](https://sharelatex-wiki-cdn-671420.cdn77.org/learn-scripts/images/6/60/LL30packagefail.png)

### Tietoa paketeista: CTAN

Paketteja jaetaan [Comprehensive TeX Archive Networkin](https://www.ctan.org/) kautta, josta käytetään yleensä nimeä CTAN. Tätä kirjoitettaessa se isännöi 6287 pakettia 2881 tekijältä. CTAN [kuvailee itseään](https://www.ctan.org/ctan) seuraavasti:

> ... a set of Internet sites around the world that offer TEX-related material for download.

Voit selata CTANia hyödyllisten pakettien löytämiseksi; esimerkiksi:

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

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

### Overleafissa saatavilla olevat paketit: TeX Liven 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/), jolla voit asentaa oman (paikallisen) LaTeX-ympäristösi. Itse asiassa [myös Overleafin palvelimet käyttävät TeX Liveä](https://www.overleaf.com/learn/latex/Overleaf_and_TeX_Live), ja ne päivitetään, kun TeX Livestä julkaistaan uusi versio. Overleafin TeX Live -päivitykset eivät tapahdu välittömästi, vaan muutama kuukausi julkaisun jälkeen, mikä antaa meille aikaa testata uuden TeX Live -version yhteensopivuus [galleriamme tuhansien mallien](https://www.overleaf.com/gallery) kanssa. Tässä on esimerkiksi [TeX Live 2025 -päivitystiedotteemme](https://www.overleaf.com/blog/tex-live-2025-is-now-available).

Vaikka TeX Live sisältää (suuren) *osajoukon* CTANin paketeista, saatat löytää kiinnostavan paketin, kuten [igo Go-pelin diagrammien latomiseen](https://ctan.org/pkg/igo?lang=en), jota isännöidään CTANissa mutta joka ei sisälly TeX Liveen (eikä sitä jaeta sen kautta) ja joka ei siksi ole saatavilla Overleafissa. Jotkin CTANissa isännöidyt paketit eivät kuulu TeX Liveen monista eri syistä: paketti saattaa olla vanhentunut, siinä voi olla lisensointiongelmia, se voi olla aivan uusi (äskettäin ladattu) tai se voi olla alustariippuvainen, esimerkiksi toimia Windowsissa mutta ei Linuxissa.

Uusia paketteja ja päivityksiä olemassa oleviin ladataan CTANiin ympäri vuoden, mutta TeX Liven päivitykset jaetaan vuosittain; siksi TeX Liven nykyiseen versioon sisältyvät 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 — eivät ole CTANissa saatavilla olevia aivan uusimpia versioita, mutta yleensä tämä tuskin aiheuttaa ongelmia.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.