Proposer à ses lecteurs une extension OpenURL Referrer préparamétrée

Tout l’intérêt de l’OpenURL, c’est d’afficher les rebonds depuis n’importe quel site proposant des métadonnées bibliographiques vers le catalogue de ma bibliothèque.

Problème : cela implique (en tout cas pour le moment) que vos lecteurs installent sur leurs navigateurs l’extension OpenURL Referrer, dont j’ai déjà parlé, qui transforme les COinS en URL cliquables. Il faut donc leur indiquer le site, leur demander de télécharger l’extention, et leur expliquer comment paramétrer les valeurs à y mettre (essentiellement URL du résolveur, et sa version). On risque de perdre plus de la moitié du lectorat visé par ces consignes.

La meilleure solution est donc de proposer, sur le site de la bibliothèque, l’extension préparamétrée. Cela permet d’esquiver complètement la notion d’OpenURL (amusez-vous à la leur expliquer si vous vous en sentez le courage), et de leur proposer « simplement » : une extension qui permet de rebondir depuis une référence d’ouvrage trouvée sur Internet vers le catalogue de sa bibliothèque, pour voir rapidement si elle le propose ou non.

Quelques explications préalables sont nécessaires.

Qu’est-ce qu’une extension Firefox ?

Sur Internet, vous trouvez ces extensions sous la forme de fichiers XPI. Il s’agit en fait de fichiers ZIP. Lorsque vous cliquez dessus, Firefox les reconnaît comme des ZIP, et les décompresse dans le répertoire contenant tous les paramètres de votre profil d’utilisateur.

Sous Windows, ce répertoire est dans : C:\Documents and Settings\::nom_d_utilisateur::\Application Data\Mozilla\Firefox\Profiles\::nom_du_profil::\extensions

Si vous avez déjà installé OpenURL Referrer, vous retrouverez tous les fichiers décompressés dans le répertoire {6949DC66-E5E4-4bf0-B364-84F23ED81319}, sous « extensions ».

Donc pour modifier les paramètres par défaut de l’extension, il vous faut

1. télécharger le fichier XPI au lieu de l’installer sur Firefox (donc aller sur le site d’Openly, et faire un clic gauche « Enregistrer la cible du lien sous… »
2. dézipper le fichier (changer l’extension .XPI en .ZIP si nécessaire)
3. modifier les fichiers (XML) nécessaires pour que les paramètres par défaut soient différents
4. rezipper tous les fichiers, remettre une extension .XPI au ZIP obtenu
5. charger le fichier XPI sur un serveur
6. pointer vers ce fichier depuis une page du site de la bibliothèque, vantant les mérites de cette extension

Le plus difficile évidemment, c’est l’étape 3. Je vais essayer d’être le plus clair possible, car il me semble que le XML fait peur à certains.

Vidéo 1 : enregistrer le fichier XPI et le dézipper. (étapes 1 et 2)

Modifier les paramètres par défaut (étape 3)

Une fois les fichiers dézippés, vous obtenez un fichier install.rdf et 3 répertoires

Celui qui nous intéresse, c’est le répertoire Chrome.

Il contient un fichier openurlref.jar. Pas de bol, c’est encore un fichier ZIP qui ne dit pas son nom : il faut donc dezipper celui-là aussi.

Cela produit 3 nouveaux répertoires, dont un qui s’appelle content. Dans content, il y a un répertoire openurlref, qui contient un fichier profiles.rdf. C’est celui-là !

Avec tous les dézippages successifs, ce fichier st donc dans chrome\content\openurlref\profiles.rdf.

Vidéo 2 : trouver le fichier profiles.rdf

Remarque : vous noterez qu’après avoir dézippé openurlref.jar et obtenu mes trois répertoires, j’ai supprimé le fichier openurlref.jar. En effet lorsque j’aurai modifié profiles.rdf, les trois répertoires content, META-INF et skin devront être rezippés en un seul fichier qu’il faudra rebaptiser openurlref.jar. Donc l’ancien ne sert plus à rien.

Avant d’ouvrir le fichier profiles.rdf, munissez-vous (si vous avez un résolveur) de :

• l’URL du résolveur. Moi, je prendrai : http://jubil.upmc.fr/openurl
• l’URL de l’image qui va être cliquable chaque fois qu’il y aura des COinS
• ou, si vous ne voulez ou n’avez pas d’image, réfléchissez au texte que vous souhaitez voir apparaître. Par exemple : « Trouver dans ma BU »
  (songez que ces liens sont faits pour apparaître depuis n’importe quel site sur Internet. Le texte ou l’image doit donc faire comprendre que l’internaute va basculer sur le site de sa bibliothèque.)

Le fichier profiles.rdf

C’est un fichier XML, donc, structuré assez simplement.

• La balise racine est : <RDF:RDF>. On ne s’en occupe pas.
• La balise <RDF:Seq> contient une série de <RDF:li> qui liste l’ensemble des profils disponibles. Ces profils sont désigné par un nom. Cela ressemble à : <RDF:li RDF:resource= »profiles:1cate Demo »/>
  A cet endroit, je vais rajouter une ligne sur le modèle ci-dessus, qui va donc être :
  <RDF:li RDF:resource= »profiles:Jubil »/>
  Evidemment, il me faut alors créer ensuite un profil ayant pour identifiant Jubil.
• Une série de balises <RDF:Description>. Ces balises contiennent un certain nombre d’attributs, qui sont les valeurs du résolveur :
  • son identifiant : attribut RDF:about= »profiles:Jubil »
  • son nom : attribut profiles:name= »Jubil »
    Le nom est celui qui apparaît à l’utilisateur dans la fenêtre de paramétrages.
  • son URL : attribut profiles:lsurl= »http://jubil.upmc.fr/openurl« 
  • sa version : profiles:use1_0= »false »
    Il faut mettre « false » si la version du résolveur est 0.1, et « true » si c’est 1.0.
  • si je veux que ce soit une image qui apparaisse :  profiles:useimg= »true »
  • l’URL de l’image : profiles:imgurl= »http://jubil.upmc.fr/a/slide/files/projects/upmc/doctype/gallerie/gallerie-1150805377211-134.157.146.58.gif« 
  • Le texte alternatif (si l’image n’est pas disponible) — ou le texte tout court si je ne veux pas d’image : profiles:text= »Trouver sur Jubil »

Plutôt que de tout saisir à la main, il vaut mieux évidemment dupliquer un des autres profils et l’adapter.

Vidéo 3 : modifier le fichier profiles.rdf

Remarque : si vous créer un profil avec tous les attributs, mais que vous n’y faites pas référence dans la liste (balise <RDF:li> insérée dans la balise <RDF:Seq>), le profil n’apparaîtra pas. Et il faut le mettre en tête pour que ce soit celui choisi par défaut.

Et une fois installée l’extension, ça donne ceci :

Et après ?

1. Vous remonter au niveau du répertoire chrome, dans lequel se trouve 3 répertoires (content, META-INF et skin).
2. Vous zippez ces trois répertoires en un fichier openurlref.jar
3. Vous remonter au niveau le plus haut (jusqu’à voir 3 répertoires — chrome, defaults, META-INF — et un fichier install.rdf), et vous zippez le tout en un fichier openurlRef_Ma_Bibliotheque.xpi

Remarque : petite subtilité supplémentaire, avant de rezipper toute l’extension, vous pouvez aller dans le répertoire defaults\preferences. Il y a un fichier openurlref.js que vous pouvez ouvrir avec WordPad ou le bloc-notes. Il gère le comportement de l’extension lors de son téléchargement par l’utilisateur. Ainsi, vous y trouverez les lignes :

//This is used to signal the extension to pop up the options pane
//when the browser is restarted after an install
pref("openurlref.firstTime", true);

Si vous mettez false au lieu de true, Firefox ne proposera pas à l’internaute de configurer l’extension après installation. Ce qui serait normal : vous l’avez fait pour lui.

Conclusion

Un peu laborieux, peut-être ? Consolez-vous : vous, vous n’avez pas eu à essayer de comprendre ce fonctionnement en l’absence de documentation. C’était plus pénible encore.

Ce qui est intéressant, c’est que ça permet ainsi à une bibliothèque de proposer sur une page, non pas son résolveur OpenURL, mais un service à l’usager, avec copies d’écrans (de Google Scholar, Wikipedia, Citeseer, etc.) à l’appui. Non pas la description, d’une technique, mais le principe-même « Simplifiez-vous la vie ! »

Remarque : quoique ne l’ayant pas encore vérifié, je suis sûr par avance qu’une telle manipulation n’empêchera pas les mises à jour, une fois que l’utilisateur aura installé l’extension sur son navigateur. En effet l’extension continuera à aller vérifier sur le site d’Openly si une nouvelle version existe ou non.

P.S.

J’ai essayé de faire le plus clair possible. Mais :

• si une étape n’est pas claire du tout
• si ça ne marche pas chez vous

N’hésitez pas à réagir vivement en commentaires.

Il faut préciser aussi que l’installation d’une extension sous Firefox laisse de multiples traces. Il ne vous suffit pas de désinstaller l’extension pour faire comme si elle n’avait jamais été là : donc pour vous assurer que tout fonctionne bien (avant de publier vraiment l’extension sur votre site), testez-là sur un poste qui n’a jamais eu OpenURL Referrer auparavant.

Si tout de même vous voulez (ou devez) testé cette nouvelle extension sur un poste dont Firefox a déjà eu une extension OpenURL Referrer, avec un profil antérieur déjà enregistré, vous pouvez effacer toutes les traces de cette ancienne version de la manière suivante :

1. Désinstallez l’extension sur Firefox et fermez le navigateur
2. Allez dans le répertoire C:\Documents and Settings\::nom_d_utilisateur::\Application Data\Mozilla\Firefox\Profiles\::nom_du_profil::\
3. Supprimez le fichier openurlref_profiles.rdf
4. Ouvrez le fichier prefs.js (avec WordPad) et supprimez toutes les lignes commençant par : user_pref(« openurlref.
5. Allez dans le répertoire extensions et supprimez le répertoire {6949DC66-E5E4-4bf0-B364-84F23ED81319}

Voilà, vous avez effacé toutes les traces d’OpenURL Referrer sur votre poste. Vous pouvez installer la nouvelle extension pour voir si elle fonctionne bien.