Différences

Ci-dessous, les différences entre deux révisions de la page.

--- 3_composition:annexes:bibliographie:construire_un_fichier_bibtex [2021/10/31 11:51] – Suite de la traduction. yannick.tanguy
+++ 3_composition:annexes:bibliographie:construire_un_fichier_bibtex [2021/11/02 13:05] (Version actuelle) – Ajout d'un lien suite à traduction d'une autre page. yannick.tanguy
@@ Ligne 1: / Ligne 1: @@
 ====== Comment créer un fichier bibliographique BibTeX? ======
-Un fichier bibliographique ''BibTeX'' peut être comparé à une petite base de données, dont chaque entrée est composée d'éléments bibliographiques. Ces entrées peuvent être appelées par des références dans un autre document.
+Un fichier bibliographique ''BibTeX'' est un fichier texte  dont le contenu peut être comparé à une petite base de données où chaque entrée est composée d'éléments bibliographiques. Ces entrées peuvent être appelées par des références dans un autre document.
-FIXME //Ajouter un exemple pour rendre le texte parlant !//
+===== Structure d'un fichier bibliographique BibTeX =====
-Chaque entrée de la bibliographie a un //type//, une //clé// unique et différents //champs// variables. La bibliographie est lue par ''BibTeX'' en utilisant les détails spécifiés dans un //fichier de style bibliographique//. À partir de ce fichier, ''BibTeX'' détermine quels types d'entrées sont autorisés, quels //champs// chaque type d'entrée possède et comment formater l'ensemble de l'entrée.
+Un fichier bibliographique ''BibTeX'' a toujours pour extension « .bib ». Il contient différentes entrées disposées les uns à la suite des autres, par exemple :
-Dans le détail,
+<code latex>
-  * le //type// spécifie le type de document auquel vous faites référence. La liste des types possibles est limitée : elle propose par exemple des valeurs comme ''book'' pour un livre, ''article'' pour un article d'un magazine ou d'une revue, ''manual'' pour un document technique, ''proceedings'' pour les actes d'une conférence, ''misc'' pour des documents inclassables ;
+@book{knuth_texbook_1986,
-  * la //clé// unique est à votre libre choix (du moment que vous vous limitez à utiliser des chiffres, lettres et quelques caractères usuels comme « _ » ,« - », « : », « . »). Cette clé s'utilise lorsque vous voulez [[3_composition/annexes/bibliographie/construire_une_bibliographie|citer une entrée]] dans votre document principal. Souvent, les utilisateurs créent une clé qui combine le nom de l'auteur (principal) et l'année de publication, éventuellement avec un marqueur pour distinguer les publications de la même année.
+	author = "Knuth, Donald Ervin",
+	title = "The {\TeX book}",
+	publisher = "Addison-Wesley",
+        series = "Computers \& typesetting",
+	number = "A",
+	year = "1986"
+}
+@book{mittelbach_latex_2005,
+	title = "{\LaTeX} Companion",
+	author = "Mittelbach, Frank and Goossens, Michel and Braams, Johannes and Carlisle, David and Rowley, Chris
+                  and Detig, Christine and Schrod, Joachim",
+	language = "French",
+	publisher = "Pearson Education",
+        edition = "2\superscript{e} édition",
+	year = "2005"
+}
+</code>
-Ses principes suffisent pour rédiger une base de données bibliographique. Heureusement, il existe plusieurs outils pour vous aider :
+La structure de chaque entrée est syntaxiquement la suivante (dans laquelle il faut bien faire attention à la présence des virgules) :
-   * la plupart des bons [[6_distributions:editeurs:start|éditeurs LaTeX]] proposent des modes de saisie de fichiers bibliographiques ;
-   * si vous avez déjà un environnement ''thebibliography'', le script Perl ''tex2bib'' vous sera probablement utile ;
-   * il existe un certain nombre de systèmes de gestion de bibliographie ''BibTeX'' disponibles, dont certains permettent une interface utilisateur graphique pour la tâche. Malheureusement, aucun ne semble être disponible avec les distributions <latex>\TeX ordinaires.
-FIXME //Traduire la suite.//
+<code latex>
+@type{cle_unique,
+	champ1 = "valeur1",
+	champ2 = "valeur2",
+	(...)
+        champN = "valeurN"
+}
+</code>
-Tools such as ''Xbibfile'' (a graphical user interface), ''ebib'' (a database application written to run "inside" Emacs) and ''btOOL'' (a set of Perl tools for building BibTeX database handlers) are available from CTAN.
+Chaque entrée de la bibliographie a un //type//, une //clé// unique et différents //champs// variables. La bibliographie est lue par ''BibTeX'' en utilisant les détails spécifiés dans un //fichier de style bibliographique//. À partir de ce fichier de style, ''BibTeX'' détermine quelles entrées sont autorisées, quels //champs// chaque type d'entrée possède et comment formater l'ensemble de l'entrée.
-Other systems, such as ''[[http://refdb.sourceforge.net/|RefDB]]'', [[http://www.nongnu.org/biborb|BibORB]], ''[[http://bibdesk.sourceforge.net/|BibDesk]]'', ''[[https://pybliographer.org|pybliographer]]'' and the Java-based ''[[http://freshmeat.net/projects/bibkeeper/|Bibkeeper]]'' and ''[[http://jabref.sourceforge.net|JabRef]]'' (which claims to supersede ''Bibkeeper'') are only available from their development sites.
+==== Le type ====
-Some commercial citation-management systems will export in BibTeX format; an example is [[https://www.endnote.com/|EndNote]].
+Le //type// spécifie le type de document auquel vous faites référence. La liste des types possibles est limitée : elle propose par exemple des valeurs comme ''book'' pour un livre, ''article'' pour un article d'un magazine ou d'une revue, ''manual'' pour un document technique, ''proceedings'' pour les actes d'une conférence, ''misc'' pour des documents inclassables.
-Data from on-line citation databases may often be translated to BibTeX format by utilities to be found on CTAN.  For example, the Perl script ''[[ctanpkg>isi2bibtex]]'' will translate citations from ISI "Web of knowledge" (a subscription service, available to UK academics via BIDS).  UK academics may translate BIDS downloads using the Perl script ''[[ctanpkg>bidstobibtex|bids.to.bibtex]]''.
+==== La clé unique ====
-[[https://scholar.google.com|Google Scholar]] provides an "Import into BibTeX" tab for each reference it finds for you : that tab gives you a page containing a BibTeX entry for the reference.
+La //clé// unique est à votre libre choix (du moment que vous vous limitez à utiliser des chiffres, lettres et quelques caractères usuels comme « _ » ,« - », « : », « . »). Cette clé s'utilise lorsque vous voulez [[3_composition/annexes/bibliographie/construire_une_bibliographie|citer une entrée]] dans votre document principal. Souvent, les utilisateurs créent une clé qui combine le nom de l'auteur (principal) et l'année de publication, éventuellement avec un marqueur pour distinguer les publications de la même année.
+==== Les champs ====
+Les //champs// dépendant normalement du type de document que vous avez choisi. Certains champs sont obligatoires (comme le champ donnant l'auteur, ''author'') et d'autres sont facultatifs (tel le champ ''series'' dans l'exemple ci-dessus). Tous peuvent contenir des commandes <latex>LaTeX</latex>.
+Le seul champ présentant une réelle particularité d'écriture est celui du nom des auteurs (comme l'exemple ci-dessus le montre avec l'ordre particulier du nom et du prénom des auteurs, la présence de la virgule entre eux et la présence du mot « and » entre chaque auteur). Voir sur ce sujet la question « [[3_composition/annexes/bibliographie/liste_d_auteurs|Comment saisir une liste d'auteurs sous BibTeX ?]] » et le cas plus rare de la question « [[3_composition/annexes/bibliographie/utiliser_les_deux_premieres_lettres_du_prenom_d_un_auteur|Comment définir des initiales de prénom regroupant au moins deux lettres ?]] »
+Un autre champ peut poser difficulté : celui des URL. Voir sur ce sujet la question « [[3_composition/annexes/bibliographie/citer_une_url|Comment citer une URL avec BibTeX ?]] ».
+===== Outils pour faciliter la création de fichiers bibliographiques =====
+Si les principes vus ci-dessus suffisent pour rédiger une base de données bibliographiques, une base de taille importante peut vite devenir fastidieuse à maintenir. Heureusement, il existe plusieurs outils pour vous aider.
+==== Outils de gestion de bases bibliographiques ====
+En premier lieu, la plupart des bons [[6_distributions:editeurs:start|éditeurs LaTeX]] proposent des modes de saisie de fichiers bibliographiques.
+Il existe un certain nombre de systèmes de gestion de bibliographie ''BibTeX'', dont certains avec interface graphique. S'ils ne sont pas disponibles avec les distributions <latex>\TeX</latex> ordinaires, ils n'en sont pas moins accessibles :
+  * des outils tels que [[ctanpkg>xbibfile|Xbibfile]] (une interface utilisateur graphique), [[ctanpkg>ebib|ebib]] (une application de base de données écrite pour s'exécuter au sein d'''Emacs'') et [[ctanpkg>btool|btOOL]] (un ensemble d'outils Perl pour créer des gestionnaires de bases de données ''BibTeX'') sont disponibles sur le CTAN ;
+  * d'autres outils, tels que ''[[3_composition/annexes/bibliographie/zotero_et_latex|Zotero]]'', ''[[http://refdb.sourceforge.net/|RefDB]]'', ''[[http://bibdesk.sourceforge.net/|BibDesk]]'', ''[[https://pybliographer.org|pybliographer]]'' ou bien encore l'outil  Java ''[[http://jabref.sourceforge.net|JabRef]]'' (qui remplace l'ancien ''[[http://freshmeat.net/projects/bibkeeper/|Bibkeeper]]'') sont disponibles depuis leurs sites de développement ;
+  * il existe bien entendu également des outils commerciaux permettant d'exporter des résultats au format ''BibTeX'', tel [[https://www.endnote.com/|EndNote]].
+Dans le cas où vous avez déjà un environnement ''thebibliography'' (ou que vous avez perdu le fichier bibliographique et qu'il ne vous reste plus que le fichier contenant cet environnement), le script Perl [[ctanpkg>tex2bib]] vous sera probablement utile pour (re)construire alors un fichier bibliographique. Voir sur ce point la question « [[3_composition/annexes/bibliographie/reconstruire_un_fichier_bib|Comment reconstruire un fichier “.bib” ?]] ».
+==== Outils de récupération de références en ligne ====
+Les entrées de bases de données bibliographiques en ligne peuvent souvent être traduites au format ''BibTeX'' par des utilitaires disponibles sur CTAN. Par exemple, le script Perl [[ctanpkg>isi2bibtex]] traduit les références de « [[https://clarivate.com/webofsciencegroup/solutions/web-of-science/|Web of Science]] » (un service d'abonnement, disponible pour les universitaires britanniques via BIDS). Les universitaires britanniques peuvent traduire les téléchargements BIDS en utilisant le script Perl [[ctanpkg>bidstobibtex|bids.to.bibtex]].
+Le site [[https://scholar.google.com|Google Scholar]] (décrit [[wpfr>Google_Scholar|ici]]) fournit un lien « Importer dans BibTeX » pour chaque référence qu'il trouve pour vous : cet lien vous donne une page contenant l'entrée ''BibTeX'' de la référence. Cette fonctionnalité s'obtient en procédant à une légère configuration de Google Scholar en allant chercher dans le menu compacté en haut à gauche de la page principale le lien « [[https://scholar.google.ca/scholar_settings|Paramètres]] » puis en cochant dans l'écran qui apparaît l'option « Afficher les liens permettant d'importer des citations dans » et en choisissant ''BibTeX''.
+Le site [[https://zbib.org/|Zoterobib]] permet également de rechercher et de récupérer en format ''BibTeX'' des références d'ouvrage en ligne.
 -----