> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/fi/muotoilu/15-margin-notes.md).

# Marginaalimuistiinpanot

## Johdanto

Tämä artikkeli selittää, miten luodaan reunahuomautuksia, suosittu vaihtoehto alaviitteille keinona lisätä täydentävää tietoa dokumentin päätekstin tueksi. Meillä on myös [ohjesivu aiheesta `todonotes` paketti](/latex/fi/kysymykset-ja-vastaukset/04-can-i-add-inline-or-margin-comments-to-the-pdf.md) joka tarjoaa vaihtoehtoisia ratkaisuja tässä artikkelissa esitetyille.

## Komento \marginpar

Ilman lisäpakettien lataamista voit käyttää LaTeXin sisäänrakennettua `\marginpar` komentoa reunahuomautusten lisäämiseksi dokumenttiisi. Komennon yleinen muoto on `\marginpar` on

`\marginpar[*left text*]{*right text*}`

jossa `*vasen teksti*` käytetään, jos reunahuomautus ilmestyy dokumentin sivun vasemmalle puolelle, ja `*oikea teksti*` jos se ilmestyy oikealle. Tarkemmin sanottuna reunahuomautukset sijoitetaan tavallisesti sivun “ulkolaitaan” — vaikka “ulkolaidan” merkitys riippuu käyttämästäsi dokumenttiluokasta ja siitä, oletko määrittänyt `twoside` pakettivalinnan:

* `book` luokka (`\documentclass{book})` asiakirjat ovat oletusarvoisesti kaksipuolisia (asettelun vuoksi)
* `raportti` luokka (`\documentclass{report}`) ja `article` luokka (`\documentclass{article}`) asiakirjat ovat oletusarvoisesti yksipuolisia. Tehdäksesi niistä kaksipuolisia sinun on määritettävä `twoside` asetus:
  * `\documentclass[twoside]{report}`, tai
  * `\documentclass[twoside]{article}`

Yksipuolisissa asiakirjoissa, lukuun ottamatta oikealta vasemmalle kirjoitettavia kieliä, kuten arabiaa, “ulkopuoli” on aina tekstin oikea reuna, ja kaksipuolisissa asiakirjoissa se on tekstin vasen reuna vasemmilla sivuilla ja tekstin oikea reuna oikeilla sivuilla.

### Reunahuomautusten sijoittelun kääntäminen

Komento `\reversemarginpar` kääntää sen puolen, jolle reunahuomautukset ladotaan; sen vaikutus voidaan kumota komennolla `\normalmarginpar`. Kuten LaTeX-lähdekoodin dokumentaatiossa todetaan: “Näillä komennoilla ei ole vaikutusta kaksipalstaiseen tulostukseen.”

### Komennot, jotka vaikuttavat reunahuomautusten ladontaan

Ladonta `\marginpar` huomautuksissa käytetään useita mittakäskyjä, jotka tallentavat arvoja, joita voidaan tarvittaessa muuttaa:

* `\marginparwidth`: määrittää reunahuomautusten leveyden ja siten reunahuomautukseen ladottujen rivien pituuden.
* `\marginparsep`: asettaa välin (etäisyyden) reunahuomautusten ja dokumenttisi tekstin välille.
* `\marginparpush`: määrittää vähimmäiserotusvälin (pystysuuntainen) välillä `\marginpar` huomautusten.

### Reunahuomautusten ladonnan muuttaminen: liehuva oikea ja liehuva vasen

Oletusarvoisesti reunahuomautuksen teksti ladotaan laatikkoon, joka tuottaa ladottuja rivejä, joiden leveys on `\marginparwidth`. Tämä voi johtaa epäsiisteihin väleihin ladottujen sanojen välissä, kun TeX-moottori yrittää löytää “parhaat” rivinvaihdot. Voit käyttää komentoja `\raggedright` ja `\raggedleft` muuttaaksesi tekstin ladontatyyliä.

### Esimerkki

Tässä on esimerkki, joka käyttää useita `\marginpar` komentoja yllä lueteltujen ominaisuuksien havainnollistamiseksi. Esimerkki lataa myös [`geometry`](https://ctan.org/pkg/geometry) paketin pienen sivukoon luomiseksi sekä [`hyperref`](https://ctan.org/pkg/hyperref) paketin, joka tarjoaa `\url` komennon, jota käytetään tekstin lähteen mainitsemiseen (alaviitteessä).

```latex
\documentclass[twoside]{article} % Huom: käyttää twoside-valintaa
\usepackage[a4paper, marginparwidth=75pt, total={10cm, 10cm}]{geometry} % Pienen sivun luomiseksi
\usepackage{hyperref} % \url-komennon käyttämiseksi (alaviitteessä)
\usepackage{marginnote}
\begin{document}
\section{Lorem Ipsum}
\footnote{Lähdeteksti: Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}Mutta minun täytyy selittää teille, miten tämä kaiken nautinnon tuomitsemista ja kivun ylistämistä koskeva harhaluulo sai alkunsa. Tehdäkseni niin annan teille täydellisen selostuksen järjestelmästä ja esitän totuuden suuren etsijän, ihmisen onnellisuuden mestarirakentajan, todelliset opetukset. \marginpar[Huomautus 1: teksti vasemmalle puolelle]{Huomautus 1: teksti sivujen oikeaa puolta varten, se on tasattu.} Kukaan ei hylkää, inhoa tai vältä nautintoa sinänsä, koska se on nautintoa, vaan siksi, että ne, jotka eivät tiedä, miten nautintoa tulee järkevästi tavoitella, kohtaavat seurauksia, jotka ovat äärimmäisen kivuliaita. Eikä myöskään ole ketään, joka rakastaisi tai tavoittelisi tai haluaisi hankkia kipua itsensä vuoksi, koska se on kipua, mutta joskus sattuu olosuhteita, joissa työ ja kipu voivat tuottaa hänelle suurta nautintoa.  \marginpar[Huomautus 2: teksti vasemmalle puolelle]{\raggedright Huomautus 2: teksti sivujen oikeaa puolta varten, sitä ei tasata, vaan käytetään \texttt{\string\raggedright}.} Otetaanpa triviaalinen esimerkki: kuka meistä koskaan ryhtyy uuvuttavaan fyysiseen harjoitteluun, ellei saadakseen siitä jotakin etua? Mutta kuka on oikeutettu moittimaan miestä, joka päättää nauttia mielihyvästä, jolla ei ole ikäviä seurauksia, tai sellaista, joka välttää kipua, josta ei seuraa mielihyvää? [33] Toisaalta tuomitsemme oikeutetulla suuttumuksella ja inhoa tuntevin miehiä, jotka tämän hetken nautintojen viehätys on niin pettänyt ja turmellut, ja halu niin sokaissut, etteivät he voi nähdä edessä olevaa kipua ja vaivaa; ja yhtä suuri moite kuuluu niille, jotka epäonnistuvat velvollisuudessaan tahdon heikkouden vuoksi, mikä on sama kuin sanoa, että he perääntyvät työstä ja kivusta. Nämä tapaukset ovat täysin yksinkertaisia ja helppoja erottaa toisistaan. Vapaana hetkenä, kun valinnanvapautemme on esteetön ja mikään ei estä meitä tekemästä sitä, mistä pidämme eniten, jokainen mielihyvä on tervetullut ja jokainen kipu vältettävä. \marginpar[\raggedleft Huomautus 3: teksti vasemmalle puolelle, sitä ei tasata, vaan käytetään \texttt{\string\raggedleft}]{Huomautus 3: teksti vasemmalle puolelle}Mutta tietyissä olosuhteissa ja velvollisuuden vaatimusten tai liiketoiminnan velvoitteiden vuoksi käy usein niin, että mielihyvistä on luovuttava ja harmit hyväksyttävä. Viisas mies pitäytyy siis näissä asioissa aina tässä valintaperiaatteessa: hän hylkää mielihyviä saadakseen muita suurempia mielihyviä, tai hän kestää kipuja välttääkseen pahempia kipuja.
\end{document}
```

Avaa tämä `\marginpar` esimerkki Overleafissa

Tämä esimerkki tuottaa seuraavan (kaksi sivua) tulosteen:

Sivu 1:

![\marginpar-komennon esimerkki](/files/746b52e9af3a3f6f4b0636e556e933d7bb0d2e58)

Sivu 2:

![\marginpar-komennon esimerkki](/files/e51a7253da2176075e45e7d54416bb9cfcf383f7)

### mparhack-paketti: väärän marginaalin korjaaminen

Sisäisesti LaTeX käsittelee reunahuomautuksia eräänlaisena dokumenttisi “kelluvana” osana — samoin kuin LaTeX käsittelee kelluvia kuvia ja taulukoita. Koska ne ovat "kelluvia", reunahuomautukset, jotka on tuotettu `\marginpar` voivat toisinaan ilmestyä väärään marginaaliin.  [`mparhack` paketti](https://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/mparhack/mparhack.pdf) kirjoitettiin korjaamaan tämä ongelma, joten sitä voi olla syytä käyttää, jos kohtaat tämän.

## Vaihtoehto komennolle \marginpar: marginnote-paketti

Se [`marginnote` paketti](https://www.ctan.org/pkg/marginnote) tarjoaa monipuolisen vaihtoehdon `\marginpar` komento. `marginnote` toteuttaa reunahuomautukset käyttämällä ei-kelluvaa mekanismia, mikä eroaa tavasta, jolla `\marginpar` toimii: `marginnote` ratkaisee joitakin ongelmia, mutta kuten sen dokumentaatiossa todetaan, se voi tuoda mukanaan toisia.

### Esimerkki

Seuraava esimerkki havainnollistaa `\marginnote` komentoa, jonka tarjoaa `marginnote` pakettia:

```latex
\documentclass{article}
\usepackage[a5paper, total={3in, 6in}]{geometry} % pienen sivun luomiseksi
\usepackage{hyperref} % \url-komennon käyttämiseksi (alaviitteessä)
\usepackage{marginnote}
\begin{document}
\section{Lorem Ipsum}
\footnote{Lähdeteksti: Wikipedia (\url{https://en.wikipedia.org/wiki/Lorem_ipsum})}Mutta minun täytyy selittää teille, miten tämä kaiken nautinnon tuomitsemista ja kivun ylistämistä koskeva harhaluulo sai alkunsa. Tehdäkseni niin annan teille täydellisen selostuksen järjestelmästä ja esitän totuuden suuren etsijän, ihmisen onnellisuuden mestarirakentajan, todelliset opetukset. \marginnote{Tämä on reunahuomautus, joka on siirretty 2 cm \textit{alas} sivulla suhteessa riviin, jolla se ladotaan.}[2cm] Kukaan ei hylkää, inhoa tai vältä nautintoa sinänsä, koska se on nautintoa, vaan siksi, että ne, jotka eivät tiedä, miten nautintoa tulee järkevästi tavoitella, kohtaavat seurauksia, jotka ovat äärimmäisen kivuliaita. Eikä myöskään ole ketään, joka rakastaisi tai tavoittelisi tai haluaisi hankkia kipua itsensä vuoksi, koska se on kipua, mutta joskus sattuu olosuhteita, joissa työ ja kipu voivat tuottaa hänelle suurta nautintoa. \reversemarginpar\marginnote{Tämä on toinen reunahuomautus, mutta se on siirretty 2 cm \textit{ylös} sivulla suhteessa riviin, jolla se ladotaan. Se on myös vasemmassa marginaalissa.}[-2cm] Otetaanpa triviaalinen esimerkki: kuka meistä koskaan ryhtyy uuvuttavaan fyysiseen harjoitteluun, ellei saadakseen siitä jotakin etua? Mutta kuka on oikeutettu moittimaan miestä, joka päättää nauttia mielihyvästä, jolla ei ole ikäviä seurauksia, tai sellaista, joka välttää kipua, josta ei seuraa mielihyvää? [33] Toisaalta tuomitsemme oikeutetulla suuttumuksella ja inhoa tuntevin miehiä, jotka tämän hetken nautintojen viehätys on niin pettänyt ja turmellut, ja halu niin sokaissut, etteivät he voi nähdä edessä olevaa kipua ja vaivaa; ja yhtä suuri moite kuuluu niille, jotka epäonnistuvat velvollisuudessaan tahdon heikkouden vuoksi, mikä on sama kuin sanoa, että he perääntyvät työstä ja kivusta. Nämä tapaukset ovat täysin yksinkertaisia ja helppoja erottaa toisistaan. Vapaana hetkenä, kun valinnanvapautemme on esteetön ja mikään ei estä meitä tekemästä sitä, mistä pidämme eniten, jokainen mielihyvä on tervetullut ja jokainen kipu vältettävä. Mutta tietyissä olosuhteissa ja velvollisuuden vaatimusten tai liiketoiminnan velvoitteiden vuoksi käy usein niin, että mielihyvistä on luovuttava ja harmit hyväksyttävä. Viisas mies pitäytyy siis näissä asioissa aina tässä valintaperiaatteessa: hän hylkää mielihyviä saadakseen muita suurempia mielihyviä, tai hän kestää kipuja välttääkseen pahempia kipuja.
\end{document}
```

Avaa tämä esimerkki Overleafissa

Tämä esimerkki tuottaa seuraavan tulosteen:

![marginnote-paketin käyttäminen](/files/c644d41443d005b4b5f61c3301ed73dd0b6652e7)

Yllä oleva esimerkki lataa myös `geometry` paketin pienen sivukoon luomiseksi sekä `hyperref` paketin, joka tarjoaa `\url` komennon, jota käytetään tekstin lähteen mainitsemiseen (alaviitteessä). Kun olet tuonut `marginnote` paketin kirjoittamalla `\usepackage{marginnote}` voit käyttää `\marginnote` komentoa, kuten esimerkkitekstin kaksi esiintymää osoittavat:

* `\marginnote{Tämä on reunahuomautus, joka on siirretty 2 cm \textit{alas} sivulla suhteessa riviin, jolla se ladotaan.}[2cm]`
* `\marginnote{Tämä on toinen reunahuomautus, mutta se on siirretty 2 cm \textit{ylös} sivulla suhteessa riviin, jolla se ladotaan. Se on myös vasemmassa marginaalissa.}[-2cm]`

Näissä esimerkeissä käytämme toista parametria hakasulkeissa `[ ]` joka määrittää pystysuuntaisen kohdistuksen suhteessa riviin, jossa komentoa käytetään. Ensimmäinen `\margingnote` komento käyttää `[2cm]` siirtää reunahuomautusta 2 cm *alas sivulla*, toinen käyttää `[-2cm]` siirtää reunahuomautusta 2 cm *ylös sivulla*.

Toinen `\marginnote` komento toimii sen jälkeen, kun `\reversemarginpar` on käytetty, jolloin se sijoitetaan tämän yksipuolisen dokumentin vasempaan marginaaliin:

```latex
\reversemarginpar\marginnote{Tämä on toinen reunahuomautus, mutta se on siirretty 2 cm \textit{ylös} sivulla suhteessa riviin, jolla se ladotaan. Se on myös vasemmassa marginaalissa.}[-2cm]
```

## Lisälukemista

Lisätietoja on kohdassa

* [Se `marginnote` pakettidokumentaatio](http://www.ctan.org/pkg/marginnote)
* [Se `mparhack` pakettidokumentaatio](http://www.ctan.org/pkg/mparhack)
* [Sivukoko ja marginaalit](/latex/fi/muotoilu/07-page-size-and-margins.md)
* [Alaviitteet](/latex/fi/muotoilu/14-footnotes.md)
* [Pituudet LaTeXissa](/latex/fi/muotoilu/01-lengths-in-latex.md)
* [Yksipuoliset ja kaksipuoliset asiakirjat](/latex/fi/muotoilu/08-single-sided-and-double-sided-documents.md)
* [Useita palstoja](/latex/fi/muotoilu/09-multiple-columns.md)
* [Ylätunnisteet ja alatunnisteet](/latex/fi/muotoilu/02-headers-and-footers.md)
* [Kappalemuotoilu](/latex/fi/muotoilu/04-articles-how-to-change-paragraph-spacing-in-latex.md)
* [Lihavointi, kursivointi ja alleviivaus](/latex/fi/latexin-perusteet/03-bold-italics-and-underlining.md)
* [Kirjasinkoot, -perheet ja -tyylit](/latex/fi/fontit/01-font-sizes-families-and-styles.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/fi/muotoilu/15-margin-notes.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.