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
 
 
 
Go to file
iGor milhit 766dd7e3e7
avancé: débute le support pour la session avancée
Co-Authored-by: iGor milhit <igor@milhit.ch>
2023-04-27 16:48:56 +02:00
avancé avancé: débute le support pour la session avancée 2023-04-27 16:48:56 +02:00
intro introduction: termine la 1re version du document 2023-04-27 11:54:17 +02:00
static introduction: termine la 1re version du document 2023-04-27 11:54:17 +02:00
.gitignore template: ajoute les fichiers pour export pagedjs 2023-04-24 20:31:19 +02:00
LICENSE Initial commit 2023-04-19 10:06:41 +02:00
README.md introduction: termine la 1re version du document 2023-04-27 11:54:17 +02:00
interface.css template: ajoute les fichiers pour export pagedjs 2023-04-24 20:31:19 +02:00
style.css introduction: termine la 1re version du document 2023-04-27 11:54:17 +02:00
template.html template: ajoute les fichiers pour export pagedjs 2023-04-24 20:31:19 +02:00

README.md

title date id tags
Rendez-vous de l'info scientifique sur markdown 2023-04-19T10:13:18+02:00 20230419101340
rdv-info
documentation
markdown

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.