Billet rédigé par ✏️ Jonathan Chibois J’ai eu récemment l’occasion de répondre sur Twitter à une interrogation concernant le résultat étrange de l’import d’une référence via le site Isidore dans Zotero. Et je me...

Jonathan Chibois

*Billet rédigé par* ✏️ *Jonathan Chibois*

::: {#attachment_1629 .wp-caption .aligncenter style="width: 650px"}
[![](http://zotero.hypotheses.org/files/2018/01/4266526952_4aed5cc0bb_z.jpg){.wp-image-1629
.size-full aria-describedby="caption-attachment-1629" decoding="async"
loading="lazy" width="640" height="433"
srcset="https://zotero.hypotheses.org/files/2018/01/4266526952_4aed5cc0bb_z.jpg 640w, https://zotero.hypotheses.org/files/2018/01/4266526952_4aed5cc0bb_z-300x203.jpg 300w"
sizes="(max-width: 640px) 100vw, 640px"}](http://zotero.hypotheses.org/files/2018/01/4266526952_4aed5cc0bb_z.jpg)

[« Public Works Department Employees Inspect the Exhaust System for
Visible Leaks at an Auto Emission Inspection Station in Norwood, Ohio...
»](https://www.flickr.com/photos/usnationalarchives/4266526952/) (The
U.S. National Archives, août 1975, domaine public)
:::

J'ai eu récemment l'occasion de répondre sur Twitter à une interrogation
concernant le résultat étrange de l'import d'une référence via le site
[Isidore](///tmp/mozilla_jonathan0/Quand%20le%20convertisseur%20ne%20convertit%20plus%E2%80%A6-1.html){target="_blank"
rel="noopener noreferrer"} dans Zotero. Et je me suis moi-même confronté
à un problème semblable sur le site du
[Monde](http://www.lemonde.fr){target="_blank"
rel="noopener noreferrer"} dans les jours qui ont suivi. Tout cela m'a
amené à creuser un peu la manière dont Zotero gère cette opération.

Je rédige donc cette petite note pour rassembler mes (petites)
découvertes techniques, en guise de mémo. Nous irons donc ici un peu
plus loin dans le moteur de Zotero que nous ne l'avons fait dans [notre
précédent billet sur l'import de
références](https://zotero.hypotheses.org/865){target="_blank"
rel="noopener noreferrer"}.

## Rappel : comment Zotero importe-il les références depuis le web ?

*Pour plus de détails (et des captures d'écran) sur ce point, voir notre
précédent billet générique [Ajouter une référence avec le nouveau
menu](https://zotero.hypotheses.org/865){target="_blank"
rel="noopener noreferrer"}.*

Sur un site web donné, pour importer une référence Zotero depuis votre
navigateur s'appuie sur un petit programme nommé *convertisseur web* (ou
*Web translator* en anglais) codé en javascript. Ils sont tous rangés
dans votre dossier Zotero, dans le répertoire `translators`. Il en
existe de deux types :

1.  Les premiers sont des *convertisseurs web* spécifiques, qui ont été
    configurés pour un site en particulier, afin de sélectionner un
    maximum de données pertinentes. Celui du site du
    [Monde.fr](http://Monde.fr){target="_blank"
    rel="noopener noreferrer"} est par exemple inclus dans le fichier
    `Le monde.js`. **Notez que ceux-ci sont pour beaucoup conçus par des
    développeurs indépendants de l'équipe Zotero.**
2.  Les seconds sont des *convertisseur web* génériques, qui ont
    l'avantage de fonctionner sur tous les sites web, mais qui ne
    tiennent pas compte des spécificités de chaque site web. Ceux-ci se
    nomment `Embedded metadata` ou `Page web` et sont développés par
    l'équipe Zotero.

Vous pouvez choisir quel convertisseur utiliser. Il faut pour cela ne
pas cliquer directement sur l'icône Zotero dans la barre d'outils de son
navigateur, mais cliquer avec le bouton droit, et se rendre dans le menu
"Save to Zotero". Ici apparaît alors une liste de tous les
convertisseurs disponible pour le site en particulier sur lequel vous
êtes.

::: {#attachment_1593 .wp-caption .aligncenter style="width: 1034px"}
[![](http://zotero.hypotheses.org/files/2018/01/convertisseur_screenshot2-1024x169.png){.wp-image-1593
.size-large aria-describedby="caption-attachment-1593" decoding="async"
loading="lazy" width="1024" height="169"
srcset="https://zotero.hypotheses.org/files/2018/01/convertisseur_screenshot2-1024x169.png 1024w, https://zotero.hypotheses.org/files/2018/01/convertisseur_screenshot2-300x50.png 300w, https://zotero.hypotheses.org/files/2018/01/convertisseur_screenshot2-768x127.png 768w, https://zotero.hypotheses.org/files/2018/01/convertisseur_screenshot2.png 1520w"
sizes="(max-width: 1024px) 100vw, 1024px"}](http://zotero.hypotheses.org/files/2018/01/convertisseur_screenshot2.png)

Vue du menu des convertisseurs (Cliquez pour agrandir)
:::

**Remarques :**

- Notez qu'il est facile de reconnaître un site pour lequel il n'existe
  pas de convertisseur spécifique :
  l'icône [![](http://zotero.hypotheses.org/files/2018/01/convertisseur_logoneutre_2.png){.alignnone
  .wp-image-1600 .size-full decoding="async" loading="lazy" width="22"
  height="21"
  srcset="https://zotero.hypotheses.org/files/2018/01/convertisseur_logoneutre_2.png 22w, https://zotero.hypotheses.org/files/2018/01/convertisseur_logoneutre_2-150x150.png 150w, https://zotero.hypotheses.org/files/2018/01/convertisseur_logoneutre_2-160x160.png 160w, https://zotero.hypotheses.org/files/2018/01/convertisseur_logoneutre_2-320x320.png 320w"
  sizes="(max-width: 22px) 100vw, 22px"}](http://zotero.hypotheses.org/files/2018/01/convertisseur_logoneutre_2.png)
  s'affiche sur le bouton Zotero dans votre barre d'outils. Celle-ci
  signifie implicitement que Zotero ne reconnaît pas le type de document
  affiché par votre navigateur, et donc que le convertisseur générique
  se déclenchera en cas de demande d'import de votre part.
- Notez enfin que les convertisseurs spécifiques donnent lieu à des
  références bien plus complètes et précises que ce à quoi peuvent
  parvenir les convertisseur génériques. Ils sont donc à privilégier (ce
  que Zotero fait d'ailleurs lorsqu'il y a un disponible pour le site
  internet que vous consultez).

## Comment fonctionne un convertisseur ?

Pour ma part, je rencontre assez fréquemment des soucis de
convertisseurs qui ne convertissent plus (ou mal). Parfois Zotero
importe de manière remarquable les références que je lui demande depuis
les sites web ou les bases de données bibliographiques en ligne, mais
parfois non. Parfois aussi, il lui arrive de ne plus importer
correctement ce qu'il importait très bien jusqu'alors. Parfois encore,
importer une même référence depuis deux sources distinctes produit des
références différentes.

En conséquence, il faut non seulement entrer à la main les informations
dans Zotero, mais en plus souvent corriger des erreurs que l'import a pu
commettre. Même si Zotero dispose de fonctionnalités pour [faciliter ce
nettoyage](http://zotero.hypotheses.org/760){target="_blank"
rel="noopener noreferrer"}, il y a de quoi s'arracher les cheveux
parfois, il faut le reconnaître. Faut-il pour autant jeter le bébé avec
l'eau du bain et abandonner Zotero ?

Pourquoi cela fonctionne-t-il pour certains sites internet, certaines
bases de données, et pas pour d'autres ? Pourquoi Zotero paraît parfois
ne plus savoir faire ? Pour comprendre ce qu'il se passe, il faut savoir
que Zotero **construit** la référence à chaque fois qu'on lui demande
d'en importer une.

*Par exemple.* Si je veux importer la référence d'un article du Monde
depuis le site web du journal, Zotero va collecter les informations
pertinentes dans cette page afin de compléter chacun des champs de la
référence qu'il va créer pour vous. Il va chercher l'auteur pour
renseigner le champ auteur, il va chercher le titre pour remplir le
champ titre, etc.

C'est-à-dire que les références d'une page ou d'un article **ne sont −
d'une manière générale − pas données à Zotero prêtes à importer**. On
trouve certes des références clé en main (par exemple sous la forme de
fichiers `.bib` ou `.ris` ou de liens spécifiques d'import pour les
applications *Endnote* ou *Refworks*), mais celles-ci sont gérées par un
autre type de convertisseur, nous n'en parlerons donc pas ici. Notez
néanmoins qu'elles sont utiles en cas d'import massif de références, ou
alors justement en cas d'échec de l'import automatique via le
convertisseur web. Concernant l'import web, Zotero travaille toujours à
assembler les informations affichés sur la page consultée ainsi que
celles fournies sous forme de métadonnées invisibles.

Donc, si un site web souhaite être pleinement compatible avec Zotero,
son webmestre va s'assurer d'afficher et de signaler les informations
importantes (titre, auteur, date, etc) afin que le convertisseur
générique puisse les trouver. Mieux encore, il pourra écrire lui-même un
convertisseur web spécialisé qu'il mettra à disposition de tous (à ma
connaissance, c'est ce que fait par exemple l'équipe de la base Isidore,
mentionnée plus haut).

## Problèmes, explications et issues de secours

Plusieurs problèmes d'import peuvent donc survenir.

**Dans le premier cas**, le plus commun, la référence est incomplète ou
erronée car l'import est effectué par le convertisseur web générique.
Dans ce cas, vous vous heurtez aux limites d'un programme généraliste
face à un cas particulier.

- Explication : si le convertisseur web générique s'est ici déclenché,
  c'est qu'il n'existait pas de convertisseur web spécifique associé à
  ce site web. Or, cette page n'est pas pleinement lisible pour le
  convertisseur générique.
- Issue n° 1: certains sites (par exemple
  [Persée](http://www.persee.fr){target="_blank"
  rel="noopener noreferrer"}) proposent des références prêtes à importer
  sous la forme de fichiers `.bib` ou `.ris` (voire des liens
  spécifiques d'import pour les applications *Endnote* ou *Refworks*).
  Ces ressources permettent un import manuel. La procédure est moins
  directe, mais c'est toujours mieux que de renseigner chaque champ à la
  main. Notez que Zotero propose ici une fonction
  `Importer depuis le presse-papier` qui rend l'import manuel très
  simple.
- Issue n° 2 : il faudrait idéalement vous doter d'un convertisseur
  spécifique. Ici, deux options possibles. Soit vous demandez
  (gentiment) sur le forum Zotero si quelqu'un aurait l'amabilité de se
  pencher sur la question, puis vous vous armez de patience. Soit vous
  le faites vous-même si vous avez des compétences en javascript ([le
  mode d'emploi est
  ici](https://www.zotero.org/support/dev/translators){target="_blank"
  rel="noopener noreferrer"}).

**Dans le second cas**, la référence est incomplète alors même que vous
avez sélectionné un convertisseur spécifique. Dans ce cas, vous vous
heurtez à une dure loi d'internet : l'évolution incessante de la
structure des sites web.

- Explication : le convertisseur web ne reconnaît pas pleinement la page
  affichée, car celle-ci a vu son code changer depuis la dernière mise à
  jour du convertisseur. Celui-ci ne sait donc plus où chercher les
  informations nécessaires. C'est précisément ce qui m'est arrivé il y
  quelques jours : le convertisseur web spécifique au site du Monde
  savait importer une référence depuis une page standard du journal,
  mais ne savait pas le faire depuis une page réservée aux abonnés.
- Issue : d'abord, il faut vérifier que vous n'êtes pas le seul à
  rencontrer ce problème (ce [site de test
  automatique](https://zotero-translator-tests.s3.amazonaws.com/index.html){target="_blank"
  rel="noopener noreferrer"} de tous les convertisseurs Zotero peut
  aider), et informer du problème l'auteur du convertisseur. Pour cela,
  le plus direct est de déposer un rapport de bug sur [cette
  page](https://github.com/zotero/translators/issues){target="_blank"
  rel="noopener noreferrer"}, en mentionnant le nom du convertisseur
  incriminé (la liste est sur [cette
  page](https://github.com/zotero/translators){target="_blank"
  rel="noopener noreferrer"}), et en ajoutant des captures d'écran. Si
  cette dernière opération vous semble inatteignable, signalez au moins
  le problème sur le forum Zotero.

**Dans tous les cas**, il est judicieux de vérifier que votre version de
Zotero est à jour, ainsi que le module Zotero Connector de votre
navigateur. Les convertisseurs web sont en effet mis à jour très
régulièrement, il est donc très possible qu'un retard de mise à jour ne
vous donne pas accès aux derniers ajustements. Vous pouvez aussi
utiliser le bouton `Update Translators` pour mettre à jour la liste de
convertisseur installée chez vous et ainsi profiter des dernières
corrections. Pour le trouver, rendez-vous dans les préférences de
l'application Zotero (onglet "générales") **et** dans celles du module
Zotero Connector de votre navigateur (onglet "Advanced").

<table style="width: 100%">
<colgroup>
<col style="width: 50%" />
<col style="width: 50%" />
</colgroup>
<tbody>
<tr class="odd">
<td style="text-align: center; width: 50%;"><div id="attachment_1640"
class="wp-caption aligncenter" style="width: 244px">
<a
href="http://zotero.hypotheses.org/files/2018/01/maj_convertisseurs.png"><img
src="http://zotero.hypotheses.org/files/2018/01/maj_convertisseurs-300x256.png"
class="wp-image-1640" aria-describedby="caption-attachment-1640"
decoding="async" loading="lazy"
srcset="https://zotero.hypotheses.org/files/2018/01/maj_convertisseurs-300x256.png 300w, https://zotero.hypotheses.org/files/2018/01/maj_convertisseurs-768x655.png 768w, https://zotero.hypotheses.org/files/2018/01/maj_convertisseurs.png 818w"
sizes="(max-width: 234px) 100vw, 234px" width="234" height="200" /></a>
<p>Mettre à jour les convertisseurs dans l’application.</p>
</div></td>
<td style="text-align: center; width: 50%;"><div id="attachment_1649"
class="wp-caption aligncenter" style="width: 244px">
<a
href="http://zotero.hypotheses.org/files/2018/01/maj_convertisseur_connector_small.png"><img
src="http://zotero.hypotheses.org/files/2018/01/maj_convertisseur_connector_small-300x246.png"
class="wp-image-1649" aria-describedby="caption-attachment-1649"
decoding="async" loading="lazy"
srcset="https://zotero.hypotheses.org/files/2018/01/maj_convertisseur_connector_small-300x246.png 300w, https://zotero.hypotheses.org/files/2018/01/maj_convertisseur_connector_small-768x630.png 768w, https://zotero.hypotheses.org/files/2018/01/maj_convertisseur_connector_small-1024x840.png 1024w, https://zotero.hypotheses.org/files/2018/01/maj_convertisseur_connector_small.png 1380w"
sizes="(max-width: 234px) 100vw, 234px" width="234" height="192" /></a>
<p>Mettre à jour les convertisseurs dans le connecteur.</p>
</div></td>
</tr>
</tbody>
</table>

## Notes pour les aventuriers

Voici quelques recommandations à suivre si jamais il vous prend l'envie
de bidouiller les convertisseurs web de votre dossier Zotero pour tenter
de vous en sortir seul (quitte à signaler ensuite au monde entier votre
succès) :

- Prenez évidemment garde à préserver une copie intacte du convertisseur
  que vous modifiez.
- Pour tester vos modifications, au fur et à mesure, vous pouvez vous
  appuyer sur le programme
  [Scaffold](https://www.zotero.org/support/dev/translators/scaffold){target="_blank"
  rel="noopener noreferrer"} développé par l'équipe Zotero, précisément
  pour faciliter la création de convertisseurs. Celui-ci est compatible
  avec Zotero 5 depuis peu, mais nécessite pour l'instant de
  [recompiler](https://fr.wikipedia.org/wiki/Compilateur){target="_blank"
  rel="noopener noreferrer"} Zotero pour y avoir accès (utilisateurs
  avancés).
- Pour que vos modifications soient prises en compte par Zotero, une
  fois que vous avez obtenu une solution satisfaisante, n'oubliez pas :
  - de désactiver et réactiver l'extension Zotero Connector de votre
    navigateur,
  - de fermer toutes les sessions Zotero et de les relancer,
  - et éventuellement de réinitialiser les convertisseurs, afin
    d'obliger Zotero à parcourir à nouveau tous les fichiers du
    répertoire `translators`. Pour trouver le bouton
    `Reset Translators`, rendez-vous dans les préférences de
    l'application Zotero (onglet "générales") **et** celles du module
    Zotero Connector de votre navigateur (onglet "Advanced").

Et vous, avez-vous déjà corrigé un convertisseur web ? Avez-vous des
astuces à partager ?


<em>
 Billet rédigé par
</em>
✏️
<em>
 Jonathan Chibois
</em>
« Public Works Department Employees Inspect the Exhaust System for Visible Leaks at an Auto Emission Inspection Station in Norwood, Ohio… » (The U.S. National Archives, août 1975, domaine public)  J’ai eu récemment l’occasion de répondre sur Twitter à une interrogation concernant le résultat étrange de l’import d’une référence via le site Isidore dans Zotero.

Publicaciones de Rogue Scholar

Quand le convertisseur web ne convertit plus…