> 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/fr/articles-approfondis/13-getting-started-with-biblatex.md). # Premiers pas avec BibLaTeX **Auteur : Josh Cassidy (juillet 2013)** Depuis des années, les utilisateurs de LaTeX utilisent BibTeX avec de nombreux paquets supplémentaires tels que `natbib` pour rédiger des bibliographies. Cependant, il existe maintenant une nouvelle option, BibLaTeX. Elle est conçue pour vous offrir bien plus d’options afin de configurer facilement vos bibliographies/citations. Heureusement, les `.bib` fichiers existants n’auront probablement pas besoin de beaucoup de modifications pour fonctionner avec BibLaTeX. En plus des plus de 300 pages de [documentation BibLaTeX](http://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf), CTAN propose aussi un utile [« aide-mémoire » BibLaTeX](http://tug.ctan.org/info/biblatex-cheatsheet/biblatex-cheatsheet.pdf). Pour compléter ces ressources, voici un tutoriel vidéo suivi de quelques notes/exemples pour vous aider à démarrer. {% embed url="" %} ### Commandes et styles de base Tout d’abord, les commandes que vous utilisez dans le fichier tex pour ajouter une bibliographie au document sont assez différentes. Dans le préambule, vous devez utiliser le code suivant : ```latex \usepackage{biblatex} \addbibresource{} ``` La première commande charge simplement le `biblatex` paquet. La seconde sert à indiquer quels fichiers bib vous souhaitez utiliser. Il vous suffit d’entrer le nom du fichier entre accolades, y compris l’ `.bib` extension. Ensuite, dans le corps du document, au lieu d’utiliser une `\bibliography` commande pour construire la bibliographie, vous utilisez la `\printbibliography` commande. Avec BibTeX, vous spécifiez le style bibliographique à l’aide de la `\bibliographystyle` commande. Dans `biblatex` nous n’utilisons plus cette commande ; à la place, nous précisons les options de style en passant davantage d’arguments à la `\usepackage` commande. Pour cela, nous saisissons `style=` suivi d’un nom de style entre crochets, juste avant les accolades. Par exemple : ```latex \usepackage[style=numeric]{biblatex} ``` Sinon, si vous voulez définir un style pour les citations et un style différent pour la bibliographie, vous utilisez les mots `citestyle` et `bibstyle`. Voici un exemple : ```latex \usepackage[citestyle=alphabetic,bibstyle=authortitle]{biblatex} ``` Avant d’aller plus loin, je vais vous montrer rapidement à quoi ressemblent certains de ces styles pour les citations ainsi que pour l’entrée bibliographique elle-même. Cependant, vous pouvez [consulter la documentation](http://mirror.ox.ac.uk/sites/ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf) pour obtenir la liste complète des styles. * Le `numérique` style : ![BiBLaTeXnumeric.png](/files/ecada0dd6cee2f633caacc42fdd025ba00dedcc5)- Le `alphabétique` style : ![BiBLaTeXalphabetic.png](/files/074d91d34dbedb2a3589ccc402f8b262ad159502)- Le `lecture` style : ![BiBLaTeXreading.png](/files/12fd28dfb108dab3e248b80d717a1fcf9cd4b7b0)- Le `authoryear` style : ![BiBLaTeXauthoryear.png](/files/195ad000153d46e33adbbf217c4fd439ed199f04) Un autre argument que vous pouvez donner à la `\usepackage` commande est l’option de tri. Par exemple : ```latex \usepackage[style=authoryear,sorting=ynt]{biblatex} ``` Cela utiliserait le style auteur-année, puis trierait les entrées bibliographiques par année, nom, titre. Voici une liste de quelques-unes des différentes options de tri disponibles : * `nty`— trie les entrées par nom, titre, année ; * `nyt`— trie les entrées par nom, année, titre ; * `nyvt`— trie les entrées par nom, année, volume, titre ; * `anyt`— trie les entrées par étiquette alphabétique, nom, année, titre ; * `anyvt`— trie les entrées par étiquette alphabétique, nom, année, volume, titre ; * `ynt`— trie les entrées par année, nom, titre ; * `ydnt`— trie les entrées par année (ordre décroissant), nom, titre ; * `none`— aucun tri. Les entrées apparaissent dans l’ordre où elles apparaissent dans le texte. Si vous ne spécifiez pas d’ordre, la valeur par défaut est `nty`. ### Commandes de citation Les commandes de citation ont également été remaniées dans `biblatex`. Ces commandes plus intelligentes vous offrent la possibilité d’ajouter une `note préalable` et `note ultérieure` comme arguments : * a `note préalable` est un mot ou une expression comme « voir » qui est inséré au début de la citation ; * a `note ultérieure` est le texte que vous souhaitez insérer à la fin de la citation. Pour ajouter ces notes, vous utilisez deux jeux de crochets dans la commande de citation. Voici un exemple : ```latex \cite[see][page 12]{latexcompanion} ``` Dans cet exemple, nous avons déjà chargé le `alphabétique` style et `latexcompanion` n’est que la clé de citation. Voici à quoi la citation ressemblerait dans le texte : ![BiBLaTeXprepost.png](/files/60ea6465b839586bec807381ce7f85af2b71f9bb) Si vous n’ouvrez qu’un seul jeu de crochets carrés, le contenu des crochets sera considéré comme une `note ultérieure`, donc si vous ne voulez qu’une `note préalable` assurez-vous d’ouvrir quand même le deuxième jeu de crochets carrés, puis laissez-le simplement vide. Il existe également un certain nombre de commandes de citation différentes que vous pouvez utiliser. En voici quelques-unes des plus courantes : * `\cite`— la plus basique. S’affiche sans crochets, sauf lorsqu’on utilise le `alphabétique` ou `numérique` style où elle utilise des crochets carrés ; * `\parencite`— affiche les citations entre parenthèses, sauf lorsqu’on utilise le `alphabétique` ou `numérique` style où elle utilise des crochets carrés ; * `\footcite`— place la citation en note de bas de page. ### Subdivision des bibliographies L’un des avantages de `biblatex` est que vous pouvez subdiviser les bibliographies selon le type de source. Voici un exemple de subdivision par type de source : ```latex \printbibheading \printbibliography[type=book,heading=subbibliography,title={Book Sources}] \printbibliography[nottype=book,heading=subbibliography,title={Other Sources}] ``` Dans cet exemple, nous subdivisons la bibliographie en deux sections, l’une pour les sources qui sont des livres et l’autre pour celles qui ne le sont pas. Voici un exemple de sortie : ![BiBLaTeXtypes.png](/files/432cf82243a14502823ad10799033efc6faadf83) Une autre façon de subdiviser les bibliographies consiste à utiliser un filtre par mot-clé. Pour cela, vous devez ajouter un `keywords` champ dans les entrées de votre `.bib` fichier. Par exemple : ```latex @article{key, keywords = {keywordA,keywordB,keywordC} ``` Voici un exemple de la manière dont vous les subdiviseriez ensuite par mot-clé : ```latex \printbibheading \printbibliography[keyword=major,heading=subbibliography,title={Major Sources}] \printbibliography[keyword=minor,heading=subbibliography,title={Minor Sources}] ``` Et la sortie correspondante : ![BiBLaTeXmajor.png](/files/3335ef54f43a6f72ae3aea453253f89337f38676) Il semble qu’un jour bientôt, BibTeX ne sera plus qu’un morceau d’histoire de LaTeX ! J’espère que cela vous aura aidé à démarrer avec `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/fr/articles-approfondis/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.