Le plugin ZotSpip

Note de version

À partir de la version 3 du plugin, le paramètre type des modèles a été renommé en type_ref. De même, pour trier par type de référence, on utilisera désormais tri=type_ref.

Présentation de Zotero

Zotero (https://www.zotero.org) est un logiciel libre de gestion de références bibliographiques. Il se présente sous la forme :

• d’une extension au navigateur Firefox ;
• d’une application autonome ;
• d’un site web où il est possible de consulter / modifier ses références.

Zotero permet notamment d’importer et d’exporter très facilement des références bibliographiques, dans la plupart des formats bibliographiques courant (BibTeX, RIS, RDF...) mais également depuis la plupart des catalogues bibliographiques.

Pour une liste de ressources en ligne sur Zotero, voir notamment http://joseph.larmarange.net/?Zoter....

Par ailleurs, Zotero permet de synchroniser vos références entre les applications Zotero et le serveur Zotero. Cela permet de :

• synchroniser vos références entre différents ordinateurs ;
• consulter / modifier vos références depuis le site www.zotero.org ;
• créer des librairies collaboratives partagées entre plusieurs utilisateurs ;
• pouvoir accéder à vos librairies via l’API Zotero avec des applications tierces, dont ZotSpip.

Présentation de ZotSpip

ZotSpip utilise l’API de Zotero pour synchroniser une librairie de références bibliographiques avec le serveur de Zotero. Dès lors, il est possible d’utiliser la puissance des applications Zotero (extension Firefox et/ou application autonome) pour gérer sa base bibliographique et profiter de leurs puissants outils d’importation tout en retrouvant ses références dans Zotero.

ZotSpip fournit toute une série de modèles pour afficher des listes de références mises en forme dans vos articles et propose par ailleurs une page publique (désactivable) permettant d’effectuer des recherches dans la base bibliographique. Pour une démonstration, voir http://www.ceped.org/biblio/.

Il est également possible d’utiliser ZotSpip pour insérer des références au fur-et-à-mesure d’un texte (rédaction scientifique).

ZotSpip s’appuie sur la librairie citeproc.php, développée par Ron Jerome, utilisant les styles CSL pour mettre en forme les références. Des milliers de styles sont directement utilisables avec ZotSpip.

S’appuyant sur l’API Zotero, les références sont dès lors exportables dans tous les formats pris en charge par Zotero, à savoir :

• BibTeX
• MODS
• Refer/BibIX
• Bibliographic Ontology RDF
• Unqualified Dublin Core RDF
• Zotero RDF
• RIS (EndNote)
• Wikipedia Citation Templates

ZotSpip implémente une unAPI permettant à des applications tierces de récupérer automatiquement les références affichées. Ainsi, un visiteur de votre site utilisant lui-même Zotero pourra importer les références affichées en un clic de souris.

Enfin, ZotSpip est même livré avec quelques petits outils bien pratiques comme la fusion de deux auteurs ou de deux mots-clés (pratique pour corriger les doublons dus à une mauvaise orthographie).

Pré-requis et installation

Dépendances :

• SPIP 2.1 ou SPIP 3.0
• plugin Saisies
• plugin SPIP-Bonux (pour la version 1 pour SPIP 2.1 uniquement)
• plugin jQueryUI (pour la version 1 pour SPIP 2.1 uniquement)

PHP :

• le module openSSL doit être activé pour pouvoir communiquer avec le serveur Zotero.
• les modules DOM et SimpleXML sont nécessaires au fonctionnement de CiteProc.php.

Recommandé :

• plugin Insérer Modèles

Configurer ZotSpip

La page de configuration de ZotSpip est accessible via le menu Configuration dans le bandeau supérieur.

Vous devez en premier lieu renseigner les éléments nécessaires pour que ZotSpip soit capable de se connecter au serveur Zotero :

• indiquez en premier lieu si vous souhaitez synchroniser votre librairie personnelle (type utilisateur) ou bien une librairie partagée (type groupe) ;
• l’identifiant numérique de la librairie (pour une librairie personnelle, il s’agit du userID indiqué sur la page Feeds/API dans la configuration de votre compte sur le serveur Zotero ; pour une librairie partagée, le groupID se déduit de l’URL de la page de configuration du groupe qui est de la forme https://www.zotero.org/groups/<groupID>/settings ;
• le nom alphanumérique de la librairie (pour une librairie personnelle, il s’agit du username indiqué sur la page Account de configuration du compte ; pour un groupe partagé, le nom du groupe se situe à la fin de l’URL de la page d’accueil du groupe qui est de la forme https://www.zotero.org/groups/<nom_du_groupe> (dans certain cas, le nom du groupe correspondant à son identifiant numérique).
• une clé API (ou API key) avec les droits de lecture sur la librairie à synchroniser (Cette clé API est à créer sur la page Feeds/API dans la configuration de votre compte sur le serveur Zotero. Si vous souhaitez pouvoir utiliser les outils de fusion d’auteurs et/ou de mots-clés, vous devez également accorder des droits en écriture à cette clé).

Les autres de configuration vous permettent, entre autres, de :

• spécifier le style CSL à utiliser par défaut pour la mise en forme des références (voir plus loin) ;
• d’activer la page Z biblio et de personnaliser son titre (voir ci-après) ;
• de spécifier les personnes autorisées à effectuer des modifications [1] sur la base Zotero (fusion d’auteurs et/ou de mots-clés par exemple) ;
• d’améliorer la prise en compte des dates par le processeur CSL (citeproc.php) [2] ;
• préciser l’ordre à utiliser pour les tris par types de références (permet par exemple de trier les types de références selon leur importance académique).

À propos de la synchronisation avec le serveur Zotero

ZotSpip se synchronise à intervalles réguliers (environ toutes les 4 heures) avec le serveur Zotero. Seules les dernières modifications (depuis la dernière synchronisation) sont prises en compte. Dès lors, lorsque vous effectuez une modification dans votre librairie depuis le serveur Zotero, il y aura un délai avant que cette modification soit prise en compte sur votre SPIP. De même, si vous effectuez des modifications depuis une application Zotero, il faudra d’abord que l’application se synchronise avec le serveur Zotero puis que ZotSpip fasse sa synchronisation.

Vous pouvez provoquer une synchronisation de la base bibliographiques depuis le formulaire prévu à cet effet sur la page de configuration de ZotSpip ou sur la page de l’espace privé permettant de rechercher des références dans la base.

Au besoin, vous pouvez également forcer une mise à jour complète de la base de données, toutes les références étant alors téléchargées à nouveau (si votre librairie est importante, cette synchronisation se fera en plusieurs étapes, seulement 50 références pouvant être mises à jour à la fois).

Styles CSL

ZotSpip s’appuie sur la librairie citeproc.php, développée par Ron Jerome, utilisant les styles CSL pour mettre en forme les références.

Ainsi, ZotSpip peut utiliser l’un des milliers de styles CSL déjà disponibles sur le web ou vous pouvez également créer votre propre style.

Si vous souhaitez installer d’autres styles que ceux livrés avec ZotSpip, il vous suffit de copier les fichiers CSL correspondant dans le répertoire squelettes/csl.

D’autres plugins peuvent également embarquer des styles CSL. Il suffit que ces derniers soient placés dans un répertoire csl à la racine du plugin.

Les modèles <biblio>

ZotSpip fournit une série de modèles <biblio> permettant d’afficher une liste de références bibliographiques, déclinés en plusieurs variantes :

• <biblio> est le modèle de base et affiche les références sous forme d’une liste dont les icônes correspondent au type de document, avec possibilité d’afficher les détails de chaque référence et des options d’export, et une pagination si plus de 50 références [3] ;
• <biblio|simple> est une présentation allégée : une référence par paragraphe, sans icône, sans options d’export, sans pagination ;
• <biblio|annee> présente les références par année (des plus récentes au plus aniennes), avec des intertitres pour chaque changement d’année ;
• <biblio|type> présente les références par type (article, libre, chapitres, etc.), avec intertitres ;
• <biblio|annee_type> présente les références par année puis par type, avec intertitres ;
• <biblio|type_annee> présente les références par type puis par année, avec intertitres ;
• <biblio|premier_auteur> présente les références classées par premier auteur, avec intertitres ;
• <biblio|recente>, utile pour des fiches individuelles dans le cadre du site d’une unité de recherche, présente les dernières publications (année en cours + deux dernières années) et, s’il s’agit des publications d’un auteur précis, ajoute un lien vers la liste complète des publications de cet auteur (à condition que la page ’biblio’ ait été activée dans la configuration de ZotSpip).

Les paramètres disponibles sont nombreux. L’utilisation du plugin Insérer Modèles est dès lors fortement recommandée pour disposer d’une aide à l’insertion des modèles.

La page biblio

Si vous utilisez Zpip et si vous avez activé la page ’biblio’ dans la configuration de ZotSpip, les visiteurs de votre site pourront effectuer des recherche dans votre librairie Zotero à l’adresse http://mon.site.net/spip.php?page=biblio. Pensez à ajouter un lien dans vos menus !

Si vous utilisez un autre squelette, vous pouvez vous inspirer de ou bien inclure les squelettes contenu/page-biblio.html et navigation/page-biblio.html du plugin pour proposer la même fonctionnalité.

Insérer des références dans un texte

ZotSpip introduit un nouveau raccourci [ref=XXX] pour insérer un appel à une référence bibliographique dans votre texte. Une note de base de page sera automatiquement créée avec la référence mise en forme selon le style par défaut défini dans la configuration de ZotSpip.

XXX correspond à l’identifiant Zotero de la référence que vous souhaitez ajouter. Cet identifiant est composé de 8 caractères alphanumériques (chiffres ou majuscules, par exemple : 6JRC9CPD). Cet identifiant est visible dans les pages de l’espace privé permettant de rechercher dans la librairie Zotero (menu Édition > Références Zotero).

Il est possible de préciser plusieurs références à insérer dans la même note, en les séparant par des virgules, par exemple [ref=6JRC9CPD,5323SDXE,JDRXW9FG].

Lorsque l’on cite l’extrait d’un article ou d’un ouvrage, il est important de préciser d’où cette citation est extraite (page, chapitre ou section...). Cette information peut être précisée en faisant suivre l’identifiant de la référence par le caractère @ et l’indication de localisation dans l’ouvrage. Exemples : [ref=6JRC9CPD@page 63] ou encore [ref=6JRC9CPD@page 63,5323SDXE@chapitre 19,JDRXW9FG].

L’icône

dans le porte-plume permet de saisir facilement un appel de référence.

Bonus

Dans l’espace privé, via le menu Édition > Références Zotero, vous avez accès à une page vous permettant d’effectuer des recherches avancées parmi vos références Zotero.

Sont également disponibles la liste des contributeurs et la liste des mots-clés, qui peuvent être utiles pour identifier les éventuels doublons.

Compléments

Pour offrir une interface de vérification des publications couplée au plugin tickets, voir le plugin Biblio Check.

Les Unités de Recherche gérant leur publications avec Zotero pourront être intéressées par le plugin complémentaire Bibliographie AERES.

Pour les développeurs

Le plugin embarque un squelette inclure/inc-form_item_zotero.html produisant un formulaire pour saisir une référence selon le schéma de base de données de Zotero (schéma que le plugin synchronise à intervalles réguliers pour prendre en compte les changements éventuels). Un exemple d’utilisation est visible dans le plugin Biblio Check.

Compatibilité avec le kit CNRS

Un plugin zotspip4cnrs est disponivle sur GitHub afin de faire fonctionner les plugins ZotSPIP, BiblioCheck et Bibliographie AERES avec le kit CNRS.