Matériel pour le « rendez-vous de l'info scientifique » sur Markdown proposés par la bibliothèque de l'Université de Genève.
https://www.unige.ch/biblio/index.php?cID=4127
iGor milhit
f14b0b42aa
- Restructure la feuille de style. - Implémente les adaptation de la feuille de style et du template du projet bunige-template. - Améliore le rendu des exemples de codes. - Complète et adapte les notes du déroulé. - Restructure et complète le contenu de l'introduction pour une présentation d'une demi-heure et pour tenir compte des nouveaux objectifs. - Met à jour les fichiers des références bibliographiques. Co-Authored-by: iGor milhit <igor@milhit.ch> |
||
---|---|---|
intro | ||
static | ||
.gitignore | ||
LICENSE | ||
README.md | ||
interface.css | ||
style.css | ||
template.html |
README.md
title | date | id | tags | |||
---|---|---|---|---|---|---|
Rendez-vous de l'info scientifique sur markdown | 2023-04-19T10:13:18+02:00 | 20230419101340 |
|
Markdown, introduction et compléments
Ce répertoire contient le matériel utilisé pour les deux « rendez-vous de l'info scientifique » sur Markdown proposés par la bibliothèque de l'Université de Genève :
Pré-requis
pandoc
.pagedjs-cli
(npm install -g puppeteer pagedjs pagedjs-cli
).
Génération du PDF
Lancer les commandes depuis le répertoire contenant le fichier source au format
Markdown, soit ./intro
, soit ./avancé
.
Pour générer le fichier HTML à servir par un serveur web pour le visualiser
dans le navigateur, il faut utiliser pandoc
avec les paramètres suivants (à
adapter au fichier à générer) :
pandoc --standalone --to=html \
--template=../template.html --css=../style.css \
--toc --toc-depth=2 --citeproc \
--output=intro.html intro.md
--standalone
pour obtenir tous les scritps javascript et les styles CSS nécessaires à l'interface de visualisation et à la mise en forme voulue dans le fichier HTML.--to=html
pour convertir vers du HTML.--template=
et--css=
indiquent quels modèle et feuille de style utiliser.--toc
et--toc-depth=2
générent la table des matière en n'allant pas plus loin que les titres de niveau 2.--citeproc
indique qu'il faut tenir compte des citations et générer la bibliographie.--output=
précise où et à quel nom générer le fichier de sortie.
Pour générer directement le PDF :
pandoc --standalone --citeproc \
--to=pdf --pdf-engine=pagedjs-cli \
--css=../style.css --toc --toc-depth=2 \
--output=intro.pdf intro.md
La différence ici est le format de destination (PDF) et le fait d'utiliser
pagedjs-cli
comme outil de composition du PDF.