SpirHAL Logo

pipeline status

le code source de SpirHAL est disponible ici.

Plan de la documentation :

Présentation du projet

SpirHAL est un projet open-source permettant le déploiement d’un module d’affichage sur un site web des notices de publications scientifiques figurant sur la plateforme HAL.

Affichage pour une personne

Ce mode permet l’affichage des notices des publications pour une personne en respectant une norme bibliographique donnée. Il peut être utilisé pour un affichage sur une fiche annuaire des membres d’un laboratoire.

Le premier laboratoire a avoir utilisé le module SpirHAL est Framespa. Il est possible d’observer un exemple avec la fiche annuaire correspondant à Hélène Débax (membre du laboratoire Framespa) en suivant ce lien.

Les informations suivantes sont nécessaires :

  • structId: Identifiant HAL du laboratoire de la personne
    • peut être une liste d’identifiants HAL
    • peut être laissé vide s’il n’est pas connu
  • norm: nom de la norme bibliographique dans laquelle les notices doivent être présentées
    • choix entre APA, MLA, EHESS
    • possibilité de laisser vide pour la citation de HAL par défaut
  • idHal: Identifiant HAL de la personne
  • researcherName: nom complet de la personne
    • utilisé si aucun identifiant HAL n’est renseigné
  • portal: si un portail HAL est à renseigner pour la recherche
    • peut-être laissé vide
  • adminLink: lien du site d’administration SpirHAL pour la personne, s’il est déployé

HTML pour instancier SpirHAL pour une personne avec son idHAL

<html>
   <head>
      <meta charset="UTF-8" />
      <script type="text/javascript" src="bundle.js"></script>
   </head>
   <body>
         <spirhal-app idhal="20468" portal="univ-tlse2" struct-id="620" norm="EHESS"></spirhal-app>
   </body>
</html>

HTML pour instancier SpirHAL pour une personne avec son nom

<html>
   <head>
      <meta charset="UTF-8" />
      <script type="text/javascript" src="bundle.js"></script>
   </head>
   <body>
         <spirhal-app researcher-name="Hélène Débax" struct-id="620" norm="EHESS"></spirhal-app>
   </body>
</html>

Affichage pour une structure

Ce mode permet l’affichage des notices des publications pour une structure, identifiées par un structId dans HAL. Par exemple, FRAMESPA a le structId 620 dans HAL: https://hal.archives-ouvertes.fr/search/index/q/*/structId_i/620/ Les informations suivantes sont nécessaires :

  • structId: Identifiant HAL de la structure
  • norm: nom de la norme bibliographique dans laquelle les notices doivent être présentées
    • choix entre APA, MLA, EHESS
    • possibilité de ne pas le renseigner pour la citation de HAL par défaut
  • limit: nombre de notices maximales à récupérer par type de notice
  • portal: si un portail HAL est à renseigner pour la recherche des notices
    • peut-être laissé vide
  • adminLink: lien du site d’administration SpirHAL, s’il est déployé

HTML pour instancier SpirHAL pour une structure avec son nom

<html>
   <head>
      <meta charset="UTF-8" />
      <script type="text/javascript" src="bundle.js"></script>
   </head>
   <body>
      <spirhal-app-structure struct-id="620" norm="APA" limit="20"></spirhal-app-structure>
   </body>
</html>

À propos

le code source de SpirHAL est disponible ici.

Ce projet est développé avec la technologie React, et est disponible sous forme de Web component, ce qui permet un déploiement facile et rapide sur tout site web. L’utilisation de cette technologie permet aussi la compatibilité avec la plupart des navigateurs.

Licence Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License