|
|
||
|---|---|---|
| sources/slides | ||
| src/scss | ||
| static | ||
| .gitignore | ||
| Makefile | ||
| README.md | ||
| package-lock.json | ||
| package.json | ||
README.md
| title | subtitle | date | id | tags | ||||
|---|---|---|---|---|---|---|---|---|
| BUNIGE slides | Un thème BUNIGE pour reveal.js | 2026-08-18T14:22:30+0200 | 20260818142230 |
|
Description
BUNIGE slides a pour but d'accélérer la création de slides avec
reveal.js, avec un thème à peu près compatible avec la charte graphique de
l'Université de Genève (UNIGE). BUNIGE est l'acronyme de la Bibliothèque
de l'UNIGE.
Usage
Requis
Pour pouvoir utiliser ce projet, les utilitaires suivants doivent être installés :
npmpour gérer les paquets Node.js, essentiellement pour installerreveal.jset quelques dépendances (Sass, Browsersync).make.pandocpour la conversion des documents.watchexecpour l'observation des changements dans les fichiers sources (commandemake watch).
Mise en place
Une fois ces outils disponibles, clonez le projet :
git clone https://git.milhit.ch/igor/bunige-slides.git
Naviguer dans le bon dossier et installer les dépendances :
cd bunige-slides
npm install
Édition
Le principe général est le suivant :
- Édition des slides dans un fichier au format Markdown.
- Conversion du fichier Markdown en un fichier HTML qui pourra ensuite être servi par un serveur web.
Le fichier slides.md qui est dans le dossier sources/slides donne un bon
aperçu de ce qui peut être réalisé, notamment avec les classes HTML/CSS rendues
disponibles par le thème BUNIGE.
Pour créer une présentation, vous pouvez soit éditer le fichier slides.md
soit en créer un autre, dans le même répertoire. Dans ce cas, il faudra
également modifier la ligne suivante du Makefile :
SLIDES_FILE = slides.md
Il faut remplacer slides.md par le nom de votre fichier.
Construction du fichier HTML
Pour utiliser la présentation, elle doit être au format HTML. La conversion se
fait au moyen de l'utilitaire Pandoc, sur la base de la librairie reveal.js
installée dans le projet, et le thème BUNIGE.
Pour lancer la conversion :
make
On peut également lancer une commande pour que la conversion se relance à chaque fois que les fichiers sources sont modifiés :
make watch
Prévisualiser le résultat
Pour avoir un aperçu du résultat, il faut servir le fichier HTML par un serveur
web. Vous pouvez utiliser la commande make serve (qui utilise Browsersync,
installé dans les dépendances).
En combinant make watch et make serve dans deux sessions du terminal, on
obtient un environnement pour éditer sa présentation.
Modifier le thème
Pour modifier le thème, il faut éditer les fichiers suivants :
src/scss/bunige.scss. La compilation du fichierstatic/css/bunige.cssse fait avec la commandemake css.make watch-csspour recompiler à chaque modification de la source est aussi disponible.static/templates/template.htmlest le modèle utilisé par Pandoc et qui peut contenir une logique sur la base de variables.
Supprimer les fichiers générés
Pour supprimer les fichiers générés (index.html et bunige.css) :
make clean