> 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/overleaf-learn-latex-pt/artigos-aprofundados/13-getting-started-with-biblatex.md). # Primeiros passos com BibLaTeX **Autor: Josh Cassidy (Julho de 2013)** Durante anos, os utilizadores de LaTeX têm usado o BibTeX juntamente com vários pacotes adicionais, como `natbib` para escrever bibliografias. No entanto, agora há uma nova opção, o BibLaTeX. Foi concebido para lhe dar muitas mais opções para configurar facilmente as suas bibliografias/citações. Convenientemente, os `.bib` ficheiros existentes dificilmente precisarão de grandes alterações para funcionar com o BibLaTeX. Para além das mais de 300 páginas de [documentação do BibLaTeX](http://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf), o CTAN também tem uma útil [“folha de consulta” do BibLaTeX](http://tug.ctan.org/info/biblatex-cheatsheet/biblatex-cheatsheet.pdf). Para complementar esses recursos, aqui está um tutorial em vídeo seguido de algumas notas/exemplos para o ajudar a começar. {% embed url="" %} ### Comandos e estilos básicos Primeiro, os comandos que usa no ficheiro tex para adicionar uma bibliografia ao documento são bastante diferentes. No preâmbulo, precisa de usar o seguinte código: ```latex \usepackage{biblatex} \addbibresource{} ``` O primeiro comando apenas carrega o `biblatex` pacote. O segundo é usado para especificar que ficheiros bib pretende usar. Basta introduzir o nome do ficheiro entre chavetas, incluindo a `.bib` extensão. Depois, no corpo do documento, em vez de usar um `\bibliography` comando para construir a bibliografia, usa o `\printbibliography` comando. Ao usar BibTeX, especifica o estilo bibliográfico usando o `\bibliographystyle` comando. Em `biblatex` já não usamos este comando; em vez disso, especificamos as opções de estilo passando mais argumentos para o `\usepackage` comando. Para fazer isso, introduzimos `estilo=` seguido de um nome de estilo entre chavetas imediatamente antes das chavetas. Por exemplo: ```latex \usepackage[style=numeric]{biblatex} ``` Em alternativa, se quiser declarar um estilo para as citações e um estilo diferente para a bibliografia, usa as palavras `citestyle` e `bibstyle`. Aqui está um exemplo: ```latex \usepackage[citestyle=alphabetic,bibstyle=authortitle]{biblatex} ``` Antes de prosseguir, vou mostrar-lhe rapidamente como alguns destes estilos se parecem tanto nas citações como na entrada real da bibliografia. No entanto, pode [consultar a documentação](http://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf) para uma lista completa de estilos. * O `numérico` estilo: ![BiBLaTeXnumeric.png](/files/2c8d4dbea7af94ecf19999407bea326be1e7d8ea)- O `alfabético` estilo: ![BiBLaTeXalphabetic.png](/files/24e327e400be5240d72e76f01dc27fbf0f78a130)- O `leitura` estilo: ![BiBLaTeXreading.png](/files/a2a2284b304756bf2683207f41957ac8a967e252)- O `autor-ano` estilo: ![BiBLaTeXauthoryear.png](/files/46e96114016dd63489780486661714441bc7cb6d) Outro argumento que pode dar ao `\usepackage` comando é a opção de ordenação. Por exemplo: ```latex \usepackage[style=authoryear,sorting=ynt]{biblatex} ``` Isto usaria o estilo autor-ano e depois ordenaria as entradas bibliográficas por ano, nome, título. Aqui está uma lista de algumas das diferentes opções de ordenação disponíveis: * `nty`— ordena as entradas por nome, título, ano; * `nyt`— ordena as entradas por nome, ano, título; * `nyvt`— ordena as entradas por nome, ano, volume, título; * `anyt`— ordena as entradas por etiqueta alfabética, nome, ano, título; * `anyvt`— ordena as entradas por etiqueta alfabética, nome, ano, volume, título; * `ynt`— ordena as entradas por ano, nome, título; * `ydnt`— ordena as entradas por ano (ordem descendente), nome, título; * `none`— sem ordenação. As entradas aparecem na ordem em que aparecem no texto. Se não especificar uma ordem, o padrão é `nty`. ### Comandos de citação Os comandos de citação também foram reformulados em `biblatex`. Estes comandos mais inteligentes dão-lhe a opção de adicionar uma `pré-nota` e `pós-nota` como argumentos: * a `pré-nota` é uma palavra ou frase como 'see' que é inserida no início da citação; * a `pós-nota` é o texto que quer inserir no final da citação. Para adicionar estas notas, usa dois conjuntos de colchetes no comando de citação. Aqui está um exemplo: ```latex \cite[see][page 12]{latexcompanion} ``` Neste exemplo, já carregámos o `alfabético` estilo e `latexcompanion` é apenas a chave da citação. É assim que a citação apareceria no texto: ![BiBLaTeXprepost.png](/files/df12565f92a5b4f4e9357f6ae3e2dbab3f1058e4) Se abrir apenas um conjunto de colchetes, assumirá que o conteúdo dos colchetes é um `pós-nota`, por isso, se quiser apenas um `pré-nota` certifique-se de que ainda abre o segundo conjunto de colchetes e depois deixe-o simplesmente vazio. Também existem vários comandos de citação diferentes disponíveis para usar. Aqui estão alguns dos padrões: * `\cite`— o mais básico. Imprime sem quaisquer colchetes, exceto quando se usa o `alfabético` ou `numérico` estilo, quando usa colchetes; * `\parencite`— imprime citações entre parênteses, exceto quando se usa o `alfabético` ou `numérico` estilo, quando usa colchetes; * `\footcite`— coloca a citação numa nota de rodapé. ### Subdivisão de Bibliografias Uma das vantagens de `biblatex` é que pode subdividir bibliografias de acordo com o tipo de fonte. Aqui está um exemplo de subdivisão por tipo de fonte: ```latex \printbibheading \printbibliography[type=book,heading=subbibliography,title={Fontes de Livros}] \printbibliography[nottype=book,heading=subbibliography,title={Outras Fontes}] ``` Neste exemplo, estamos a subdividir a bibliografia em duas secções, uma para fontes que são livros e outra para fontes que não são. Aqui está um exemplo da saída: ![BiBLaTeXtypes.png](/files/b06889f28d98b8d687c349f571d66632feb83a58) Outra forma de subdividir bibliografias é usar um filtro de palavra-chave. Para fazer isso, precisa de adicionar um `keywords` campo nas entradas do seu `.bib` ficheiro. Por exemplo: ```latex @article{key, keywords = {keywordA,keywordB,keywordC} ``` Aqui está um exemplo de como depois subdividir por palavra-chave: ```latex \printbibheading \printbibliography[keyword=major,heading=subbibliography,title={Fontes Principais}] \printbibliography[keyword=minor,heading=subbibliography,title={Fontes Menores}] ``` E a saída correspondente: ![BiBLaTeXmajor.png](/files/c5b35d534ac1171208d3f33dca08ce40dfe5ed1c) Parece que um dia em breve o BibTeX não passará de um pedaço da história do LaTeX! Espero que isto tenha sido útil para o ajudar a começar com `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/overleaf-learn-latex-pt/artigos-aprofundados/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.