Zotero + BetterBibTeX + HAL = BetterBib2HAL ? Quelques astuces pour manier le JavaScript dans BetterBibTeX

Rappels Certains champs obligatoires dans HAL ne peuvent pas être renseignés dans Zotero (ex.: audience d’une revue) L’utilisation de BetterBibTeX, plug-in de Zotero, permet entre autres de : Utiliser le champ Extra de Zotero pour ajouter à une référence des champs supplémentaires → utile pour ajouter des informations qui changent à chaque référence Détourner des champs Zotero (ex.: exporter le champ Archive pour le renommer en champ x-conferencestartdate) → utile pour ajouter des informations qui changent à chaque référence Ajouter un champ avec une valeur fixe à une ou plusieurs références (ex.: ajouter x-audience = {international} à un ensemble d’articles) → utile pour ajouter des informations communes à un grand nombre de références Pour les deux dernières fonctions, il est nécessaire d’ajouter un post- script à BetterBibTeX. Ce post-script est rédigé en JavaScript.

Avertissement Ce modeste tutoriel vise à fournir aux bibliothécaires néophytes quelques trucs et astuces dans le maniement de JavaScript. Il est basé sur des tests menés de manière tout à fait empirique par les bibliothécaires (non-informaticiens…) du SCD de l’Université Paris Nanterre, à partir d’exemples gentiment fournis par Emiliano Heyns, créateur de BetterBibTeX Si vous avez sous la main quelqu’un qui maîtrise JavaScript, mieux vaut lui demander son aide directement ! Si vous remarquez la moindre erreur ou si quelque chose ne fonctionne pas, faites-le nous savoir : collaborons !

Utiliser le champ Extra d’une référence La plus simple manière d’ajouter des informations

Principe BetterBibTeX permet d’ajouter dans le champ Extra d’une référence des champs BibTeX normalement absents d’une notice classique (ex.: audience, niveau de vulgarisation…) Pour cela, il est nécessaire d’ajouter le code suivant : bibtex[champ1=valeur;champ2=valeur etc.] Exemple pour un article de colloque :

Astuces Il s’agit peut-être de la solution la plus simple quand on n’a pas énormément de références à exporter ou qu’on a un peu peur des balises et du code À conseiller aux chercheurs ? Attention toutefois à bien respecter : l’intitulé exact des champs HAL la syntaxe spéciale de certaines valeurs (ex.: codes ISO pour la langue et le pays, dates au format AAAA-MM-JJ etc.) les valeurs restreintes de certains champs (ex.: audience, niveau de vulgarisation etc.)

Détourner des champs de Zotero Compléter, Exporter, Renommer

Principe Certains champs de Zotero sont souvent délaissés car peu utiles : Archive, Loc. dans l’archive, Catalogue de bibliothèque, Cote, Autorisations etc. Ils ne sont d’ailleurs pas pris en compte lors des exports BibTeX classiques Il est possible de : Utiliser ces champs pour saisir des informations indispensables à un export Bib2HAL (ex.: date de début de conférence pour un acte de colloque) Prendre ces champs en compte dans son export Renommer ces champs pour leur donner la valeur souhaitée par Bib2HAL (ex.: x-conferencestartdate)

1) Réattribuer les champs délaissés Avant toute saisie en masse dans Zotero, commencez par réfléchir aux champs que vous souhaitez réassigner Faites-vous un tableau de concordance précis car il ne sera pas possible de changer l’affichage dans Zotero (i.e.: Archive restera Archive dans Zotero, même si BetterBibTex le transforme en x-audience au moment de l’export)

Exemples de tableaux de concordance Le tableau de l’Université de la Réunion Le tableau de l’Université Paris Nanterre

Astuces Privilégiez les informations qui changent d’une référence à l’autre et qu’il ne sera pas possible d’ajouter en gros. Ex.: compte du déposant HAL (x-onbehalfof), date de début de conférence (x-conferencestartdate), adresse de la conférence (x-address ou (x-city + x-country))… Quand ils ne sont pas utilisés, pensez à vérifier que les champs détournés sont vides. Ex.: si vous détournez le champ Cote de Zotero en x- peerreviewing, pensez à le laisser vide dans les références qui n’utilisent pas cette information (comme les livres).

2) Exporter un champ Pour demander l’export d’un champ en particulier, ajouter les 3 lignes de code suivantes dans le post-script BetterBibTeX : if (Translator.BetterBibTeX || Translator.BetterBibLaTeX) { this.add({ Nomduchamp: this.item.nomduchamp }); } Exemple pour demander l’export du champ Archive : Répéter ces 3 lignes autant de fois qu’il y a de champ supplémentaire à exporter.

3) Renommer un champ Pour renommer un champ, ajouter les 3 lignes de code suivantes dans le post-script BetterBibTeX : if (this.has.nomOriginal) { this.has.nomOriginal.name = 'nouveaunom'; } Exemple pour renommer le champ Archive en champ x-onbehalfof (compte du déposant HAL) : Répéter ces 3 lignes autant de fois qu’il y a de champs à renommer.

Ajouter une condition Pour renommer un champ seulement pour certains types de documents, ajouter les lignes de code suivantes dans le post- script BetterBibTeX : if ((this.item.itemType == 'TypedeDoc' && this.has.nomOriginal) { this.has.nomOriginal.name = 'nouveaunom'; } Exemple pour renommer le champ Consulté le en champ x-conferencestartdate uniquement pour un acte de colloque :

Équivalences Zotero-CSL-BibTeX Dans toutes ces lignes JavaScript, il importe de saisir le code BibTeX du champ sur lequel on veut agir Ce code ne reprend pas forcément l’intitulé du champ Zotero, non plus que le code CSL Exemple : le champ Zotero intitulé Collection est appelé collection-title dans un fichier CSL (feuille de style Zotero) mais series dans BibTeX… Il n’existe malheureusement pas de liste complète de ces équivalences (même si on en a un début ici)

Quelques exemples de codes de champs Malgré tout, quelques champs utiles dont l’intitulé ne va pas de soi : Champ Zotero Code BibTeX Loc. dans l’archive archiveLocation Catalogue de bibliothèque libraryCatalog Titre abrégé shorttitle Consulté le urldate Cote lccn Autorisations rights Extra note Intitulé du colloque conferenceName Intitulé de la réunion meetingName Marqueur keyword

Vous avez des questions. Contactez-nous sur admin-hal@liste Vous avez des questions ? Contactez-nous sur admin-hal@liste.parisnanterre.fr ! FLASH INFO - Nous travaillons actuellement à la définition d’un nouveau schéma de métadonnées, qui utilisera les exports XML-TEI de Zotero combinés à la future nouvelle interface X2HAL de l’INRIA (en cours de développement). Pour en savoir plus (d’ici mars-avril), consultez notre site https://openaccess.parisnanterre.fr !