igor
/
cmu-services
1
0
Fork 0
Code Issues 1 Pull Requests Packages Projects Releases 3 Wiki Activity
Aide-mémoire pour une présentation des services de la bibliothèque.
5 Commits
1 Branch
3 Tags
620 KiB
JavaScript 98.5%
CSS 1.2%
HTML 0.2%
 
 
 
Go to file
iGor milhit a55e6fb722
documentation: documente l'édition, les commandes 
- Documente plus en détail comment éditer le projet.
- Documente les commandes fournies par le Makefile.

Co-Authored-by: iGor milhit <igor@milhit.ch>
 		2025-12-02 12:34:26 +01:00
static document: offre des QR-codes pour les liens 2025-08-07 11:11:34 +02:00
.gitignore document: ajoute une image de la bibliothèque CMU 2025-05-22 09:56:59 +02:00
Makefile document: ajoute une image de la bibliothèque CMU 2025-05-22 09:56:59 +02:00
README.md documentation: documente l'édition, les commandes 2025-12-02 12:34:26 +01:00
heg-iso-690.csl projet: initial commit 2025-04-09 11:56:31 +02:00
interface.css projet: initial commit 2025-04-09 11:56:31 +02:00
paged.polyfill.js projet: initial commit 2025-04-09 11:56:31 +02:00
présentation-services.md document: met à jour pour l'automne 2025-11-27 10:18:15 +01:00
reload-in-place.js projet: initial commit 2025-04-09 11:56:31 +02:00
style.css document: ajoute une image de la bibliothèque CMU 2025-05-22 09:56:59 +02:00
template.html projet: initial commit 2025-04-09 11:56:31 +02:00

README.md

title date id tags
CMU services 2025-04-09T11:37:45+0200 20250409113745
cmu
présentation
services

Ce projet a pour but de générer un aide-mémoire qui peut être communiqué lors d'une présentation des services de la bibliothèque du CMU. Il permet de retrouver facilement :

  • La page de la bibliothèque du CMU.
  • Les blocs « en 1 clic » et « services » de cette page, blocs qui donnent accès à l'essentiel de ce qui est présenté.
  • La page qui regroupe des informations à destination des membres HUG.
  • Le lien PubMed avec le résolveur UNIGE, ainsi que le raccourci vers la même page.

Éditer

Pour éditer, il suffit de modifier le contenu du fichier ./présentation-services.md.

Dans certains cas, il est nécessaire de modifier :

  • Le modèle HTML (template.html) utilisé par pandoc pour convertir le markdown en HTML.
  • Les règles CSS (style.css) qui déterminent la forme du PDF final.

Générer

Il faut installer pandoc et pagedjs-cli, puis lancer la commande suivante :

pandoc -s --embed-resource \
       --to=pdf --pdf-engine=pagedjs-cli \
       -V noscript=true --css=style.css --template=template.html \
       --output=présentation-services.pdf présentation-services.md

Commandes

Il existe un fichier Makefile qui facilite à la fois l'édition et la génération du document final.

Il nécessite les prérequis suivants :

  • pandoc.
  • pagedjs-cli.
  • watchexec (pour surveiller les modifications de fichier).
  • python pour lancer un serveur local avec le bon module.

Les commandes disponibles sont :

  • make html pour générer le fichier HTML qui peut être servi par un serveur web pour prévisualiser le résultat, ou modifier le rendu.
  • make watch_html pour regénérer le HTML à chaque fois qu'un fichier source (le markdown, le template HTML, les règles CSS) est modifié (sauvé).
  • make serve pour lancer un serveur web qui se recharge lorsque nécessaire.
  • make pdf pour générer le document final au format PDF.