Le BibTeX est le format de bibliographie que LaTeX lit depuis 1985. Le BibLaTeX en est la réécriture moderne, avec la même extension .bib. pandoc se tient entre les deux, et cette page dit exactement ce qui arrive à un fichier BibTeX en route vers le BibLaTeX.
Ce qui s'exécute quand un fichier BibTeX devient un BibLaTeX
pandoc 3.1.3, sur une machine que nous louons et que nous surveillons. Votre fichier BibTeX est envoyé une fois, pandoc s'exécute une fois, le fichier BibLaTeX revient, et aucun des deux fichiers n'est conservé. BibTeX vers BibLaTeX fait partie des 3649 paires sur lesquelles ce moteur a été sondé avec un vrai fichier, et c'est pour cela que cette page existe quand celles que la sonde n'a pas su prouver n'existent pas.
Ce qui survit du fichier BibTeX dans le fichier BibLaTeX
Chaque référence, et chaque champ pour lequel le BibLaTeX a une place. Le moteur compte les entrées à l'entrée et à la sortie et refuse le résultat si le nombre a bougé, parce qu'une bibliographie qui revient avec la moitié de ses références passe tous les contrôles de format et reste fausse.
Les auteurs dans l'ordre où vous les aviez, avec le nom de famille encore séparé du prénom. C'est cette séparation qui permet à un style de citation d'imprimer « Durand, M. » dans une revue et « Marie Durand » dans la suivante, et c'est la première chose qu'un convertisseur naïf aplatit en une seule chaîne.
Chaque champ que vous avez envoyé, y compris ceux que ce rédacteur jette. Nous avons passé une entrée portant onze champs par les trois rédacteurs et relu la sortie champ par champ : le rédacteur BibLaTeX de pandoc laisse tomber keywords, parce que le BibLaTeX a un champ pour presque tout et que presque rien n'a donc à être abandonné en sortie. KEYWORDS est repris de la forme intermédiaire et remis en place, jamais par-dessus ce que le rédacteur a gardé.
Une clef que LATEX accepte réellement. Ce n'est pas une formalité : pandoc écrira volontiers `@article{O'Brien_2019,`, et l'apostrophe empêche `\cite` de se résoudre. Tout ce qui n'est pas sûr est réécrit, et un en-tête de réponse dit combien.
Le DOI, l'ISBN, l'ISSN et l'URL, ce qu'il vaut mieux dire franchement puisque le rédacteur BibLaTeX de pandoc en laisse tomber une partie. Ils sont repris de la forme intermédiaire et remis en place, jamais par-dessus ce que le rédacteur a gardé.
Ce que la conversion BibTeX vers BibLaTeX vous coûte
Rien de mesurable. Le rédacteur BibLaTeX de pandoc laisse tomber keywords, et ils sont remis en place. Tout le reste de ce qu'on a donné à cette paire ressort de l'autre côté.
Rien que vous remarqueriez, et les NOMS de champ changent, ce qui est tout l'objet. Le BibTeX écrit `journal` et `year` ; le BibLaTeX écrit `journaltitle` et `date`. La même référence, dite dans le vocabulaire que l'autre lit.
D'où viennent les fichiers BibTeX et BibLaTeX
BibTeX. Écrit par Oren Patashnik pour LaTeX, et toujours la raison pour laquelle tout gestionnaire de références propose un export .bib. Chaque entrée est un type, une clef de citation et une liste de champs. La clef est ce que \cite{...} cherche, et c'est pourquoi un fichier dont les clefs sont cassées est un fichier bon à jeter.
BibLaTeX. Une réécriture qui a déplacé le travail du langage propre au BibTeX vers LaTeX, et qui a renommé les champs au passage : journaltitle pour journal, date pour year. Il partage l'extension .bib avec le BibTeX et ce n'est pas le même fichier, ce qui est toute la raison de convertir de l'un vers l'autre.
Si un modèle doit lire le fichier BibLaTeX
Une bibliographie est une liste d'affirmations qu'un modèle peut vérifier, et non de la prose qu'il doit interpréter : chaque entrée nomme un auteur, une année, une revue et souvent un DOI. BibTeX à l'entrée, BibLaTeX à la sortie, avec tous les champs pour lesquels la cible a de la place, ce qui permet à un modèle de répondre à « lesquelles sont postérieures à 2019 » sans lire un seul résumé.
BibTeX vers BibLaTeX, mesuré plutôt que promis
En passant BibTeX vers BibLaTeX sur le moteur réel avec un vrai fichier, pandoc a écrit 394 octets au format BibLaTeX en moins d'un dixième de seconde, machine par ailleurs au repos. C'est un fichier BibTeX un jour donné et non une moyenne, et c'est pourquoi le nombre est donné avec le fichier qui l'a produit.
Le verdict BibTeX vers BibLaTeX a été obtenu par le recomptage des références et le contrôle de chaque clef de citation, c'est-à-dire que chaque référence a été recomptée dans la sortie, et chaque clef de citation y a été contrôlée : non vide, unique, et faite des seuls caractères que LaTeX accepte dans une commande de citation. Le contrôle employé compte, parce qu'ils ne prouvent pas tous la même chose, et un code de statut 200 ne prouve strictement rien sur ce que le fichier BibLaTeX contient.
Ce que nous ne prétendrons pas sur BibTeX vers BibLaTeX
Un fichier BibTeX de plus de 5 Mo est refusé avant la fin de l'envoi plutôt qu'après, pour que vous n'attendiez pas un refus.
Une conversion BibTeX vers BibLaTeX qui dépasse 30 secondes est tuée, et le processus pandoc avec elle. Une exécution abandonnée resterait posée sur l'un des deux cœurs de la machine jusqu'à ce que quelqu'un le remarque.
Ceci ne déduplique, ne fusionne et ne vérifie rien. Deux exemplaires du même article ressortent en deux références, une année fausse ressort fausse, et un DOI qui ne mène nulle part est reporté tel quel. Cela convertit une bibliographie en une autre forme de la même bibliographie.
Un fichier BibTeX à la fois, choisi dans le navigateur. Il n'y a rien d'autre à régler et rien d'autre à proposer.
BibTeX vers BibLaTeX : les questions que l'on pose
Qu'est-ce qui convertit vraiment mon fichier BibTeX en BibLaTeX ?
C'est pandoc qui s'en charge, en 3.1.3, sur une machine que nous louons et que nous surveillons. Ni astuce de navigateur, ni service d'un tiers : le fichier BibTeX est envoyé une fois, pandoc s'exécute une fois, le BibLaTeX revient, et aucun des deux fichiers n'est conservé ensuite.
Combien de temps prend une conversion BibTeX vers BibLaTeX ?
Sur le fichier utilisé par la sonde, pandoc a mis moins d'un dixième de seconde et écrit 394 octets de BibLaTeX. C'est une mesure réelle sur un fichier BibTeX réel, pas une moyenne et pas une promesse sur le vôtre : un BibTeX plus gros prend plus longtemps, et au-delà de 30 secondes l'exécution est arrêtée.
Qu'est-ce que je perds en passant du BibTeX au BibLaTeX ?
Celle qu'il faut connaître en premier : rien de mesurable. Le rédacteur BibLaTeX de pandoc laisse tomber keywords, et ils sont remis en place. Tout le reste de ce qu'on a donné à cette paire ressort de l'autre côté.
Mes clefs de citation fonctionneront-elles encore ?
Oui. Une clef que vous avez écrite vous-même n'est jamais touchée. Seule est réécrite une clef vide, dupliquée, ou qui porte un caractère que LaTeX n'accepte pas dans une commande de citation, et un en-tête de réponse dit combien.
Le fichier compilera-t-il ?
C'est le vrai sujet de cette page. La plupart des convertisseurs vous remettent la sortie brute de pandoc, qui depuis un EndNote XML contient `@article{,`, une entrée sans aucune clef. Elle s'ouvre dans un éditeur et elle ne compile pas. Toute clef qui sort d'ici est non vide, unique, et faite uniquement de caractères que `\cite` accepte.
Le BibLaTeX n'est-il pas simplement du BibTeX ?
Ils partagent l'extension .bib et ce ne sont pas le même fichier. Le BibLaTeX écrit `journaltitle` là où le BibTeX écrit `journal`, et `date` là où le BibTeX écrit `year`, entre autres. Un fichier écrit pour l'un n'est lu par l'autre que dans la mesure où les noms de champ se trouvent coïncider.
La conversion BibTeX vers BibLaTeX est-elle gratuite ?
Il y a une franchise gratuite chaque mois, et une conversion BibTeX vers BibLaTeX y coûte un demi-crédit. Quand la franchise est épuisée, l'outil le dit et s'arrête, plutôt que de vous remettre discrètement un BibLaTeX moins bon.