igor
/
cmu-openathens-doc
generated from igor/bunige-document
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 3 Wiki Activity
Documentation et procédures pour l'usage d'OpenAthens à l'Université de Genève (UNIGE) et aux Hôpitaux universitaires de Genève (HUG), et plus particulièrement dans le contexte du site CMU de la Bibliothèque de l'UNIGE (BUNIGE).
5 Commits
2 Branches
3 Tags
5 MiB
JavaScript 98.5%
CSS 1.2%
HTML 0.2%
Makefile 0.1%
 
 
 
 
Go to file
iGor milhit 868f6341a5
projet: intègre les procédure OpenAthens 
- Intègre les procédures OpenAthens au projet.
- Adapte le Makefile pour convertir les différents documents.
- Documente l'usage du Makefile.
- Rassemble tous les fichiers statiques dans le dossier static.
- Regroupe les images dans le dossier static/images.

Co-Authored-by: iGor milhit <igor@milhit.ch>
 		2025-12-08 14:44:38 +01:00
source projet: intègre les procédure OpenAthens 2025-12-08 14:44:38 +01:00
static projet: intègre les procédure OpenAthens 2025-12-08 14:44:38 +01:00
.gitignore projet: intègre les procédure OpenAthens 2025-12-08 14:44:38 +01:00
LICENSE Initial commit 2025-08-08 09:36:15 +02:00
Makefile projet: intègre les procédure OpenAthens 2025-12-08 14:44:38 +01:00
README.md projet: intègre les procédure OpenAthens 2025-12-08 14:44:38 +01:00
heg-iso-690.csl Initial commit 2025-08-08 09:36:15 +02:00

README.md

title subtitle date id tags template_version
OpenAthens par le CMU Comment utiliser OpenAthens aux HUG et à l'UNIGE 2025-05-07T10:59:48+0200 20250507105948
cmu
unige
hug
cmu
openathens
documentation
v0.2.0

OpenAthens par le CMU

Ce projet rassemble la documentation produite par la Bibliothèque de l'UNIGE, site CMU sur l'usage du protocole OpenAthens pour accéder à l'information scientifique qui est derrière un paywall et est couverte par les licences et les abonnements de la Bibliothèque.

Il faut noter que depuis janvier 2023, OpenAthens est la méthode pour cet accès, car la reconnaissance par IP n'est plus possible.

Contenu de la documentation

Cette documentation propose :

  1. Des procédures détaillant les cas particuliers. Ce sont les fichiers .md du dossier source/. Un cas particulier est ajouté à chaque fois qu'un ou une lectrice signale un problème pour accéder à une ressource précise chez un fournisseur (base de donnée, éditeur, revue).
  2. Une méthode pour ajouter un bookmarklet au navigateur web pour faciliter son usage.

Édition et conversion

Pour éditer la source de la procédure du bookmaklet, il faut éditer le fichier markdown correspondant : ./source/bookmarklet.md. C'est la même méthode pour les cas particuliers.

Pour la conversion du document, il faut installer les dépendances (voir la section Requis) et utiliser les facilités du Makefile :

  • make html ou make <filename>.html pour générer le ou les fichiers HTML contenant les éléments d'interface de pagedjs pour la consultation dans un navigateur web.
  • make watch TARGET=<filename>.html permet de reconstruire automatiquement le fichier chaque fois que des modifications du markdown, du template ou du CSS sont enregistrées.
  • make serve lance un serveur web local (avec python) pour charger le fichier HTML produit par la commande précédente.
  • make ou make pdf ou make <filename>.pdf converti au format PDF le ou les fichiers markdown en utilisant pagedjs. Seuls les sources modifiées sont reconstruites.
  • make clean supprime les fichiers HTML lorsqu'ils ne sont plus utiles.

Requis

Pour convertir les sources dans différents formats, et pour faciliter l'édition, certains logiciels sont utiles, voire nécessaires :

  • pandoc pour les conversion (obligatoire).
  • pagedjs-cli pour la conversion au format PDF (obligatoire).
  • watchexec pour observer les modifications sur des fichiers afin de relancer une commande. C'est utile pour la commande make watch TARGET=<filename>.md par exemple.

Licence

Ce projet est sous licence CC-BY-SA 4.0.