Nettoyeur et validateur BibTeX

Comment utiliser le nettoyeur BibTeX

1. 1. Collez ou chargez votre fichier .bib. Le lecteur prend le fichier entier tel que BibTeX le lit : macros @string, concaténation #, @preamble, @comment, accolades imbriquées et notes entre les entrées.
2. 2. Choisissez le nettoyage. Toutes les options sont activées par défaut, sauf la protection des majuscules et le tri ; désactivez celles que vous voulez laisser telles quelles. Le résultat se met à jour à chaque changement d'option.
3. 3. Lisez les problèmes. Les erreurs et avertissements sont listés avec leur ligne et leur clé de citation, de la revue manquante à une clé utilisée deux fois.
4. 4. Vérifiez les modifications, puis téléchargez. Chaque modification est consignée par entrée et par champ, avec la valeur avant et après ; le résultat se télécharge sous le nom cleaned.bib.

Ce que contrôle le validateur

BibTeX classique définit quatorze types d'entrées et les champs que chacun exige. Le validateur applique ce tableau, tiré de BibTeXing d'Oren Patashnik — la documentation livrée avec BibTeX —, et accepte les noms de biblatex pour les mêmes données : journaltitle, date et institution d'une thèse comptent comme leurs équivalents classiques.

Le validateur signale aussi une clé utilisée deux fois (BibTeX ne conserve que la première entrée), des clés qui ne diffèrent que par les majuscules, des clés contenant un espace ou un autre caractère que BibTeX ne peut pas lire, le même DOI dans deux entrées, le même titre et la même année dans deux entrées, un champ donné deux fois, une macro utilisée mais jamais définie avec @string, et une année qui n'a pas quatre chiffres. Une entrée que le lecteur ne peut pas achever — une virgule manquante, une accolade non équilibrée — est signalée avec son numéro de ligne et conservée exactement telle quelle, si bien que le nettoyage ne supprime jamais de texte.

Ce que modifie le nettoyage

• Types d'entrées et noms de champs en minuscules : @ARTICLE devient @article, Author devient author.
• Espaces : les sauts de ligne et les suites d'espaces dans une valeur sont réduits à des espaces simples.
• Délimiteurs : les valeurs entre guillemets passent entre accolades, qui résistent à un guillemet isolé dans un titre.
• Plages de pages avec le double tiret que LaTeX imprime comme un tiret demi-cadratin : 16569-16572 devient 16569--16572.
• Mois sous forme de macros BibTeX, jan à dec, écrits sans accolades pour que chaque style puisse les imprimer ou les abréger.
• Champs vides comme note = {} sont supprimés.
• DOI perdent le préfixe https://doi.org/ ; les styles qui impriment le DOI ajoutent le leur.
• Majuscules dans les titres (facultatif) : accolades autour des sigles et des mots en casse mixte — {DNA}, {mRNA}, {iPhone} — ou autour de chaque mot en majuscule après le premier, pour que les styles qui composent les titres en casse de phrase ne les mettent pas en minuscules.
• Ordre des champs : auteur, titre, revue ou titre de l'ouvrage, volume, numéro, pages, année, mois, éditeur, puis identifiants ; ou ordre alphabétique ; ou ordre d'origine.
• Tri (facultatif) : par clé, par premier auteur ou par année. Les définitions @string restent en tête, car une macro doit être définie avant qu'une entrée l'utilise.

@ARTICLE{hirsch2005,
  Author = {Hirsch, J. E.},
  title = "An index to quantify an individual's scientific research output",
  journal = {Proceedings of the National Academy of Sciences},
  year = 2005, month = {November},
  pages = {16569-16572},
  note = {}
}

@article{hirsch2005,
  author  = {Hirsch, J. E.},
  title   = {An index to quantify an individual's scientific research output},
  journal = {Proceedings of the National Academy of Sciences},
  pages   = {16569--16572},
  year    = 2005,
  month   = nov
}

Le journal des modifications de cette entrée compte sept lignes : le type passé en minuscules, Author renommé author, le titre mis entre accolades, November transformé en macro nov, la plage de pages dotée de son double tiret, le note vide supprimé et les champs mis en ordre. L'année reste un nombre nu, que BibTeX accepte.

BibTeX ou biblatex ?

Le même fichier .bib peut alimenter deux systèmes. BibTeX classique, avec des styles comme plain ou le fichier .bst d'une revue, connaît les quatorze types standard et ignore en silence les champs qu'il ne reconnaît pas. biblatex, traité par biber, ajoute des types comme @online, @report et @thesis, des champs comme journaltitle, date, location, urldate et eprint, et lit directement les lettres accentuées au lieu d'exiger des commandes d'accent LaTeX. Le validateur avertit lorsqu'une entrée utilise un type propre à biblatex — un style classique la ramène à @misc avec un avertissement — mais ne signale jamais un nom de champ biblatex comme champ manquant.

Questions fréquentes

Comment vérifier un fichier BibTeX pour détecter les erreurs ?

Collez-le dans la zone ci-dessus ou chargez le fichier .bib. Le validateur liste chaque problème avec son numéro de ligne et sa clé de citation : entrées illisibles, champs obligatoires manquants, clés en double, DOI ou titres répétés, macros non définies et années qui n'ont pas quatre chiffres. Corrigez d'abord les erreurs : ce sont celles qui font que BibTeX avertit ou abandonne une référence.

Que signifie le message « I'm skipping whatever remains of this entry » ?

C'est BibTeX qui abandonne une entrée qu'il ne peut pas analyser — en général à cause d'une virgule manquante entre deux champs, d'une accolade non équilibrée ou d'un guillemet à l'intérieur d'une valeur entre guillemets. Le nettoyeur signale les mêmes entrées comme erreurs d'analyse avec leurs numéros de ligne et les conserve dans la sortie exactement telles quelles, pour que vous puissiez les réparer sur place.

Faut-il utiliser -- dans BibTeX pour les pages ?

Oui. BibTeX transmet le champ pages à LaTeX, où -- imprime un tiret demi-cadratin, la marque correcte pour une plage. Beaucoup de styles standard transforment un tiret simple en -- eux-mêmes, mais pas tous, donc écrire -- dans le fichier est le choix sûr — et le nettoyeur le fait pour vous.

Pourquoi BibTeX met-il mon titre en minuscules, et comment l'éviter ?

Beaucoup de styles composent les titres d'articles en casse de phrase et mettent en minuscules chaque lettre non protégée par des accolades : DNA devient dna. Entourer un mot d'accolades — {DNA} — le protège. L'option de protection des majuscules du nettoyeur ajoute ces accolades aux sigles et aux mots en casse mixte, ou à chaque mot en majuscule après le premier lorsque vos titres sont pleins de noms propres.

Les clés de citation en double posent-elles problème ?

Oui. BibTeX utilise la première entrée portant une clé et ignore les autres, si bien qu'une citation peut pointer silencieusement vers la mauvaise œuvre. Les clés qui ne diffèrent que par les majuscules sont aussi signalées : BibTeX les avertit et biber les traite comme deux clés, si bien que la même citation peut se comporter différemment selon l'outil.

Mon fichier .bib est-il envoyé quelque part ?

Non. Le fichier est lu et nettoyé entièrement dans votre navigateur ; rien n'est envoyé à un serveur, et la copie nettoyée est créée sur votre propre appareil au moment du téléchargement.