> 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/lisaa-aiheita/05-bibliography-management-in-latex.md). # Lähdeluettelon hallinta LaTeXissa ## Johdanto Kun on kyse bibliografianhallintapaketeista, LaTeXissa on kolme päävaihtoehtoa: `bibtex`, `natbib` ja `biblatex`. Tässä artikkelissa selitetään, miten käyttää `biblatex` pakettia bibliografian hallintaan ja muotoiluun LaTeX-asiakirjassa. `biblatex` on nykyaikainen vaihtoehto bibliografiatietojen käsittelyyn, tarjoaa helpomman ja joustavamman käyttöliittymän sekä paremman kielilokalisaation kuin kaksi muuta vaihtoehtoa. Alla on minimaalinen toimiva esimerkki `biblatex` paketista: ```latex \documentclass[letterpaper,10pt]{article} \usepackage{biblatex} %Tuo biblatex-paketin \addbibresource{sample.bib} %Tuo bibliografiatiedosto \begin{document} Lainataan! Einsteinin aikakauslehtiartikkeli \cite{einstein} ja Diracin kirja \cite{dirac} ovat fysiikkaan liittyviä kohteita. \printbibliography %Tulostaa bibliografian \end{document} ``` ![BiblatexEx1OLV2.png](/files/71972522061348df3aadfaaf2f18f7bca81fb445) Tässä esimerkissä on neljä bibliografiaan liittyvää komentoa: **\usepackage{biblatex}** Tuo biblatex-paketin. **\addbibresource{sample.bib}** Tuo bibliografiatietotiedoston sample.bib: tämä tiedosto sisältää tiedot jokaisesta viitatusta kirjasta, artikkelista jne. Katso lisätietoja bibliografiatiedoston osiosta. **\cite{einstein}** Tämä komento lisää asiakirjaan viitteen, tässä tapauksessa \[1], joka vastaa yhtä bibliografian merkintää; einstein on avainsana, joka vastaa merkintää sample.bib-tiedostossa. **\printbibliography** Tulostaa viitattujen lähteiden luettelon; oletusotsikko on "Viitteet" artikkeliasiakirjaluokalle ja "Bibliografia" kirjoille ja raporteille. Overleaf tarjoaa useita esiasetetuilla tyyleillä varustettuja mallipohjia bibliografioiden hallintaan. Katso [tämä linkki](https://www.overleaf.com/gallery/tagged/bibliography). [Avaa biblatex-paketin esimerkki Overleafissä](https://www.overleaf.com/project/new/template/19714?id=66708264\&templateName=Biber+bibliography+example\&latexEngine=\&texImage=texlive-full%3A2020.1\&mainFile=) ## Peruskäyttö Paketin tuontikomentoon voidaan antaa useita parametreja seuraavan esimerkin mukaisesti: ```latex \documentclass{article} \usepackage[ backend=biber, style=alphabetic, sorting=ynt ]{biblatex} \addbibresource{sample.bib} \title{Bibliografian hallinta: \texttt{biblatex}-paketti} \author{Overleaf} \date{ } \begin{document} \maketitle Käyttämällä \texttt{biblatex}-pakettia voit näyttää bibliografian jaettuna osiin viittaustyypin mukaan. Lainataan! Einsteinin aikakauslehtiartikkeli \cite{einstein} ja Diracin kirja \cite{dirac} ovat fysiikkaan liittyviä kohteita. Seuraavaksi \textit{The \LaTeX\ Companion} -kirja \cite{latexcompanion}, Donald Knuthin verkkosivusto \cite{knuthwebsite}, \textit{The Comprehensive Tex Archive Network} (CTAN) \cite{ctan} ovat \LaTeX-aiheisia kohteita; mutta muut, Donald Knuthin kohteet, \cite{knuth-fa,knuth-acp} ovat omistettu ohjelmoinnille. \\medskip \printbibliography \end{document} ``` ![BiblatexExample2OLV2.png](/files/1b3e4a0cc265d9a5a2942c35d735a59ca203c403) Pakettia tuotaessa voidaan lisätä hakasulkeissa ja pilkuilla erotettuja lisäasetuksia, `biblatex`: **backend=biber** Asettaa taustajärjestelmäksi bibliografian lajittelun; biber on oletusarvoinen ja suositeltu, koska se tarjoaa täyden lokalisoinnin useille komennoille ja biberin tyylejä on helpompi muokata, koska ne käyttävät tavallisia LaTeX-makroja. Toinen tuettu taustajärjestelmä on bibtex, joka on perinteisempi ohjelma; jos se asetetaan taustajärjestelmäksi, bibtexiä käytetään vain bibliografian lajitteluun, joten bibtex-tyylejä ei voi käyttää täällä. **style=alphabetic** Määrittää bibliografiatyylin ja viittaustyylin, tässä tapauksessa aakkosellisen. Tyylistä riippuen käytettävissä voi olla useampia viittauskomentoja. Katso lisätietoja biblatex-bibliografiatyyleistä ja viittaustyyleistä. **sorting=ynt** Määrittää kriteerit bibliografialähteiden lajittelulle. Tässä tapauksessa ne lajitellaan vuoden, nimen ja otsikon mukaan. Katso viiteoppaasta luettelo lajitteluvaihtoehdoista. Muut komennot selitettiin kohdassa [johdannossa](#introduction). [Avaa täydellisempi `biblatex` esimerkki Overleafissa](https://www.overleaf.com/project/new/template/19715?id=66713383\&templateName=A+biblatex+example\&latexEngine=\&texImage=texlive-full%3A2020.1\&mainFile=) ## Bibliografiatiedosto Bibliografiatiedostojen on käytettävä tavallista BibTeX-syntaksia ```latex @article{einstein, author = "Albert Einstein", title = "{Zur Elektrodynamik bewegter K{\"o}rper}. ({German}) [{Liikkuvien kappaleiden sähködynamiikasta}]", journal = "Annalen der Physik", volume = "322", number = "10", pages = "891--921", year = "1905", DOI = "http://dx.doi.org/10.1002/andp.19053221004", keywords = "physics" } @book{dirac, title = {Kvanttimekaniikan periaatteet}, author = {Paul Adrien Maurice Dirac}, isbn = {9780198520115}, series = {Fysiikan monografiasarja}, year = {1981}, publisher = {Clarendon Press}, keywords = {physics} } @online{knuthwebsite, author = "Donald Knuth", title = "Knuth: tietokoneet ja tekstinladonta", url = "http://www-cs-faculty.stanford.edu/~uno/abcde.html", addendum = "(avattu: 01.09.2016)", keywords = "latex,knuth" } @inbook{knuth-fa, author = "Donald E. Knuth", title = "Perusalgoritmit", publisher = "Addison-Wesley", year = "1973", chapter = "1.2", keywords = "knuth,programming" } ... ``` Tämä tiedosto sisältää tietueita erityisessä muodossa; esimerkiksi ensimmäinen bibliografinen viite on määritelty näin: **@article{...}** Tämä on tietueen ensimmäinen rivi, @article kertoo BibTeXille, että tähän tallennettu tieto koskee artikkelia. Tämän merkinnän tiedot on suljettu aaltosulkeisiin. Esimerkin näyttämien tietuetyyppien (article, book, online ja inbook) lisäksi on monia muitakin; katso viiteoppaasta lisätietoja. **einstein** Tunniste einstein on annettu tälle merkinnälle; se on yksilöllinen tunniste, jota voidaan käyttää viitattaessa tähän artikkeliin asiakirjassa. **author = "Albert Einstein",** Tämä on bibliografiamerkinnän ensimmäinen kenttä, joka osoittaa, että tämän artikkelin kirjoittaja on Albert Einstein. Useita pilkuilla erotettuja kenttiä voidaan lisätä samalla syntaksilla avain = arvo, esimerkiksi: title, pages, year, URL jne. Katso viiteoppaasta luettelo mahdollisista kentistä. Tämän tiedoston tiedot voidaan myöhemmin tulostaa ja niihin voidaan viitata LaTeX-asiakirjassa, kuten edellisissä osioissa on osoitettu, komennolla `\addbibresource{sample.bib}`. Kaikkia .bib-tiedoston tietoja ei näytetä; se riippuu asiakirjassa asetetusta bibliografiatyylistä. [Avaa täydellisempi `biblatex` esimerkki Overleafissa](https://www.overleaf.com/project/new/template/19715?id=66713383\&templateName=A+biblatex+example\&latexEngine=\&texImage=texlive-full%3A2020.1\&mainFile=) ## Bibliografian mukauttaminen Biblatex mahdollistaa bibliografiaosion laajan mukauttamisen vähällä vaivalla. Mainittiin, että useita [viittaustyylejä](/latex/fi/viitteet-ja-sitaatit/08-biblatex-citation-styles.md) ja [bibliografiatyylejä](/latex/fi/viitteet-ja-sitaatit/07-biblatex-bibliography-styles.md) on saatavilla, ja voit myös luoda uusia. Toinen mukautusvaihtoehto on vaihtaa bibliografiaosion oletusotsikko. ```latex \documentclass{article} \usepackage[ backend=biber, style=alphabetic, sorting=ynt ]{biblatex} \addbibresource{sample.bib} \title{Bibliografian hallinta: \texttt{biblatex}-paketti} \author{Overleaf} \date{Toukokuu 2021} \begin{document} \maketitle Käyttämällä \texttt{biblatex}-pakettia voit näyttää bibliografian jaettuna osiin, viittaustyypistä riippuen. Lainataan! Einsteinin aikakauslehtiartikkeli \cite{einstein} ja Diracin kirja \cite{dirac} ovat fysiikkaan liittyviä kohteita. Seuraavaksi \textit{The \LaTeX\ Companion} kirja \cite{latexcompanion}, Donald Knuthin verkkosivusto \cite{knuthwebsite}, \textit{The Comprehensive Tex Archive Network} (CTAN) \cite{ctan} ovat \LaTeX-aiheisia kohteita; mutta muut, Donald Knuthin kohteet, \cite{knuth-fa,knuth-acp} ovat omistettu ohjelmoinnille. \\medskip \printbibliography[title={Koko bibliografia}] ``` ![BiblatexEx3OLV2.png](/files/7eff54f5df8de05df5a72f07cb4800be562e440e) Lisäparametri `title={Koko bibliografia}` joka annetaan hakasulkeissa komennolle `\printbibliography` on se, joka muuttaa otsikon. Bibliografia voidaan myös jakaa osiin eri suodattimien perusteella, esimerkiksi: tulosta vain saman kirjoittajan, saman lehden tai samankaltaisen otsikon viitteet. Alla esimerkki. ```latex \printbibliography[type=article,title={Vain artikkelit}] \printbibliography[type=book,title={Vain kirjat}] \printbibliography[keyword={physics},title={Vain fysiikkaan liittyvät}] \printbibliography[keyword={latex},title={Vain \LaTeX-aiheiset}] ``` ![BiblatexEx4OLV2.png](/files/0de35bf0d19728d054c71ab74a859caedaea5dbb) Tässä bibliografia on jaettu neljään osaan. Tässä käytettyjen komentojen syntaksi selitetään alla: **\printbibliography\[type=article,title={Vain artikkelit}]** Tulostaa vain merkinnät, joiden tyyppi on "article", ja asettaa tämän osion otsikoksi "Vain artikkelit". Sama syntaksi toimii minkä tahansa muun tietuetyypin kanssa. **\printbibliography\[keyword={physics},title={Vain fysiikkaan liittyvät}]** Suodattaa bibliografiamerkinnät, jotka sisältävät sanan "physics" missä tahansa kentässä. Asettaa kyseisen osion otsikoksi "Vain fysiikkaan liittyvät". [Avaa täydellisempi `biblatex` esimerkki Overleafissa](https://www.overleaf.com/project/new/template/19715?id=66713383\&templateName=A+biblatex+example\&latexEngine=\&texImage=texlive-full%3A2020.1\&mainFile=) ## Bibliografian lisääminen sisällysluetteloon Jotta bibliografia tulostettaisiin sisällysluetteloon, on annettava ylimääräinen asetus komennolle `\printbibliography` ```latex \printbibliography[ heading=bibintoc, title={Koko bibliografia} ] \printbibliography[heading=subbibintoc,type=article,title={Vain artikkelit}] ``` ![BiblatexEx5OLV2.png](/files/abd2b1b71d87ce38bb3feb56df49537c66f56594) Sisällysluetteloon lisätään osio ja alaosio: * Ensimmäisessä tapauksessa lisääminen `heading=bibintoc` lisää otsikon sisällysluetteloon numeroimattomana lukuna, jos mahdollista, tai muuten numeroimattomana osiona. * Toinen tapa on `heading=subbibintoc` joka lisää otsikon sisällysluetteloon toisen tason merkintänä, tässä esimerkissä alaosiona, joka on sijoitettu kohtaan "Koko bibliografia". [Avaa täydellisempi `biblatex` esimerkki Overleafissa](https://www.overleaf.com/project/new/template/19715?id=66713383\&templateName=A+biblatex+example\&latexEngine=\&texImage=texlive-full%3A2020.1\&mainFile=) ## Viiteopas **Tuetut tietuetyypit** | | | | | ------------- | ---------------- | ------------ | | article | book | mvbook | | inbook | bookinbook | suppbook | | booklet | collection | mvcollection | | incollection | suppcollection | manual | | misc | verkossa olevaan | patent | | periodical | suppperiodical | proceedings | | mvproceedings | inproceedings | viite | | mvreference | inreference | raportti | | set | thesis | unpublished | | custom | conference | electronic | | masterthesis | phdthesis | techreport | **Tuetut kentät** (Tulostettava tieto riippuu bibliografiatyylistä) | | | | | | ------------- | ------------ | ------------- | --------------- | | tiivistelmä | addendum | afterword | annotate | | tekijä | authortype | bookauthor | bookpagination | | booksubtitle | booktitle | chapter | commentator | | date | doi | edition | editor | | editortype | eid | entrysubtype | eprint | | eprinttype | eprintclass | eventdate | eventtitle | | tiedostoa | foreword | holder | howpublished | | indextitle | institution | johdannossa | isan | | isbn | ismn | isrn | issue | | issuesubtitle | issuetitle | iswc | journalsubtitle | | journaltitle | label | kielelle | kirjastoksi | | location | mainsubtitle | maintitle | month | | note | number | organization | origdate | | origlanguage | origlocation | origpublisher | origtitle | | pages | pagetotal | pagination | part | | publisher | pubstate | reprinttitle | sarja | | shortauthor | shortedition | shorthand | shorthandintro | | shortjournal | shortseries | shorttitle | subtitle | | otsikko | translator | type | url | | venue | version | volume | year | **Bibliografian lajitteluvaihtoehdot** | vaihtoehdon | kuvaus | | ----------- | -------------------------------------------------------------------------------- | | `nty` | lajittele nimen, otsikon ja vuoden mukaan | | `nyt` | lajittele nimen, vuoden ja otsikon mukaan | | `nyvt` | lajittele nimen, vuoden, vuosikerran ja otsikon mukaan | | `anyt` | lajittele aakkosellisen tunnisteen, nimen, vuoden ja otsikon mukaan | | `anyvt` | lajittele aakkosellisen tunnisteen, nimen, vuoden, vuosikerran ja otsikon mukaan | | `ydnt` | lajittele vuoden mukaan (laskevasti), nimen ja otsikon mukaan | | `none` | merkinnät käsitellään viittausjärjestyksessä | Katso yksityiskohtaiset tiedot näistä merkinnöistä ja vaihtoehdoista paketin dokumentaatiosta. ## Lisälukemista Lisätietoja on kohdassa * [Biblatex-bibliografiatyylit](/latex/fi/viitteet-ja-sitaatit/07-biblatex-bibliography-styles.md) * [Biblatex-viittaustyylit](/latex/fi/viitteet-ja-sitaatit/08-biblatex-citation-styles.md) * [Viiteluettelon hallinta natbibillä](/latex/fi/viitteet-ja-sitaatit/02-bibliography-management-with-natbib.md) * [Lähdeluettelon hallinta BibTeXillä](/latex/fi/viitteet-ja-sitaatit/01-bibliography-management-with-bibtex.md) * [Bibliografioiden luominen ja hallinta BibTeXillä Overleafissä](https://www.overleaf.com/blog/532) * [Biblatex-paketin dokumentaatio](http://linorg.usp.br/CTAN/macros/latex/contrib/biblatex/doc/biblatex.pdf) * [Kansainvälinen kielituki](/latex/fi/kielet/03-international-language-support.md) * [Sisällysluettelo](/latex/fi/asiakirjan-rakenne/02-table-of-contents.md) * [Hallinta suuressa projektissa](/latex/fi/asiakirjan-rakenne/07-management-in-a-large-project.md) * [Useita tiedostoja sisältävät LaTeX-projektit](/latex/fi/asiakirjan-rakenne/08-multi-file-latex-projects.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/lisaa-aiheita/05-bibliography-management-in-latex.md?ask=&goal= ``` `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.