L'EndNote XML est ce qu'exporte EndNote, et le moins portable des cinq. Le CSL JSON est la forme que lisent les moteurs de citation, et la seule qu'un programme apprécie. pandoc se tient entre les deux, et cette page dit exactement ce qui arrive à un fichier EndNote XML en route vers le CSL JSON.
Ce qui s'exécute quand un fichier EndNote XML devient un CSL JSON
pandoc 3.1.3, sur une machine que nous louons et que nous surveillons. Votre fichier EndNote XML est envoyé une fois, pandoc s'exécute une fois, le fichier CSL JSON revient, et aucun des deux fichiers n'est conservé. EndNote XML vers CSL JSON 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 EndNote XML dans le fichier CSL JSON
Chaque référence, et chaque champ pour lequel le CSL JSON 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 EndNote XML n'a pas. Un EndNote XML 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é, et c'est la seule cible qui n'a rien à signaler. Nous avons passé une entrée portant onze champs par les trois rédacteurs et relu la sortie champ par champ : le CSL JSON n'en a laissé tomber aucun, parce que le CSL JSON est la forme dans laquelle les quatre autres sont lus, et qu'il n'y a donc rien à comprimer en sortie.
Ce que la conversion EndNote XML vers CSL JSON vous coûte
Rien, et quelque chose est AJOUTÉ à la place, ce qui est la partie inhabituelle. Votre fichier EndNote XML 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.
Le LaTeX contenu dans vos champs, si vous en aviez. `{\LaTeX}` et `\emph{...}` sont des instructions destinées à un compositeur, et le CSL JSON est lu par des programmes qui n'en font pas tourner. Ce qui arrive, c'est le texte.
D'où viennent les fichiers EndNote XML et CSL JSON
EndNote XML. L'export XML propre à EndNote, verbeux et spécifique à lui. Comme le RIS il n'a pas de clef de citation, et contrairement au RIS il n'a pas de rédacteur ici : il est lu et jamais écrit, parce que pandoc n'en a pas non plus.
CSL JSON. Le format de données du Citation Style Language, ce que parlent Zotero, le citeproc de pandoc et la plupart des logiciels de références quand ils mettent en forme une bibliographie par style plutôt qu'en la composant. C'est du JSON : il n'a donc pas de liste de champs fixe et rien n'a besoin d'être comprimé pour tenir.
Si un modèle doit lire le fichier CSL JSON
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. EndNote XML à l'entrée, CSL JSON à 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é.
EndNote XML vers CSL JSON, mesuré plutôt que promis
En passant EndNote XML vers CSL JSON sur le moteur réel avec un vrai fichier, pandoc a écrit 724 octets au format CSL JSON en moins d'un dixième de seconde, machine par ailleurs au repos. C'est un fichier EndNote XML un jour donné et non une moyenne, et c'est pourquoi le nombre est donné avec le fichier qui l'a produit.
Le verdict EndNote XML vers CSL JSON 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 CSL JSON contient.
Ce que nous ne prétendrons pas sur EndNote XML vers CSL JSON
Un fichier EndNote XML 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 EndNote XML vers CSL JSON 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 EndNote XML 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.
Les clefs de citation de votre CSL JSON n'étaient pas dans le fichier EndNote XML 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 EndNote XML à la fois, choisi dans le navigateur. Il n'y a rien d'autre à régler et rien d'autre à proposer.
EndNote XML vers CSL JSON : les questions que l'on pose
Qu'est-ce qui convertit vraiment mon fichier EndNote XML en CSL JSON ?
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 EndNote XML est envoyé une fois, pandoc s'exécute une fois, le CSL JSON revient, et aucun des deux fichiers n'est conservé ensuite.
Combien de temps prend une conversion EndNote XML vers CSL JSON ?
Sur le fichier utilisé par la sonde, pandoc a mis moins d'un dixième de seconde et écrit 724 octets de CSL JSON. C'est une mesure réelle sur un fichier EndNote XML réel, pas une moyenne et pas une promesse sur le vôtre : un EndNote XML 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 de l'EndNote XML au CSL JSON ?
Celle qu'il faut connaître en premier : rien, et quelque chose est AJOUTÉ à la place, ce qui est la partie inhabituelle. Votre fichier EndNote XML 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.
Mes clefs de citation fonctionneront-elles encore ?
Votre fichier EndNote XML 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.
À quoi sert le CSL JSON ?
C'est ce que lisent les moteurs de citation : Zotero, le citeproc de pandoc, et tout ce qui met en forme des références par style plutôt qu'en les composant. C'est aussi la forme dans laquelle les quatre autres formats sont lus ici, et c'est pourquoi rien ne se perd en chemin vers lui.
La conversion EndNote XML vers CSL JSON est-elle gratuite ?
Il y a une franchise gratuite chaque mois, et une conversion EndNote XML vers CSL JSON 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 CSL JSON moins bon.