Exemple d’utilisation
Le plugin permet sur un site SPIP d’interroger le portail bibliographique HAL et d’afficher des publications scientifiques.
Installation
Activer simplement le plugin.
Le plugin utilise les données distantes de HAL (via la boucle DATA). Le plugin n’installe aucune table SQL. Vous pouvez donc installer et le tester (ou désinstaller ...) sans aucune crainte.
Le menu de configuration permet de saisir le nombre d’items que l’on souhaite lister par défaut.
Utilisation du modèle <hal>
Pour les rédacteurs
Pour générer un bibliographie, il suffit d’utiliser le modèle <hal>
Il est possible de combiner les paramètres pour créer une requête complexe par exemple :
<hal|q=Mali|auteur=joseph-larmarange|max=4>
Pour les webmestres
Il est possible d’utiliser ce modèle pour l’intégrer dynamiquement dans vos squelettes.
<INCLURE{fond=public/hal,q=Mali,auteur=joseph-larmarange,max=4}>
Listes des paramètres
Tous les paramètres sont facultatifs. Si plusieurs paramètres sont indiqués, seules les références remplissant TOUTES les conditions seront sélectionnées.
Paramètre | Explications | Exemple |
---|---|---|
q |
requête de recherche sur l’API HAL https://api.archives-ouvertes.fr/docs/search |
|
collection |
restreindre à une collection, indiquer l’identifiant de la collection, tel qu’il apparit dans l’URL du portail de la collection |
|
auteur |
restreindre à un auteur à partir de son idHAL , pour une recherche sur le nom d’un auteur, utilisez le paramètre q |
|
max |
nombre maximum de résultats affiché de 0 à 10000. Valeur par défaut défini dans panel de configuration du plugin sinon 10 |
|
tri |
indique le tri de requête. par défaut par pertinence https://api.archives-ouvertes.fr/docs/search/?#sort |
|
debug |
affiche la requête vers l’API HAL pour aider au débogage |
|
dernieres_publications |
ajouté comme une classe (voir exemple), si renseigné, on force le tri sur le critère publicationDate_tdate et on ajoute un lien vers le CV de l’auteur et/ou le portail de la collection |
|
masquer_lien |
valable uniquement si dernieres_publications est renseigné.si masquer_lien=oui , on n’affiche pas les liens voir toutes publications après la liste des résultats |
|
halid |
retourne le document unique correspondant au HALid (attention à ne pas confondre le HALid d’une référence et l’idHAL d’un auteur) |
|
doi |
retourne le document unique correspondant au doi |
|
Insérer le modèle
Le plugin est compatible avec Plugin Insérer Modèles
Il facilite l’insertion du modèle dans votre site
Avec un assistant pour accompagner vos rédacteurs
Personnaliser le modèle
Pour l’aspect graphique, il suffit de définir vos propres CSS pour habiller graphiquement le modèle. Le modèle fourni par défaut est très proche du rendu du portail hal.science.
Si le modèle ne vous convient pas en terme de balisage HTML ou de choix des champs à afficher, il est possible de le surcharger en modifiant le fichier
public/hal.html
Alternatives
Le présent plugin est une évolution de HAL Pub et a vocation à le remplacer.
Il existe deux autres plugins SPIP liés à HAL, mais non référencés sur Contrib. Ces plugins continuent à être maintenu par kent1D et sont compatibles SPIP 4+.
- SPIP HAL qui ajoute les références en HAL en base de données
- HAL auteurs qui permet de lier les auteurs et des publications HAL
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |