generated from igor/bunige-document
63 lines
2.2 KiB
Markdown
63 lines
2.2 KiB
Markdown
---
|
||
title: OpenAthens par le CMU
|
||
subtitle: Comment utiliser OpenAthens aux HUG et à l'UNIGE
|
||
date: 2025-05-07T10:59:48+0200
|
||
id: 20250507105948
|
||
tags: ["cmu", "unige", "hug", "cmu", "openathens", "documentation"]
|
||
template_version: v0.2.0
|
||
---
|
||
|
||
# [OpenAthens par le CMU][1]
|
||
|
||
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 (à venir).
|
||
1. Une méthode pour [ajouter un *bookmarklet* au navigateur web][3] pour
|
||
faciliter son usage.
|
||
|
||
## Édition et conversion
|
||
|
||
Pour éditer la source de la procédure du *bookmaklet*, il faut éditer le
|
||
fichier markdown correspondant : [`./bookmarklet.md`][3].
|
||
|
||
Pour la conversion du document, il faut installer les dépendances (voir la
|
||
section [requis][4]) et utiliser les facilités du `Makefile` :
|
||
|
||
- `make html` ou `make watch_html` pour générer le fichier HTML contenant les
|
||
éléments d'interface de `pagedjs` pour la consultation dans un navigateur
|
||
web. La commande avec le watch permet de reconvertir automatiquement le
|
||
fichier chaque fois que des modification du markdown 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 pdf` converti au format PDF le fichier markdown en utilisant `pagedjs`.
|
||
|
||
## 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`, `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_html` par exemple.
|
||
|
||
## Licence
|
||
|
||
Ce projet est sous [licence CC-BY-SA 4.0][2].
|
||
|
||
<!-- références -->
|
||
|
||
[1]: ./
|
||
[2]: ./LICENSE
|
||
[3]: ./bookmarklet.md
|