---
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