> 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/asiakirjan-rakenne/01-sections-and-chapters.md). # Hyperlinkit ## Johdanto Asiakirjoilla on yleensä jokin ”looginen rakenne”: jakautuminen lukuihin, osioihin, alaosioihin jne. sisällön järjestämiseksi. LaTeX tukee asiakirjarakenteen luomista ja mahdollistaa myös osioinnin ja numeroinnin mukauttamisen. Asiakirjan järjestämiseen käytettävät komennot riippuvat käytössä olevasta dokumenttiluokasta, vaikka yksinkertaisin järjestämisen muoto, jäsentely, on saatavilla kaikissa dokumenttimuodoissa. ## Perusesimerkki Aloitetaan perusesimerkillä havainnollistamaan `\section{*section title*}` komentoa, joka merkitsee uuden osion alkamisen, nimeltään `*section title*`. Osioiden numerointi on automaattista ja sitä voidaan mukauttaa tai poistaa käytöstä. ```latex \documentclass{article} \usepackage{blindtext} \title{Sections and Chapters} \author{Overleaf} \date{\today} \begin{document} \maketitle \section{Introduction} Tämä on ensimmäinen osio. \blindtext \section{Second Section} Tämä on toinen osio \blindtext \end{document} ``` [Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Basic+document+structure+example\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bblindtext%7D%0A%0A%5Ctitle%7BSections+and+Chapters%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A%5Csection%7BIntroduction%7D%0A%0AThis+is+the+first+section.%0A%0A%5Cblindtext%0A%0A%5Csection%7BSecond+Section%7D%0AThis+is+the+second+section%0A%0A%5Cblindtext%0A%5Cend%7Bdocument%7D) Tämä esimerkki tuottaa seuraavan tulosteen: ![Osioiden ja lukujen esimerkki](/files/4bd06f6afc102fe97d5b186fe78f6303600f3f9a) ## Asiakirjan osiointi LaTeX voi organisoida, numeroida ja indeksoida asiakirjan lukuja ja osioita. Osioiden määrittelyyn on jopa 7 tasoa dokumenttiluokasta riippuen: | | | | -- | ------------------------------- | | -1 | `\part{part}` | | 0 | `\chapter{chapter}` | | 1 | `\section{section}` | | 2 | `\subsection{subsection}` | | 3 | `\subsubsection{subsubsection}` | | 4 | `\paragraph{paragraph}` | | 5 | `\subparagraph{subparagraph}` | Yleensä, `\section` on useimmissa asiakirjoissa ylimmän tason asiakirjakomento. Kuitenkin raporteissa tai kirjoissa ja vastaavissa pitkissä asiakirjoissa tämä olisi `\chapter` tai `\part`. ## Numeroidut ja numeroimattomat osiot Saadaksesi numeroimattoman luvun, osion, alaosion jne. lisää tähti (`*`) komennon loppuun, ennen avautuvaa aaltosulkua. Näitä ei lisätä sisällysluetteloon. Tässä on ensimmäinen esimerkkimme (yllä), mutta tällä kertaa käyttäen `\section*` sijasta `\section`: ```latex \documentclass{article} \usepackage{blindtext} \title{Sections and Chapters} \author{Overleaf} \date{\today} \begin{document} \maketitle \section*{Introduction} Tämä on ensimmäinen osio. \blindtext \section*{Second Section} Tämä on toinen osio \blindtext \end{document} ``` [Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+with+unnumbered+sections\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bblindtext%7D%0A%0A%5Ctitle%7BSections+and+Chapters%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A%5Csection%2A%7BIntroduction%7D%0A%0AThis+is+the+first+section.%0A%0A%5Cblindtext%0A%0A%5Csection%2A%7BSecond+Section%7D%0AThis+is+the+second+section%0A%0A%5Cblindtext%0A%5Cend%7Bdocument%7D) Tämä esimerkki tuottaa seuraavan tulosteen: ![Esimerkki numeroimattomista osioista](/files/2ee4a59884141547d8ffc107910af5dc8077b918) ### Numeroimattomat osiot sisällysluettelossa Lisätäksesi numeroimattoman osion sisällysluetteloon, käytä `\addcontentsline` komentoa näin: ```latex \addcontentsline{toc}{section}{Title of the section} ``` Tässä on esimerkki, jossa käytetään `\addcontentsline` mutta katso artikkelia [Sisällysluettelo](/latex/fi/asiakirjan-rakenne/02-table-of-contents.md) lisätietoja ja esimerkkejä varten. ```latex \documentclass{article} \title{Sections and Chapters} \author{Overleaf} \date{\today} \begin{document} \maketitle \tableofcontents \newcommand\shortlorem{Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.} \section{Introduction} Tämä on ensimmäinen osio (numeroitu). \shortlorem \addcontentsline{toc}{section}{Unnumbered Section} \section*{Unnumbered Section} Numeroimaton osio \shortlorem \section{Second section} Toinen numeroitu osio. \shortlorem \end{document} ``` [Avaa tämä esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Example+of+unnumbered+sections+in+the+TOC\&snip=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BSections+and+Chapters%7D%0A%5Cauthor%7BOverleaf%7D%0A%5Cdate%7B%5Ctoday%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cmaketitle%0A%5Ctableofcontents%0A%0A%5Cnewcommand%5Cshortlorem%7BLorem+ipsum+dolor+sit+amet%2C+consectetur+adipiscing+elit%2C+sed+do+eiusmod+tempor+incididunt+ut+labore+et+dolore+magna+aliqua.+Ut+enim+ad+minim+veniam%2C+quis+nostrud+exercitation+ullamco+laboris+nisi+ut+aliquip+ex+ea+commodo+consequat.%7D%0A%0A%5Csection%7BIntroduction%7D%0AThis+is+the+first+section+%28numbered%29.%0A%0A%5Cshortlorem%0A%5Caddcontentsline%7Btoc%7D%7Bsection%7D%7BUnnumbered+Section%7D%0A%5Csection%2A%7BUnnumbered+Section%7D%0AAn+unnumbered+section%0A%0A%5Cshortlorem%0A%0A%5Csection%7BSecond+section%7D%0AThe+second+numbered+section.%0A%0A%5Cshortlorem%0A%5Cend%7Bdocument%7D) Tämä esimerkki tuottaa seuraavan tulosteen: ![Numeroimattomat osiot TOC:ssa](/files/a59e9d0a280ee01288c53a5d2199201adaa26880) ## Luvut ja osiot kirjassa/raportissa Kuten aiemmin mainittiin, `\chapter` voidaan käyttää kirjoissa ja raporteissa. ### Raporttiluokka Alla näet esimerkin `raportista` jossa käytetään tekstiä, joka on otettu Overleafin artikkelista [Johdanto LuaTeXiin (Osa 1): Mikä se on — ja mikä tekee siitä niin erilaisen?](/latex/fi/syvalliset-artikkelit/07-an-introduction-to-luatex-part-1-what-is-it-and-what-makes-it-so-different.md) ```latex \documentclass{report} \title{Sections and Chapters} \author{Overleaf} \date{\today} \begin{document} \maketitle \tableofcontents \chapter{An Introduction to Lua\TeX} \section{What is it—and what makes it so different?} Lua\TeX{} on \textit{työkalupakki}—se sisältää kehittyneitä ohjelmistotyökaluja ja komponentteja, joiden avulla voit rakentaa (latoa) monenlaisia asiakirjoja. Tämän artikkelin alaotsikko esittää myös kaksi kysymystä Lua\TeX{}:stä: Mikä se on — ja mikä tekee siitä niin erilaisen? Vastaus kysymykseen “Mikä se on?” saattaa vaikuttaa ilmeiseltä: “Se on \TeX{}-ladontamoottori!” Niin se onkin, mutta laajempi näkemys, jota tämän kirjoittaja kannattaa, on että Lua\TeX{} on erittäin monipuolinen \TeX{}-pohjainen asiakirjojen rakentamis- ja suunnittelujärjestelmä. \subsection{Explaining Lua\TeX: Where to start?} Tämän ensimmäisen Lua\TeX{}-artikkelin tavoitteena on tarjota konteksti sille, mitä tämä TeX-moottori tarjoaa ja miksi/miten sen suunnittelu antaa käyttäjille mahdollisuuden rakentaa, suunnitella ja luoda monenlaisia ratkaisuja monimutkaisiin ladonta- ja suunnitteluongelmiin — ehkä myös tarjoten jonkin verran ”tulevaisuudenkestävyyttä” \chapter{Lua\TeX: Background and history} \section{Introduction} Lua\TeX{} on \TeX{}-termein “uusi tulokas”, vaikka sitä on kehitetty aktiivisesti yli 10 vuoden ajan. \subsection{Lua\TeX: Opening up \TeX’s “black box”} Knuthin alkuperäinen \TeX{}-ohjelma on kaikkien nykyisin käytössä olevien modernien \TeX{}-moottoreiden yhteinen kantaisä, ja Lua\TeX{} on käytännössä uusin kehitysvaihe: se pohjautuu pdf\TeX{}-ohjelmaan, mutta siihen on lisätty joitakin tehokkaita ohjelmistokomponentteja, jotka tuovat paljon lisätoiminnallisuutta. \end{document} ``` [Avaa tämä esimerkki Overleafissa (käyttäen `lualatex`)]() Tämä esimerkki tuottaa seuraavan tulosteen—tässä näytämme sivut 2–4, joissa sivukuvat on asetettu päällekkäin esityksen helpottamiseksi: ![Tyypillinen LaTeX-raportti](/files/ab81fc34bbe8a73bab4ded8fa7735c18748e33cb) ### Kirjaluokka Seuraava esimerkki toistaa tekstiä `raportista` esimerkistä, mutta käyttäen `\documentclass{book}`, joka sisältää osia, lukuja, osioita, alaosioita ja ala-alaosioita. Jos avaat esimerkin Overleafissa, sinun pitäisi nähdä, että \subsubsection-komennon tuottamat ala-alaosiot ovat `\subsubsection` eivät ole *numeroituja* kirjaluokan suunnittelun mukaista. Jos haluat muuttaa tämän käytöksen, lisää seuraava komento asiakirjasi esipäähän: `kirja` luokan ```latex \setcounter{secnumdepth}{3} ``` ```latex \documentclass{book} \title{Sections and Chapters} \author{Overleaf} \date{\today} \begin{document} \maketitle \tableofcontents \part{History of Lua\TeX} \chapter{An Introduction to Lua\TeX} \section{What is it—and what makes it so different?} Lua\TeX{} on \textit{työkalupakki}—se sisältää kehittyneitä ohjelmistotyökaluja ja komponentteja, joiden avulla voit rakentaa (latoa) monenlaisia asiakirjoja. Tämän artikkelin alaotsikko esittää myös kaksi kysymystä Lua\TeX{}:stä: Mikä se on — ja mikä tekee siitä niin erilaisen? Vastaus kysymykseen “Mikä se on?” saattaa vaikuttaa ilmeiseltä: “Se on \TeX{}-ladontamoottori!” Niin se onkin, mutta laajempi näkemys, jota tämän kirjoittaja kannattaa, on että Lua\TeX{} on erittäin monipuolinen \TeX{}-pohjainen asiakirjojen rakentamis- ja suunnittelujärjestelmä. \subsection{Explaining Lua\TeX: Where to start?} Tämän ensimmäisen Lua\TeX{}-artikkelin tavoitteena on tarjota konteksti sille, mitä tämä TeX-moottori tarjoaa ja miksi/miten sen suunnittelu antaa käyttäjille mahdollisuuden rakentaa, suunnitella ja luoda monenlaisia ratkaisuja monimutkaisiin ladonta- ja suunnitteluongelmiin — ehkä myös tarjoten jonkin verran ”tulevaisuudenkestävyyttä” \chapter{Lua\TeX: Background and history} \section{Introduction} Lua\TeX{} on \TeX{}-termein “uusi tulokas”, vaikka sitä on kehitetty aktiivisesti yli 10 vuoden ajan. \subsection{Lua\TeX: Opening up \TeX’s “black box”} Knuthin alkuperäinen \TeX{}-ohjelma on kaikkien nykyisin käytössä olevien modernien \TeX{}-moottoreiden yhteinen kantaisä, ja Lua\TeX{} on käytännössä uusin kehitysvaihe: se pohjautuu pdf\TeX{}-ohjelmaan, mutta siihen on lisätty joitakin tehokkaita ohjelmistokomponentteja, jotka tuovat paljon lisätoiminnallisuutta. \subsubsection{How Lua\TeX{} processes \texttt{\string\directlua}: A first look} The ⟨code⟩ provided to \verb|\directlua{}| is first converted to tokens using the processes and calculations discussed above; that sequence of tokens is stored in a token list. \end{document} ``` [Nähdäksesi tulosteen, **avaa tämä esimerkki Overleafissa** (se käyttää `**lualatex**`)](}|+is+first+converted+to+tokens+using+the+processes+and+calculations+discussed+above;+that+sequence+of+tokens+is+stored+in+a+token+list. \end{document}>) ## Mukauta lukuja ja osioita Voit käyttää [`titlesec`](https://ctan.org/pkg/titlesec?lang=en) pakettia muokataksesi lukujen, osioiden ja alaosioiden tyyliä helposti. ```latex \documentclass[a4paper,12pt]{book} \usepackage[T1]{fontenc} \usepackage{titlesec} \titleformat {\chapter} % command [display] % shape {\bfseries\Large\itshape} % format {Story No. \ \thechapter} % label {0.5ex} % sep { \rule{\textwidth}{1pt} \vspace{1ex} \centering } % before-code [ \vspace{-0.5ex}% \rule{\textwidth}{0.3pt} ] % after-code \titleformat{\section}[wrap] {\normalfont\bfseries} {\thesection.}{0.5em}{} \titlespacing{\section}{12pc}{1.5ex plus .1ex minus .2ex}{1pc} \begin{document} Aloitetaan Ensimmäinen yritys Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris... Toinen yritys Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris... \end{document} ``` [Avaa tämä `titlesec` esimerkki Overleafissa.](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=titlesec+example\&snip=%5Cdocumentclass%5Ba4paper%2C12pt%5D%7Bbook%7D%0A%5Cusepackage%5BT1%5D%7Bfontenc%7D%0A%5Cusepackage%7Btitlesec%7D%0A%0A%5Ctitleformat%0A%7B%5Cchapter%7D+%25+command%0A%5Bdisplay%5D+%25+shape%0A%7B%5Cbfseries%5CLarge%5Citshape%7D+%25+format%0A%7BStory+No.+%5C+%5Cthechapter%7D+%25+label%0A%7B0.5ex%7D+%25+sep%0A%7B%0A++++%5Crule%7B%5Ctextwidth%7D%7B1pt%7D%0A++++%5Cvspace%7B1ex%7D%0A++++%5Ccentering%0A%7D+%25+before-code%0A%5B%0A%5Cvspace%7B-0.5ex%7D%25%0A%5Crule%7B%5Ctextwidth%7D%7B0.3pt%7D%0A%5D+%25+after-code%0A%0A%0A%5Ctitleformat%7B%5Csection%7D%5Bwrap%5D%0A%7B%5Cnormalfont%5Cbfseries%7D%0A%7B%5Cthesection.%7D%7B0.5em%7D%7B%7D%0A%0A%5Ctitlespacing%7B%5Csection%7D%7B12pc%7D%7B1.5ex+plus+.1ex+minus+.2ex%7D%7B1pc%7D%0A%0A%5Cbegin%7Bdocument%7D%0A%5Cchapter%7BLet%27s+begin%7D%0A%5Csection%7BFirst+Attempt%7D%0A%0ALorem+ipsum+dolor+sit+amet%2C+consectetur+adipiscing+elit%2C+sed+do+%0Aeiusmod+tempor+incididunt+ut+labore+et+dolore+magna+aliqua.+Ut+%0Aenim+ad+minim+veniam%2C+quis+nostrud+exercitation+ullamco+laboris...%0A%0A%5Csection%7BSecond+attempt%7D%0A%0ALorem+ipsum+dolor+sit+amet%2C+consectetur+adipiscing+elit%2C+sed+do+%0Aeiusmod+tempor+incididunt+ut+labore+et+dolore+magna+aliqua.+Ut+%0Aenim+ad+minim+veniam%2C+quis+nostrud+exercitation+ullamco+laboris...%0A%0A%5Cend%7Bdocument%7D) Tämä esimerkki tuottaa seuraavan tulosteen: ![Titlesecolv2.png](/files/e30b16865e3129d134e0fae7c62cb287a23a814a) ### titlesec-komennot Yleisiä komentoja on kaksi: ```latex \titleformat{}[]{}{