Un modèle et une mise en forme pour produire un PDF suivant la charte de la Bibliothèque de l'Université de Genève.

Go to file

iGor milhit 849912da55 projet: améliore le modèle et l'exemple - Complète la documentation pour mieux expliquer la structure du projet et l'utilisation des commandes pour générer le document PDF final. - Améliore la syntaxe markdown de la documentation. - Ajoute du contenu à l'exemple afin de mieux montrer le résultat obtenu. - Documente le fichier des règles de styles. - Implémente des améliorations de style réalisée avec le projet BibLaTeX et Zotero, notamment la numérotation de la table des matières et sur l'affichage du numéro de page de chaque section. - Corrige le nom de la police « TheSansOsF » afin qu'elle soit bien utilisée. - TODO : reste pour l'instant le problème de l'indentation du code avec la coloration syntaxique ajoutée par Pandoc. Également le fait que le résultat n'est pas le même dans le fichier HTML que dans celui généré par `pagedjs-cli` à partir du même fichier HTML… Co-Authored-by: iGor milhit <igor@milhit.ch>		2024-03-12 08:58:31 +01:00
example	projet: améliore le modèle et l'exemple	2024-03-12 08:58:31 +01:00
static	projet: met en place le projet et l'exemple	2023-04-24 15:05:30 +02:00
.gitignore	projet: met en place le projet et l'exemple	2023-04-24 15:05:30 +02:00
LICENSE	Initial commit	2023-04-21 11:16:30 +02:00
README.md	projet: améliore le modèle et l'exemple	2024-03-12 08:58:31 +01:00
heg-iso-690.csl	projet: met en place le projet et l'exemple	2023-04-24 15:05:30 +02:00
interface.css	projet: met en place le projet et l'exemple	2023-04-24 15:05:30 +02:00
style.css	projet: améliore le modèle et l'exemple	2024-03-12 08:58:31 +01:00
template.html	projet: met en place le projet et l'exemple	2023-04-24 15:05:30 +02:00

README.md

title

date

Un modèle pagedjs pour la BUNIGE

Licence

Ce projet est sous licence MIT.

Description

Ce projet est un modèle et une mise en forme pour produire un PDF suivant la charte de la Bibliothèque de l'Université de Genève.

Il a pour objectif d'être ajouté rapidement à un projet utilisant paged.js pour générer des PDF à partir d'un contenu en markdown.

Structure du répertoire

À la racine du répertoire se trouve les fichiers nécessaires au modèle :

Le modèle lui-même : template.html.
La feuille de style qui rend possible l'interface web pour la prévisualisation du document au format HTML : interface.css (fichier faisant partie du projet paged.js : interface.css).
Le fichier de style bibliographique qui fait partie à part entière du modèle, car il est la norme utilisée par la charte : heg-iso-690.csl. Il est extrait du répertoire des styles .csl : haute-ecole-de-gestion-de-geneve-iso-690.csl.

Dans le dossier example se trouvent les sources pour pouvoir donner un exemple :

Le document markdown lui-même : example.md.
Une liste de références bibliographiques au format BibLaTeX : references.bib.

Prérequis

pandoc.
pagedjc-cli (npm install -g puppeteer pagedjs pagedjs-cli).

Génération du PDF d'exemple

Lancer les commandes depuis le répertoire ./example.

Pour générer le fichier HTML a visualiser dans le navigateur :

pandoc --standalone --pdf-engine=pagedjs-cli \
       --template=../template.html --css=../style.css \
       --toc --toc-depth=2 --citeproc \
       --to=html --output=example.html example.md

Puis lancer un serveur web à la racine du projet (par exemple avec python -m http.server), et ouvrir le fichier HTML généré avec Chromium (ou Chrome) pour pouvoir l'imprimer au format PDF.

Pour générer directement le PDF :

pandoc --standalone --citeproc \
       --to=pdf --pdf-engine=pagedjs-cli \
       --css=../style.css --toc --toc-depth=2 \
       --output=example.pdf example.md

Pour générer le PDF en utilisant pagedjs :

pandoc --citeproc --to=html --toc --toc-depth=2 \
       --template=../template.html --css=../style.css \
       --output example.html example.md \
       && pagedjs-cli example.html --style ../style.css --output example.pdf

README.md Unescape Escape