> 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/syvalliset-artikkelit/13-getting-started-with-biblatex.md). # BibLaTeXin käytön aloittaminen **Tekijä: Josh Cassidy (heinäkuu 2013)** LaTeX-käyttäjät ovat vuosien ajan käyttäneet BibTeXiä yhdessä useiden lisäpakettien, kuten `natbib` viiteluetteloiden kirjoittamiseen. Nyt on kuitenkin uusi vaihtoehto, BibLaTeX. Se on suunniteltu antamaan sinulle paljon enemmän vaihtoehtoja viiteluetteloidesi/viittaustesi helppoon määrittämiseen. Kätevästi olemassa olevat `.bib` tiedostot eivät todennäköisesti tarvitse paljon muutoksia toimiakseen BibLaTeXin kanssa. Yli 300 sivun [BibLaTeX-dokumentaation](http://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf)lisäksi CTANissa on myös hyödyllinen [BibLaTeXin lunttilappu](http://tug.ctan.org/info/biblatex-cheatsheet/biblatex-cheatsheet.pdf). Näiden resurssien täydentämiseksi tässä on video-opastus ja sen jälkeen joitakin muistiinpanoja/esimerkkejä, jotka auttavat sinua alkuun. {% embed url="" %} ### Peruskomennot ja tyylit Ensinnäkin komennot, joita käytät tex-tiedostossa viiteluettelon lisäämiseksi dokumenttiin, ovat varsin erilaisia. Esipreambleen sinun täytyy käyttää seuraavaa koodia: ```latex \usepackage{biblatex} \addbibresource{} ``` Ensimmäinen komento vain lataa `biblatex` paketin. Toista käytetään määrittämään, mitä bib-tiedostoja haluat käyttää. Syötät vain tiedostonimen aaltosulkeisiin, mukaan lukien `.bib` tiedostopäätteen. Sitten dokumentin rungossa sen sijaan, että käyttäisit `\bibliography` komentoa viiteluettelon rakentamiseen, käytät `\printbibliography` komentoa. BibTeXiä käyttäessäsi määrität viiteluettelon tyylin käyttämällä `\bibliographystyle` komentoa. `biblatex` emme enää käytä tätä komentoa, vaan määritämme tyylivaihtoehdot antamalla enemmän argumentteja `\usepackage` komennolle. Tätä varten syötämme `style=` sitä seuraavan tyylin nimen hakasulkeisiin heti aaltosulkeiden edelle. Esimerkiksi: ```latex \usepackage[style=numeric]{biblatex} ``` Vaihtoehtoisesti, jos haluat määrittää yhden tyylin viittauksille ja toisen tyylin viiteluettelolle, käytät sanoja `citestyle` ja `bibstyle`. Tässä on esimerkki: ```latex \usepackage[citestyle=alphabetic,bibstyle=authortitle]{biblatex} ``` Ennen kuin jatkan eteenpäin, näytän nopeasti, miltä jotkin näistä tyyleistä näyttävät sekä viittauksissa että varsinaisessa viiteluettelomerkinnässä. Voit kuitenkin [katsoa dokumentaatiota](http://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf) saadaksesi täydellisen luettelon tyyleistä. * Se `numeerinen` tyyli: ![BiBLaTeXnumeric.png](/files/48afaa98ab07948162f9338e1bfc1d72a286cc3f)- The `aakkosellinen` tyyli: ![BiBLaTeXalphabetic.png](/files/7e5177b1106c62f4623f8e5f76130ca4c4cb1826)- The `lukutapa` tyyli: ![BiBLaTeXreading.png](/files/e32faf6c661dd6f76f44cb9b6759fdc85f664f2f)- The `authoryear` tyyli: ![BiBLaTeXauthoryear.png](/files/130d4515dcf11682f7ab9dd414183dddd49e06be) Toinen argumentti, jonka voit antaa `\usepackage` komennolle, on lajitteluasetus. Esimerkiksi: ```latex \usepackage[style=authoryear,sorting=ynt]{biblatex} ``` Tämä käyttäisi tekijä-vuosi-tyyliä ja lajittelisi sitten viiteluettelon merkinnät vuoden, nimen ja otsikon mukaan. Tässä on luettelo joistakin käytettävissä olevista lajitteluvaihtoehdoista: * `nty`—lajittelee merkinnät nimen, otsikon, vuoden mukaan; * `nyt`—lajittelee merkinnät nimen, vuoden, otsikon mukaan; * `nyvt`—lajittelee merkinnät nimen, vuoden, vuosikerran, otsikon mukaan; * `anyt`—lajittelee merkinnät aakkosellisen tunnisteen, nimen, vuoden, otsikon mukaan; * `anyvt`—lajittelee merkinnät aakkosellisen tunnisteen, nimen, vuoden, vuosikerran, otsikon mukaan; * `ynt`—lajittelee merkinnät vuoden, nimen, otsikon mukaan; * `ydnt`—lajittelee merkinnät vuoden (laskevaan järjestykseen), nimen, otsikon mukaan; * `none`—ei lajittelua. Merkinnät näkyvät siinä järjestyksessä kuin ne esiintyvät tekstissä. Jos et määritä järjestystä, oletusarvo on `nty`. ### Viittauskomennot Viittauskomennot on myös uudistettu `biblatex`. Nämä älykkäämmät komennot antavat sinulle mahdollisuuden lisätä `esihuomautuksen` ja `jälkihuomautuksen` argumentteina: * a `esihuomautuksen` on sana tai ilmaus, kuten 'katso', joka lisätään viittauksen alkuun; * a `jälkihuomautuksen` on tekstiä, jonka haluat lisättävän viittauksen loppuun. Lisätäksesi nämä huomautukset käytät kahta hakasulkeiden sarjaa viittauskomennossa. Tässä on esimerkki: ```latex \cite[see][page 12]{latexcompanion} ``` Tässä esimerkissä olemme jo ladanneet `aakkosellinen` tyylin ja `latexcompanion` on vain viitetunnus. Tältä viite näyttäisi tekstissä: ![BiBLaTeXprepost.png](/files/f614432eccee47d67ebddf469a59444ee933a2dc) Jos avaat vain yhden hakasulkuparin, se olettaa hakasulkujen sisällön olevan `jälkihuomautuksen`, joten jos haluat vain `esihuomautuksen` varmista, että avaat silti toisen hakasulkuparin ja jätä se sitten vain tyhjäksi. Käytettävissäsi on myös useita erilaisia viittauskomentoja. Tässä muutamia tavallisimpia: * `\cite`—peruskomento. Tulostaa ilman mitään hakasulkeita, paitsi kun käytetään `aakkosellinen` tai `numeerinen` tyyliä, jossa käytetään hakasulkeita; * `\parencite`—tulostaa viitteet sulkeissa, paitsi kun käytetään `aakkosellinen` tai `numeerinen` tyyliä, jossa käytetään hakasulkeita; * `\footcite`—lisää viitteen alaviitteeseen. ### Viiteluetteloiden jakaminen osiin Yksi hienoista asioista `biblatex` on se, että voit jakaa viiteluetteloita lähdetyypin mukaan. Tässä on esimerkki jakamisesta lähdetyypin mukaan: ```latex \printbibheading \printbibliography[type=book,heading=subbibliography,title={Kirjalähteet}] \printbibliography[nottype=book,heading=subbibliography,title={Muut lähteet}] ``` Tässä esimerkissä jaamme viiteluettelon kahteen osaan: toiseen kirjoille ja toiseen muille lähteille. Tässä on esimerkkituloste: ![BiBLaTeXtypes.png](/files/cbf74bbe758d42a9f655edb188a5baa28d8b5de9) Toinen tapa jakaa viiteluetteloita on käyttää avainsanasuodatinta. Tätä varten sinun täytyy lisätä `keywords` kenttä tietueisiin tiedostossasi `.bib` tiedostossa. Esimerkiksi: ```latex @article{key, keywords = {keywordA,keywordB,keywordC} ``` Tässä on esimerkki siitä, miten jaat sitten avainsanan mukaan: ```latex \printbibheading \printbibliography[keyword=major,heading=subbibliography,title={Päälähteet}] \printbibliography[keyword=minor,heading=subbibliography,title={Sivulähteet}] ``` Ja vastaava tuloste: ![BiBLaTeXmajor.png](/files/b774e6634f491acba1277160b9d420ca83b8db9e) Näyttää siltä, että jonain päivänä pian BibTeX on enää vain osa LaTeX-historiaa! Toivottavasti tästä oli apua, kun aloitit `biblatex`. --- # 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/syvalliset-artikkelit/13-getting-started-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.