bookmarklet: réalise la procédure

- Rédige la procédure pour la configuration et l'usage du bookmarklet
  pour navigateur facilitant l'usage d'OpenAthens.
- Documente l'édition et la conversion des sources de cette procédure.
- Modifie le `Makefile`.
- Adapte le `README.md`.

Co-Authored-by: iGor milhit <igor@milhit.ch>

.gitignore

@@ -1,2 +1,4 @@
 *.zip
 *.pdf
+
+bookmarklet.html

Makefile

@@ -1,9 +1,9 @@
 # Modifier le nom et le nombre des fichiers
 # contenant les sources du document
 input_files := \
-document.md
+bookmarklet.md
 
-output_file_name := document
+output_file_name := bookmarklet
 
 pandoc := \
 	pandoc -s --citeproc \

README.md

@@ -1,42 +1,62 @@
 ---
-title: BUNIGE document
+title: OpenAthens par le CMU
+subtitle: Comment utiliser OpenAthens aux HUG et à l'UNIGE
 date: 2025-05-07T10:59:48+0200
 id: 20250507105948
-tags: ["modèle", "BUNIGE", "pagedjs"]
+tags: ["cmu", "unige", "hug", "cmu", "openathens", "documentation"]
 template_version: v0.2.0
 ---
 
-# [Document utilisant le modèle BUNIGE][1]
+# [OpenAthens par le CMU][1]
 
-Modèle pour faciliter la création d'un document utilisant le modèle pour la
-BUNIGE avec Pagedjs.
+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.
-
-## Mise à jour des fichiers du modèle
-
-Il faut télécharger l'archive sur la page de la [dernière publication de
-version][2] du projet du modèle. L'archive est nommée avec le numéro de version
-correspondant.
-
-```bash
-curl -o modèle.zip https://git.milhit.ch/igor/bunige-pagedjs-template/releases/download/v0.2.0/v0.2.0.zip
-unzip modèle.zip
-```
-
-## Utilisation du modèle
-
-Pour utiliser le modèle, il faut rédiger votre document dans un fichier avec
-une extension `.md`, autrement dit un fichier au format texte utilisant la
-syntaxe markdown. Pour cela, il est possible de s'aider de l'[exemple][3] pour
-comprendre ce qu'il est possible de faire.
-
-
+Ce projet est sous [licence CC-BY-SA 4.0][2].
 
 <!-- références -->
 
 [1]: ./
-[2]: https://git.milhit.ch/igor/bunige-pagedjs-template/releases/latest
-[3]: https://git.milhit.ch/igor/bunige-pagedjs-template/src/branch/main/example/example.md
+[2]: ./LICENSE
+[3]: ./bookmarklet.md

bookmarklet.md

@@ -0,0 +1,98 @@
+---
+title: Bookmarklet OpenAthens pour l'UNIGE
+creation_date: 2025-08-08T09:55:05+0200
+date: Automne 2025
+id: 20250808095505
+tags: ["OpenAthens", "navigateur web", "bookmarklet"]
+logo:
+  - ./static/logo-openathens.svg
+---
+
+:::{#licence}
+![Logo de la licence CC BY-SA 4.0][11] \
+[CC BY-SA 4.0][12] --- [Sources][13]
+:::
+
+
+## Description
+
+Un *bookmarklet* est un signet (marqueur, favori ou *bookmark*) ajouté au
+navigateur web (Firefox, Safari ou Chrome). Une fois configuré, le
+*bookmarklet* proposé ici permet de faciliter et d'accélérer l'authentification
+avec OpenAthens pour accéder aux publications scientifiques faisant l'objet
+d'un abonnement ou d'une licence pour la Bibliothèque de l'UNIGE.
+
+Cette authentification est devenue nécessaire pour la consultation de ces
+contenus depuis les HUG. Malheureusement, actuellement, le *bookmarklet* ne
+fonctionne pas comme attendu depuis le réseau des HUG. Mais il reste utile pour
+toutes les autres situations (à la maison, en déplacement, etc.)
+
+## Configuration {.newpage}
+
+1. Afficher la « barre personnelle » (Firefox) ou la « barre des favoris » pour
+   Chrome ou l'équivalent dans Safari ou Microsoft Edge[^1].
+
+![Afficher la barre personnes avec Firefox][5]
+
+![Afficher la barre des favoris avec Chrome][6]
+
+2. Ajouter un signet (marqueur, favori, *bookmark*) dans cette barre, au moyen
+   d'un clic-droit dans celle-ci.
+
+![Ajouter un marque-page dans Firefox][7]
+
+![Ajouter un favori dans Chrome][8]
+
+3. Configurer le bookmarklet, qui peut être nommé librement. Seuls les champs
+   « Nom » et « URL » sont obligatoires. Le champ URL doit
+   contenir le code suivant (sur une seule ligne, sans espace) :
+
+   ```javascript
+   javascript:void(location.href='https://go.openathens.net/redirector/unige.ch?url='+location.href);
+   ```
+
+   ![Configurer le bookmarklet dans Firefox][9]
+
+   ![Configurer le bookmarklet dans Chrome][10]
+
+Cliquer sur « enregistrer » et le *bookmarklet* est prêt !
+
+## Usage
+
+1. Charger la page de la ressource que vous voulez consulter.
+
+![NEJM avant authentification][1]
+
+2. Cliquer sur le *bookmarklet*.
+
+![Cliquer sur  le *bookmarklet*][2]
+
+3. La page se recharge avec les éléments d'OpenAthens nécessaires.
+4. Si nécessaire, connectez-vous avec votre compte UNIGE (ISIS) ou HUG
+   (SESAME).
+
+![S'authentifier avec son compte][3]
+
+5. Vous êtes authentifié et vous pouvez consulter le contenu.
+
+![NEJM après authentification][4]
+
+<!-- références -->
+
+[1]: ./static/nejm.png
+[2]: ./static/clic-bookmarklet.png
+[3]: ./static/compte-identification.png
+[4]: ./static/nejm-authentifié.png
+[5]: ./static/firefox-afficher-barre.png
+[6]: ./static/chrome-afficher-barre.png
+[7]: ./static/firefox-ajout-bookmark.png
+[8]: ./static/chrome-ajout-bookmark.png
+[9]: ./static/firefox-bookmark-content.png
+[10]: ./static/chrome-bookmark-content.png
+[11]: ./static/by-sa.svg
+[12]: https://creativecommons.org/licenses/by-sa/4.0/deed.fr "Texte de la licence en français"
+[13]: https://git.milhit.ch/igor/cmu-openathens-doc "Projet git du document"
+
+[^1]: Ce n'est pas à strictement parler nécessaire, mais ça facilite l'accès au
+bookmarklet. Si vous savez vous en passez, alors vous n'avez pas besoin de mes
+explications 😉.

static/logo-openathens.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 33 43"><path fill="#33A390" d="M3.435 17.42A3.788 3.788 0 00.456 13.1a.147.147 0 00-.17.12L.05 14.666a3.787 3.787 0 002.978 4.32.146.146 0 00.171-.119l.236-1.447zM4.585 17.608l-.237 1.45a.147.147 0 00.124.168 3.788 3.788 0 004.202-3.151l.237-1.45a.147.147 0 00-.124-.168 3.789 3.789 0 00-4.202 3.15zM3.202 11.731a.148.148 0 00.164.006.146.146 0 00.042-.04l.838-1.206a3.788 3.788 0 00-.829-5.184.147.147 0 00-.206.034l-.837 1.206a3.788 3.788 0 00.828 5.184zM9.536 11.554l.838-1.206a.146.146 0 00.001-.165.146.146 0 00-.04-.04 3.788 3.788 0 00-5.148 1.033l-.838 1.206a.147.147 0 00.04.205 3.788 3.788 0 005.147-1.033zM9.016 5.172A3.788 3.788 0 0010.258.071a.146.146 0 00-.203-.049l-1.24.789a3.787 3.787 0 00-1.243 5.1.146.146 0 00.203.05l1.24-.789zM8.641 7.142a.15.15 0 00-.043.21 3.897 3.897 0 005.293 1.07l1.275-.81a.15.15 0 00.044-.211 3.896 3.896 0 00-5.293-1.066l-1.276.807zM14.652 32.398a20.511 20.511 0 01-3.889-11.454.14.14 0 00-.14-.137H8.934a.148.148 0 00-.104.044.146.146 0 00-.041.105c.033 1.152.154 2.301.36 3.436a.062.062 0 01-.041.075.061.061 0 01-.031.001 4.23 4.23 0 01-3.662-3.542.139.139 0 00-.137-.12H3.58a.147.147 0 00-.145.162 6.196 6.196 0 006.149 5.5h.042c.206.737.45 1.463.73 2.175.05.115.065.243.045.367a2 2 0 01-1.96 1.62H6.603a5.111 5.111 0 00-5.067 4.474.173.173 0 00.02.135 26.35 26.35 0 001.677 2.04.072.072 0 00.083.025.072.072 0 00.046-.074c-.211-2.585.658-3.397.892-3.597a3.22 3.22 0 012.347-1.04h1.843a3.963 3.963 0 003.01-1.388.074.074 0 01.064-.026.073.073 0 01.057.038c.447.81.942 1.591 1.484 2.34a.146.146 0 00.15.056.146.146 0 00.052-.024l1.36-.994a.143.143 0 00.056-.092.142.142 0 00-.025-.105zM26.396 28.267h-3.884a.118.118 0 00-.11.073A22.542 22.542 0 018.847 40.975a.121.121 0 00-.015.223c.771.364 1.567.675 2.381.93a.22.22 0 00.15-.016 24.426 24.426 0 0011.85-10.892.121.121 0 01.212.006.12.12 0 01.01.084 22.048 22.048 0 01-4.252 8.372 20.067 20.067 0 01-3.111 3.029.336.336 0 01-.05.049c-.112.09-.12.19.043.213.27.013.54.027.81.027.635 0 1.26-.04 1.878-.102a.377.377 0 00.223-.103 21.973 21.973 0 001.724-1.862 24.208 24.208 0 004.945-10.42.398.398 0 01.09-.215.54.54 0 01.283-.055 4.424 4.424 0 014.411 4.107l-.016.062a15.668 15.668 0 01-3.31 3.24.33.33 0 00-.13.26v2.07a.104.104 0 00.163.082c3.905-2.7 5.103-4.836 5.154-4.928.046-.089.083-.181.11-.278.014-.188.017-.377.01-.566a6.014 6.014 0 00-6.013-6.025z"/><path fill="#33A390" d="M24.034 14.61a.228.228 0 01-.058-.197 9.396 9.396 0 00-9.248-10.996h-.407c-.133.006-.336.09-.103.344l1.672 1.667.133.068a7.422 7.422 0 015.89 9.145l-.137.54a.192.192 0 00.08.206l.462.312c.262.21.477.472.63.77a2.871 2.871 0 01-.09 2.56l-2.426 5.447a.27.27 0 01-.227.164 5.04 5.04 0 01-4.889-2.33.143.143 0 00-.103-.068.143.143 0 00-.117.039l-1.218 1.218a.148.148 0 00-.017.186 6.654 6.654 0 003.808 2.675.124.124 0 01.09.106 5.7 5.7 0 002.11 3.785.148.148 0 00.207-.026c.344-.447.672-.906.983-1.378a.142.142 0 00-.03-.187 3.732 3.732 0 01-1.23-1.96l.054-.07a6.963 6.963 0 001.395-.153 1.075 1.075 0 00.72-.614l2.684-6.027a4.629 4.629 0 00-.618-5.226z"/></svg>