diff --git a/.gitignore b/.gitignore index 95ea976..a611ae3 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,4 @@ *.zip *.pdf + +bookmarklet.html diff --git a/Makefile b/Makefile index 1cf65c7..f9d1c68 100644 --- a/Makefile +++ b/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 \ diff --git a/README.md b/README.md index adfa826..b7e5f27 100644 --- a/README.md +++ b/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]. [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 diff --git a/bookmarklet.md b/bookmarklet.md new file mode 100644 index 0000000..a279a16 --- /dev/null +++ b/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] + + + +[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 😉. diff --git a/static/chrome-afficher-barre.png b/static/chrome-afficher-barre.png new file mode 100644 index 0000000..14d7b99 Binary files /dev/null and b/static/chrome-afficher-barre.png differ diff --git a/static/chrome-ajout-bookmark.png b/static/chrome-ajout-bookmark.png new file mode 100644 index 0000000..5306dda Binary files /dev/null and b/static/chrome-ajout-bookmark.png differ diff --git a/static/chrome-bookmark-content.png b/static/chrome-bookmark-content.png new file mode 100644 index 0000000..076222e Binary files /dev/null and b/static/chrome-bookmark-content.png differ diff --git a/static/clic-bookmarklet.png b/static/clic-bookmarklet.png new file mode 100644 index 0000000..fa9b95f Binary files /dev/null and b/static/clic-bookmarklet.png differ diff --git a/static/compte-identification.png b/static/compte-identification.png new file mode 100644 index 0000000..6b2de8f Binary files /dev/null and b/static/compte-identification.png differ diff --git a/static/firefox-afficher-barre.png b/static/firefox-afficher-barre.png new file mode 100644 index 0000000..05807ec Binary files /dev/null and b/static/firefox-afficher-barre.png differ diff --git a/static/firefox-ajout-bookmark.png b/static/firefox-ajout-bookmark.png new file mode 100644 index 0000000..369f5ff Binary files /dev/null and b/static/firefox-ajout-bookmark.png differ diff --git a/static/firefox-bookmark-content.png b/static/firefox-bookmark-content.png new file mode 100644 index 0000000..ccb54ab Binary files /dev/null and b/static/firefox-bookmark-content.png differ diff --git a/static/logo-openathens.svg b/static/logo-openathens.svg new file mode 100644 index 0000000..bde450a --- /dev/null +++ b/static/logo-openathens.svg @@ -0,0 +1 @@ + diff --git a/static/nejm-authentifié.png b/static/nejm-authentifié.png new file mode 100644 index 0000000..47c74a8 Binary files /dev/null and b/static/nejm-authentifié.png differ diff --git a/static/nejm.png b/static/nejm.png new file mode 100644 index 0000000..eaf3369 Binary files /dev/null and b/static/nejm.png differ