> 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/pl/artykuly-szczegolowe/13-getting-started-with-biblatex.md). # Pierwsze kroki z BibLaTeX **Autor: Josh Cassidy (lipiec 2013)** Od lat użytkownicy LaTeX-a korzystają z BibTeX-a wraz z wieloma dodatkowymi pakietami, takimi jak `natbib` do tworzenia bibliografii. Jednak teraz pojawiła się nowa opcja: BibLaTeX. Został zaprojektowany tak, aby dać ci znacznie więcej możliwości łatwej konfiguracji bibliografii/cytowań. Na szczęście istniejące `.bib` pliki prawdopodobnie nie będą wymagały dużych zmian, aby działać z BibLaTeX-em. Oprócz ponad 300 stron [dokumentacji BibLaTeX](http://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf), na CTAN znajduje się także przydatna [ściągawka BibLaTeX](http://tug.ctan.org/info/biblatex-cheatsheet/biblatex-cheatsheet.pdf). Aby uzupełnić te materiały, poniżej znajduje się samouczek wideo, a następnie kilka uwag/przykładów, które pomogą ci zacząć. {% embed url="" %} ### Podstawowe polecenia i style Po pierwsze, polecenia używane w pliku tex do dodania bibliografii do dokumentu są dość inne. W preambule należy użyć następującego kodu: ```latex \usepackage{biblatex} \addbibresource{} ``` Pierwsze polecenie po prostu ładuje `biblatex` pakiet. Drugie służy do określenia, których plików bib chcesz użyć. Wystarczy wpisać nazwę pliku w nawiasach klamrowych, wraz z `.bib` rozszerzeniem. Następnie w treści dokumentu, zamiast używać `\\bibliography` polecenia do utworzenia bibliografii, używasz `\\printbibliography` polecenia. Przy korzystaniu z BibTeX-a styl bibliografii określa się za pomocą `\bibliographystyle` BibTeX. W `biblatex` BibLaTeX nie używamy już tego polecenia, zamiast tego określamy opcje stylu, przekazując więcej argumentów do `\usepackage` polecenia. Aby to zrobić, wpisujemy `styl=` a następnie nazwę stylu w nawiasach kwadratowych, bezpośrednio przed nawiasami klamrowymi. Na przykład: ```latex \usepackage[style=numeric]{biblatex} ``` Alternatywnie, jeśli chcesz określić jeden styl dla cytowań, a inny styl dla bibliografii, używasz słów `citestyle` i `bibstyle`. Oto przykład: ```latex \usepackage[citestyle=alphabetic,bibstyle=authortitle]{biblatex} ``` Zanim przejdę dalej, szybko pokażę, jak wyglądają niektóre z tych stylów zarówno w cytowaniach, jak i w rzeczywistym wpisie bibliograficznym. Jednak możesz [sięgnąć do dokumentacji](http://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf) po pełną listę stylów. * Ta `numeryczny` styl: ![BiBLaTeXnumeric.png](/files/42b426fc1dbefd0e6bb740cfe70eabda4302b5d4)— `alfabetyczny` styl: ![BiBLaTeXalphabetic.png](/files/e2e7e1cd23db4759f704ea1cc5a141faf284082a)— `czytanie` styl: ![BiBLaTeXreading.png](/files/9ec2ab231ab569856a5d4dc63248bbdb0170dff8)— `autor-rok` styl: ![BiBLaTeXauthoryear.png](/files/04eec440e1fdcf1fb9c78fabde1f5b68e52a8064) Kolejny argument, który możesz przekazać `\usepackage` poleceniu, jest opcja sortowania. Na przykład: ```latex \usepackage[style=authoryear,sorting=ynt]{biblatex} ``` To użyłoby stylu autor-rok, a następnie sortowało wpisy bibliograficzne według roku, nazwiska, tytułu. Oto lista niektórych dostępnych opcji sortowania: * `nty`—porządkuje wpisy według nazwiska, tytułu, roku; * `nyt`—porządkuje wpisy według nazwiska, roku, tytułu; * `nyvt`—porządkuje wpisy według nazwiska, roku, tomu, tytułu; * `anyt`—porządkuje wpisy według etykiety alfabetycznej, nazwiska, roku, tytułu; * `anyvt`—porządkuje wpisy według etykiety alfabetycznej, nazwiska, roku, tomu, tytułu; * `ynt`—porządkuje wpisy według roku, nazwiska, tytułu; * `ydnt`—porządkuje wpisy według roku (malejąco), nazwiska, tytułu; * `none`—brak sortowania. Wpisy pojawiają się w kolejności, w jakiej występują w tekście. Jeśli nie określisz kolejności, domyślną wartością jest `nty`. ### Polecenia cytowania Polecenia cytowania również zostały gruntownie przeprojektowane w `biblatex`. `przednotki` i `notki końcowej` jako argumentów: * a `przednotki` to słowo lub fraza, np. „see”, wstawiana na początku cytowania; * a `notki końcowej` to tekst, który chcesz wstawić na końcu cytowania. Aby dodać te notatki, używa się dwóch zestawów nawiasów kwadratowych w poleceniu cytowania. Oto przykład: ```latex \cite[see][page 12]{latexcompanion} ``` W tym przykładzie wczytaliśmy już `alfabetyczny` styl i `latexcompanion` to po prostu klucz cytowania. Tak będzie wyglądać cytowanie w tekście: ![BiBLaTeXprepost.png](/files/ed1d38c3cd9e8d897a6b289bac102d01de4beea9) Jeśli otworzysz tylko jeden zestaw nawiasów kwadratowych, program założy, że zawartość nawiasów jest `notki końcowej`uwagą wstępną, więc jeśli chcesz tylko `przednotki` upewnij się, że nadal otwierasz drugi zestaw nawiasów kwadratowych, a następnie po prostu zostaw go pustym. Dostępnych jest również wiele różnych poleceń cytowania, z których możesz korzystać. Oto niektóre z podstawowych: * `\cite`—najbardziej podstawowe. Drukuje bez nawiasów, z wyjątkiem sytuacji, gdy używasz `alfabetyczny` lub `numeryczny` stylu, w którym używa nawiasów kwadratowych; * `\parencite`—drukuje cytowania w nawiasach, z wyjątkiem sytuacji, gdy używasz `alfabetyczny` lub `numeryczny` stylu, w którym używa nawiasów kwadratowych; * `\footcite`—umieszcza cytowanie w przypisie dolnym. ### Dzielenie bibliografii na podsekcje Jedną z zalet `biblatex` jest to, że możesz dzielić bibliografie według typu źródła. Oto przykład podziału według typu źródła: ```latex \printbibheading \printbibliography[type=book,heading=subbibliography,title={Book Sources}] \printbibliography[nottype=book,heading=subbibliography,title={Other Sources}] ``` W tym przykładzie dzielimy bibliografię na dwie sekcje: jedną dla źródeł będących książkami i jedną dla źródeł, które nimi nie są. Oto przykładowy wynik: ![BiBLaTeXtypes.png](/files/06a27f6aa279c8c6ab9bf504efac23f11230bb2a) Inny sposób dzielenia bibliografii to użycie filtra słów kluczowych. Aby to zrobić, musisz dodać `słowa kluczowe` pole do wpisów w swoim `.bib` pliku. Na przykład: ```latex @article{key, keywords = {keywordA,keywordB,keywordC} ``` Oto przykład, jak następnie podzielić według słowa kluczowego: ```latex \printbibheading \printbibliography[keyword=major,heading=subbibliography,title={Major Sources}] \printbibliography[keyword=minor,heading=subbibliography,title={Minor Sources}] ``` A odpowiadający wynik: ![BiBLaTeXmajor.png](/files/78e6b09bd04a8b88ec8656af97e28e55d17c153b) Wygląda na to, że już niedługo BibTeX będzie tylko kawałkiem historii LaTeX-a! Mam nadzieję, że to pomogło ci zacząć korzystać z `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/pl/artykuly-szczegolowe/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.