Ressources numériques en sciences humaines et sociales OpenEdition Nos plateformes OpenEdition Books OpenEdition Journals Hypothèses Calenda Bibliothèques OpenEdition Freemium Suivez-nous

Tropy : le retour, ou comment convertir ses données photographiques en références bibliographiques dans Zotero

Depuis 2021, la BULAC organise des ateliers de formation au logiciel Tropy. Pour répondre à des besoins régulièrement exprimés depuis et pallier certaines lacunes constatées dans la documentation officielle ou dans le forum en anglais, ce billet détaille une marche à suivre pour convertir ses métadonnées Tropy en données bibliographiques citables. Artisanal, mais efficace !

Estampe japonaise représentant des acteurs de kabuki (consultable sur la BiNA, p. 22)

Quatre années ont passé, l’eau a coulé sous les ponts… et Tropy, petit outil de traitement aux atours faussement modestes, très pratique mais souvent capricieux et déroutant, a globalement peu changé (à ce jour, il s’agit de la version 1.16.2). L’interface est assez similaire, les fonctionnalités de base sont les mêmes. Signalons tout de même une avancée notable : la possibilité de créer des projets « portables », en cochant simplement l’option adéquate (« Relative to the project file ») dans les paramètres. Cela fait, les données photographiques et les métadonnées peuvent être stockées dans un répertoire « valise », transportable à l’envi vers une clef USB, un disque dur externe ou vers un serveur distant (cloud), ce qui permet de les récupérer à partir de n’importe quel poste1. Moyennant parfois quelques clics de « regroupement de photographies »2 sur certains répertoires d’images, l’opération fonctionne désormais de façon satisfaisante, et la portabilité des projets Tropy est désormais pleinement abordée dans les ateliers proposés à la BULAC.

Mais revenons à l’objet principal de ce billet : offrir aux utilisateurs un tutoriel simple à suivre, raisonnablement explicatif et techniquement robuste pour citer les données photographiques de Tropy sous forme de références dans Zotero, en dépit des particularités formelles des objets sur lesquels ils travaillent. Pour l’heure, cette conversion n’est ni automatique ni, il faut bien le dire, très intuitive, mais sa mise en œuvre est tout de même assez facile si l’on parcourt scrupuleusement chacune des étapes suivantes. C’est parti !

Si Tropy n’est pas directement interopérable avec Zotero, c’est que l’un permet théoriquement d’employer une multiplicité de métadonnées, alors même que l’autre ne reconnaît parmi celles-ci qu’une vingtaine de propriétés, et qui devront même parfois avoir des valeurs par défaut ou des labels (c’est-à-dire des dénominations) spécifiques pour être reconnues par un logiciel de gestion bibliographique. Dit simplement, aucun modèle fourni avec Tropy (Generic, Correspondance et Dublin Core) ne permet à ce jour de citer ses objets dans Zotero.

Il faut donc dans un premier temps recourir à des schémas de métadonnées ad hoc qui prennent en compte cette difficulté : ceux-ci devront en quelque sorte être conçus pour « faire un pont » entre les champs habituellement utilisés dans le Dublin Core et les propriétés correspondantes dans un fichier de données bibliographiques. Pour cet usage, Anne Bugner, bibliothécaire référente pour la gestion et l’analyse des données à la BULAC, a gracieusement créé quatre modèles dérivés du Dublin Core, et susceptibles de décrire à peu près n’importe quelle donnée photographique possiblement présente dans Tropy (Livre, Illustration, Carte, Film)3.

Pour les lecteurs de ce billet, la première étape consistera donc simplement à télécharger ces schémas prêts-à-l’emploi (il s’agit de fichiers .ttp), puis à les importer dans leur interface Tropy (se rendre dans Édition > Préférences > Modèles de saisie. La capture d’écran ci-dessous rappelle comment procéder).

Import d’un modèle de métadonnée sur Tropy
Bon à savoir
L’import d’un modèle de saisie sous la forme d’un fichier .ttp ne vaut pas sauvegarde de celui-ci dans un projet Tropy. Si l’utilisateur change de poste de travail, il devra toujours réinstaller localement ces schémas de métadonnées (même si ceux-ci ont été utilisés dans des projets portables), de la même manière qu’il devra répéter l’ensemble des étapes ci-dessous s’il souhaite exporter vers Zotero à partir d’un autre poste que celui qu’il utilise habituellement.

Geany est un logiciel libre d’édition de texte, compatible avec tous les systèmes d’exploitation (Windows, MacOS, Linux) et très facile à installer (il est d’ailleurs présent sur tous les postes de la BULAC). Il peut être utilisé pour traiter des données enregistrées dans des formats très divers (XML, JSON, CSV, YAML…). Pour les geeks chevronnés et autres développeurs en herbe, il va même servir d’éditeur de code dans les langages de programmation les plus courants (Python, C, Java, Javascript, PHP, etc). Et pour nous autres néophytes, si facilement désarmés face à ces virages technologiques qui jalonnent désormais notre existence ?

Pas de panique !

Geany va uniquement servir à créer un fichier vierge en .json (javascript object notation), c’est-à-dire dans un standard conçu pour l’échange de données textuelles entre des applications distinctes, comme le sont Tropy et Zotero. Concrètement, il suffit simplement d’ouvrir Geany une fois que celui-ci est installé : aller dans Fichier > Nouveau > Enregistrer sous, puis nommer le nouveau fichier à enregistrer en spécifiant son format (ce qui pourrait donner par exemple Manuscrit Tropy Zotero.json). Avec ce fichier, on aura un contenant qui servira si l’on veut de réceptacle pour les métadonnées de Tropy, et qui pourra être ensuite importé sans difficultés dans une bibliothèque Zotero (voir cinquième étape).

Bon à savoir
On peut normalement enregistrer un fichier .json depuis n’importe quel éditeur de texte brut autre que Geany, pourvu qu’on indique son extension. D’autres applications possibles sont Notepad++ (souvent installé par défaut avec Windows) ou encore Gedit (pour Linux).

Après la création du contenant se pose la question du contenu, et c’est là qu’il devient nécessaire de s’appuyer sur l’extension CSL-JSON. Cette extension va convertir les métadonnées de Tropy en un format textuel adapté à la description de données bibliographiques, le citation style language. Son installation est elle aussi parfaitement simple. Il suffit de télécharger sur son disque dur le fichier .zip depuis la page github dédiée.

Page de téléchargement Github de l’extension CSL-JSON

Vous pouvez ensuite ouvrir Tropy, puis vous rendre dans Édition > Préférences > Plugins et appuyer sur le bouton « Installer un plug-in » pour sélectionner le .zip tout juste téléchargé (sans le dézipper).

Une fois le plugin installé, vous devrez encore opérer quelques paramétrages pour l’activer.

Nulle crainte à avoir, cette ultime épreuve est à votre portée !

Appuyez sur le bouton « Paramètres » associé à l’extension nouvellement installée. La fenêtre se déplie, un bloc duplicable et composé de trois champs apparaît : le titre, l’emplacement de sauvegarde des données converties (Save as), le modèle de métadonnées (Template) selon lequel ces données seront structurées. Le paramétrage de l’extension va consister à compléter ces trois informations.

Paramétrage de l’extension CSL-JSON dans Tropy

1) Dans le champ « Titre », on peut indiquer librement le nom que l’on souhaite donner à l’opération de conversion. Dans l’exemple ci-dessus, on a choisi le titre « Manuscrit Tropy vers Zotero », qui est suffisamment explicite de l’usage que l’on va faire de l’extension : il s’agira de convertir les objets Tropy correspondant à des textes (manuscrits, mais aussi archives, etc.). Cette indication apparaîtra dans le menu contextuel lorsqu’on fera un clic droit sur un objet Tropy dont on voudra exporter les métadonnées en CSL-JSON (voir cinquième étape).

2) Pour le champ de l’emplacement « Save as », il faudra indiquer le chemin vers le fichier qui recevra les métadonnées de Tropy : ici, on va donc préciser l’emplacement du fichier « réceptacle » créé lors de la deuxième étape. À chaque nouveau transfert de métadonnées d’un objet Tropy vers ce fichier, les nouvelles métadonnées converties écraseront forcément les précédentes. Il est également possible, en cochant la ligne Copy to clipboard, d’activer la copie automatique des données à exporter dans le presse-papier (voir illustration ci-dessus).

3) Pour le champ du modèle de métadonnées (« Template »), on peut choisir dans le menu déroulant le modèle en fonction duquel les données en CSL-JSON seront structurées. À cette étape-là, il faut bien entendu nécessairement choisir l’un des quatre modèles de métadonnées installés lors de la première étape, ou tout autre modèle ad hoc. Par exemple, pour des objets textuels, on choisira ici le modèle Dublin Core pour Livre.

Bon à savoir
On devra répéter ce paramétrage pour chacun des quatre schémas de métadonnées fournis (Livre, Illustration, Carte, Film), en ajoutant un bloc à l’aide du + visible à la droite de la fenêtre. On peut d’ailleurs aussi choisir de créer un fichier en .json (étape 2) pour chacun de ces blocs, afin d’avoir un emplacement d’enregistrement propre à chaque schéma (et donc à chaque type d’objet).

Courage, vous y êtes presque !

Bravo ! Vous êtes un vrai guerrier, qui avez réalisé avec brio toutes les opérations les plus contre-intuitives. Vous pouvez désormais tranquillement vous rendre dans votre projet Tropy et choisir les objets à citer avec Zotero (objets qui, rappelons-le, devront forcément être décrits dans un des quatre schéma de métadonnées fournis à l’étape 1 – ou tout autre modèle conçu pour cet usage).

1) Sélectionner un ou plusieurs objets à l’aide de la souris (éventuellement la touche CTRL / CMD). Les objets choisis simultanément devront nécessairement être décrits selon le même schéma.

2) Faire un clic-droit, choisir la ligne « Exporter l’objet », puis choisir la modalité d’export correspondant au schéma des objets dont on veut exporter les métadonnées. Exemple : pour exporter des objets textuels, on va sélectionner la ligne « Manuscrit Tropy vers Zotero », pour les objets visuels, on va sélectionner la ligne « Illustration Tropy vers Zotero » (voir capture ci-dessous), et ainsi de suite.

Le menu contextuel d’un objet pour en exporter les métadonnées en CSL-JSON. La ligne d’export choisie (en rouge) doit correspondre au modèle de métadonnées de l’objet (en violet).

3) À ce stade là, il ne se passe souvent rien de visible, et cela peut paraître surprenant quoique parfaitement normal : d’une part le comportement de Tropy peut varier d’un système d’exploitation à l’autre, d’autre part on a déjà indiqué à Tropy le chemin vers le fichier en .json lorsque on a paramétré l’extension (quatrième étape). Il faut donc généralement aller ouvrir ce fichier pour constater que les métadonnées exportées y ont été déversées… en toute discrétion (voir exemple ci-dessous) !

Dans d’autres cas de figure, une fenêtre de dialogue peut s’ouvrir, et il faudra alors à nouveau attribuer un nom en .json et un emplacement au fichier où sont transférées les données converties. Dans les deux cas, cette étape va finalement juste consister à s’assurer que les métadonnées Tropy ont bien été converties en CSL-JSON et transférées vers le fichier adéquat. 

Bon à savoir
Si l’on a coché l’option Copy to clipboard au moment du paramétrage (quatrième étape), les données exportées ont été automatiquement copiées dans le presse-papier, on peut donc aussi les coller dans le fichier .json.
Les métadonnées d’un objet Tropy converties dans un fichier en .json.

4) Nous touchons au but ! Il ne reste plus qu’à verser le « réceptacle » dans sa bibliothèque Zotero. Ouvrir son Zotero, aller dans Fichier > Importer…, puis sélectionner le fichier .json.

Mission accomplie. Les métadonnées issues de votre projet ont été importées dans Zotero, elles apparaîtront dans une collection qui portera le nom du fichier. Une fois vos données converties en références dans Zotero, on peut réaliser sans problèmes d’autres opérations d’export à partir d’autres objets Tropy vers ce même fichier : les données exportées les plus récemment écraseront les précédentes… mais les références importées dans Zotero, elles, demeurent…


  1. Pour rappel, les bonnes pratiques en matière de stockage des données recommande la méthode du 3 2 1 : 3 copies sur 2 supports différents et au moins et 1 copie à distance. ↩︎
  2. Attention : ne pas confondre « regroupement de photographies » (indiquer à Tropy le chemin entre les métadonnées et le fichier photographique correspondant) et « fusion de photographies » (fusion de plusieurs clichés sous la forme d’une unité documentaire appelée « objet »). ↩︎
  3. Ces quatre modèles de saisie comportent notamment des valeurs par défaut dans le champ « type » (qui renvoie au type de document), valeurs qui sont attendues par Zotero : book, map, graphic, motion picture. Dans ce contexte, le modèle de saisie Dublin Core pour Livre (book) a vocation à être utilisé pour tous les objets textuels, y compris les manuscrits et les archives (qu’il va être capable de décrire de manière riche). Le modèle Dublin Core pour Illustration (graphic) pourra être utilisé pour toutes sortes d’artefacts visuels, y compris par exemple des objets archéologiques ou architecturaux. ↩︎

OpenEdition vous propose de citer ce billet de la manière suivante :
Aladin Larguèche (18 septembre 2025). Tropy : le retour, ou comment convertir ses données photographiques en références bibliographiques dans Zotero. Le Carreau de la BULAC. Consulté le 6 février 2026 à l’adresse https://doi.org/10.58079/14pdk


Vous aimerez aussi...

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

This site uses Akismet to reduce spam. Learn how your comment data is processed.