> 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/viitteet-ja-sitaatit/03-bibliography-management-with-biblatex.md). # Lähdeluettelon hallinta biblatexillä Kun on kyse lähdeluetteloa hallinnoivista paketeista, LaTeXissa on kolme päävaihtoehtoa: bibtex, natbib ja biblatex. Biblatex on moderni ohjelma lähdeluettelotiedon käsittelyyn, tarjoaa helpomman ja joustavamman käyttöliittymän sekä paremman kielikohtaisen lokalisoinnin kuin kaksi muuta vaihtoehtoa. Tämä artikkeli selittää, miten käytetään **biblatex** lähdeluettelon hallintaan ja muotoiluun LaTeX-asiakirjassa. ## Johdanto Alla on minimaalinen toimiva esimerkki **biblatex** paketista: ```latex \documentclass{article} \usepackage[utf8]{inputenc} \usepackage[english]{babel} \usepackage{biblatex} \addbibresource{sample.bib} \begin{document} Lainataan! Einsteinin artikkeli \cite{einstein} ja Diracin kirja \cite{dirac} ovat fysiikkaan liittyviä kohteita. \printbibliography \end{document} ``` ![BiblatexEx1.png](/files/0f75c00158fe8bcc6dff30b4da1ef3393b24dfb6) Tässä esimerkissä on neljä bibliografiaan liittyvää komentoa: **\usepackage{biblatex}** Tuo biblatex-paketin. **\addbibresource{sample.bib}** Tämä komento tuo bibtex-datatiedoston sample.bib; tämä tiedosto sisältää tiedot kustakin viitatusta kirjasta, artikkelista jne. Katso lisätietoja bibliografiatiedoston osiosta. **\cite{einstein}** Tämä komento lisää viitteen asiakirjaan, tässä tapauksessa \[1], joka vastaa lähdeluettelon elementtiä; "einstein" on avainsana, joka vastaa merkintää tiedostossa sample.bib. **\printbibliography** Tulostaa viitattujen lähteiden luettelon; oletusotsikko on "References" artikkeli-asiakirjaluokalle ja "Bibliography" kirjoille ja raporteille. ***Overleaf tarjoaa useita malleja, joissa on valmiiksi määritellyt tyylit lähdeluettelon hallintaan. Katso*** [***näitä esimerkkejä.***](https://www.overleaf.com/latex/templates/tagged/bibliography) [Avaa biblatex-paketin esimerkki Overleafissa](https://www.overleaf.com/project/new/template/19715?id=66713383\&templateName=Example+using+BiBLaTeX\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=) ## Peruskäyttö Pakettia tuovaan lauseeseen voidaan välittää useita parametreja, katsotaan ```latex \documentclass{article} \usepackage[utf8]{inputenc} \usepackage[english]{babel} \usepackage{comment} \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ää lähdeluettelon jaettuna osiin, viittaustyypin mukaan. Lainataan! Einsteinin artikkeli \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} on omistettu ohjelmoinnille. \\medskip \printbibliography \end{document} ``` ![BiblatexEx2.png](/files/b04d2097262b60b3a8e0919c119c3d858f555237) Pakettia tuotaessa voidaan lisätä hakasulkeissa ja pilkuilla erotettuja lisäasetuksia, **biblatex**: **backend=biber** Asettaa taustajärjestelmän lajittelua varten lähdeluetteloa varten; biber on oletus 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, sitä käytetään vain lähdeluettelon lajitteluun, joten bibtex-tyylejä ei voi käyttää tässä. **style=alphabetic** Määrittää lähdeluettelotyylin ja viittaustyylin, tässä tapauksessa aakkosellisen. Tyylistä riippuen käytettävissä voi olla enemmän viittauskomentoja. Katso lisätietoja lähdeluettelotyyleistä ja viittaustyyleistä. **sorting=ynt** Määrittää kriteerit bibliografialähteiden lajittelulle. Tässä tapauksessa ne lajitellaan vuoden, nimen ja otsikon mukaan. Katso viiteoppaasta luettelo lajitteluvaihtoehdoista. Loput komennot selitettiin jo kohdassa [johdannossa](#introduction). [Avaa biblatex-paketin esimerkki Overleafissa](https://www.overleaf.com/project/new/template/19715?id=66713383\&templateName=Example+using+BiBLaTeX\&latexEngine=pdflatex\&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}. ({saksa}) [{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 = "fysiikka" } @book{dirac, title={Kvanttimekaniikan periaatteet}, author={Paul Adrien Maurice Dirac}, isbn={9780198520115}, series={Fysiikan kansainvälinen monografiasarja}, year={1981}, publisher={Clarendon Press}, keywords = {physics} } @online{knuthwebsite, author = "Donald Knuth", title = "Knuth: Tietokoneet ja ladonta", url = "http://www-cs-faculty.stanford.edu/~uno/abcde.html", 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 seuraavasti: **@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** Tunnus einstein on annettu tälle merkinnälle; se on tunniste, jota voidaan käyttää viitattaessa tähän artikkeliin asiakirjan sisällä. **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 biblatex-paketin esimerkki Overleafissa](https://www.overleaf.com/project/new/template/19715?id=66713383\&templateName=Example+using+BiBLaTeX\&latexEngine=pdflatex\&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[utf8]{inputenc} \usepackage[english]{babel} \usepackage{comment} \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ää lähdeluettelon jaettuna osiin, viittaustyypin mukaan. Lainataan! Einsteinin artikkeli \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} on omistettu ohjelmoinnille. \\medskip \printbibliography[title={Koko bibliografia}] \end{document} ``` ![BiblatexEx3.png](/files/5ecb40b27f5361829181a55b47b4452d7ca40c2c) 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}] ``` ![BiblatexEx4.png](/files/ee0263730ee50b906b59933b7f305b3eee269fcc) 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 biblatex-paketin esimerkki Overleafissa](https://www.overleaf.com/project/new/template/19715?id=66713383\&templateName=Example+using+BiBLaTeX\&latexEngine=pdflatex\&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}] ``` ![BiblatexEx5.png](/files/6d7ee234dd5b34e4757613139d5a856bf7cf5165) 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 biblatex-paketin esimerkki Overleafissa](https://www.overleaf.com/project/new/template/19715?id=66713383\&templateName=Example+using+BiBLaTeX\&latexEngine=pdflatex\&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 | | maisterintutkielma | phdthesis | techreport | | tietotyyppi | | | **Tuetut kentät** (Tulostettava tieto riippuu bibliografiatyylistä) | | | | | | ------------- | ------------ | ------------- | --------------- | | tiivistelmä | afterword | merkintä | annotoija | | 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ä | ## Lisälukemista Lisätietoja on kohdassa * [Lähdeluettelotyylit](/latex/fi/viitteet-ja-sitaatit/04-bibtex-bibliography-styles.md) * [Biblatex-viittaustyylit](/latex/fi/viitteet-ja-sitaatit/08-biblatex-citation-styles.md) * [Perustason lähdeluettelon hallinta](/latex/fi/lisaa-aiheita/05-bibliography-management-in-latex.md) * [Viiteluettelon hallinta natbibillä](/latex/fi/viitteet-ja-sitaatit/02-bibliography-management-with-natbib.md) * [biblatex-dokumentaatio](http://linorg.usp.br/CTAN/macros/latex/contrib/biblatex/doc/biblatex.pdf) --- # 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/viitteet-ja-sitaatit/03-bibliography-management-with-biblatex.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.