Le RIS est l'export en texte brut que tout gestionnaire de références sait écrire. Le BibTeX est le format de bibliographie que LaTeX lit depuis 1985. pandoc se tient entre les deux, et cette page dit exactement ce qui arrive à un fichier RIS en route vers le BibTeX.
Ce qui s'exécute quand un fichier RIS devient un BibTeX
pandoc 3.1.3, sur une machine que nous louons et que nous surveillons. Votre fichier RIS est envoyé une fois, pandoc s'exécute une fois, le fichier BibTeX revient, et aucun des deux fichiers n'est conservé. RIS vers BibTeX 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 RIS dans le fichier BibTeX
Chaque référence, et chaque champ pour lequel le BibTeX 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.
Une clef de citation sur chaque entrée, ce que votre fichier RIS n'a pas. Un RIS porte la référence et non le nom sous lequel vous la citez : la clef doit donc être fabriquée. Elle est bâtie comme un gestionnaire de références en bâtit une, nom de famille plus année, avec a, b, c quand deux entrées se heurteraient.
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 BibTeX de pandoc laisse tomber doi, isbn, keywords et abstract, parce que le BibTeX de 1985 n'avait de champ pour aucun d'eux, ce qui se défend pour le format et ne sert à rien à celui dont le fichier les portait. DOI, ISBN et KEYWORDS sont repris de la forme intermédiaire et remis en place, jamais par-dessus ce que le rédacteur a gardé. Le résumé est l'exception, et la section suivante dit pourquoi.
Ce que la conversion RIS vers BibTeX vous coûte
Le résumé, et seulement le résumé. Le rédacteur BibTeX de pandoc laisse tomber quatre champs : doi, isbn, keywords et abstract. Trois d'entre eux sont remis en place depuis la forme intermédiaire ; le résumé non, et la raison est dans la section suivante plutôt que laissée à votre recherche.
Rien, et quelque chose est AJOUTÉ à la place, ce qui est la partie inhabituelle. Votre fichier RIS n'a pas de clefs de citation : elles sont donc fabriquées. Ce sont des suppositions raisonnables de ce que vous auriez tapé, et cela reste des suppositions : si un de vos documents LaTeX cite déjà ces références sous d'autres noms, les nouvelles clefs ne lui correspondront pas.
D'où viennent les fichiers RIS et BibTeX
RIS. Nommé d'après Research Information Systems et adopté par tout le monde : Zotero, Mendeley, EndNote, PubMed et la plupart des sites de revues le proposent. Des étiquettes de deux lettres, une par ligne, un champ chacune. Il porte la référence et NON le nom sous lequel vous la citez, seul fait qui décide de ce que convertir depuis lui peut vouloir dire.
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.
Si un modèle doit lire le fichier BibTeX
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. RIS à l'entrée, BibTeX à 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é.
RIS vers BibTeX, mesuré plutôt que promis
En passant RIS vers BibTeX sur le moteur réel avec un vrai fichier, pandoc a écrit 372 octets au format BibTeX en moins d'un dixième de seconde, machine par ailleurs au repos. C'est un fichier RIS un jour donné et non une moyenne, et c'est pourquoi le nombre est donné avec le fichier qui l'a produit.
Le verdict RIS vers BibTeX 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 BibTeX contient.
Ce que nous ne prétendrons pas sur RIS vers BibTeX
Un fichier RIS 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 RIS vers BibTeX 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.
Le RIS et l'EndNote XML se lisent ici et ne s'écrivent pas : pandoc n'a de rédacteur ni pour l'un ni pour l'autre. En demander un rend un 415 avec les trois cibles qui fonctionnent, plutôt qu'un échec qu'il vous faudrait interpréter. C'est l'asymétrie de cette famille et ce n'est pas un oubli. Votre fichier RIS est sorti d'un gestionnaire de références, et le chemin du retour passe par l'import de ce gestionnaire, pas par cette page.
Le résumé est laissé tomber et N'EST PAS remis en place, contrairement à doi, isbn et keywords. Réinjecter de la prose libre dans un fichier .bib demande d'échapper du LaTeX sur du texte quelconque, et un .bib qui ne compile pas est pire qu'un .bib sans résumé. Un en-tête de réponse dit si votre fichier en portait un.
Les clefs de citation de votre BibTeX n'étaient pas dans le fichier RIS et n'auraient pas pu y être : le format n'a pas de champ pour elles. Elles sont de nous. Un en-tête de réponse dit combien ont été fabriquées. Le dire ici plutôt que de vous le laisser découvrir quand un `\cite` ne se résout pas est tout l'objet de cette section.
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 RIS à la fois, choisi dans le navigateur. Il n'y a rien d'autre à régler et rien d'autre à proposer.
RIS vers BibTeX : les questions que l'on pose
Qu'est-ce qui convertit vraiment mon fichier RIS en BibTeX ?
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 RIS est envoyé une fois, pandoc s'exécute une fois, le BibTeX revient, et aucun des deux fichiers n'est conservé ensuite.
Combien de temps prend une conversion RIS vers BibTeX ?
Sur le fichier utilisé par la sonde, pandoc a mis moins d'un dixième de seconde et écrit 372 octets de BibTeX. C'est une mesure réelle sur un fichier RIS réel, pas une moyenne et pas une promesse sur le vôtre : un RIS 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 RIS au BibTeX ?
Celle qu'il faut connaître en premier : le résumé, et seulement le résumé. Le rédacteur BibTeX de pandoc laisse tomber quatre champs : doi, isbn, keywords et abstract. Trois d'entre eux sont remis en place depuis la forme intermédiaire ; le résumé non, et la raison est dans la section suivante plutôt que laissée à votre recherche.
Mes clefs de citation fonctionneront-elles encore ?
Votre fichier RIS n'en a aucune : elles sont donc fabriquées ici, nom de famille plus année, avec a, b, c quand deux se heurteraient. Si un de vos documents cite déjà ces références sous d'autres noms, cela ne correspondra pas, et il vaut la peine de le vérifier avant de lancer la conversion.
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.
Où sont passés mes DOI ?
Nulle part. Le rédacteur BibTeX de pandoc laisse tomber doi, isbn, keywords et abstract, ce qui se défend pour le BibTeX de 1985 et ne sert à rien à celui dont le fichier les portait. Les trois premiers sont remis en place. Le résumé non, parce qu'échapper de la prose libre pour LaTeX est la manière d'obtenir un fichier qui ne compile pas.
La conversion RIS vers BibTeX est-elle gratuite ?
Il y a une franchise gratuite chaque mois, et une conversion RIS vers BibTeX 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 BibTeX moins bon.