igor
/
rdv-info-markdown
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 4 Wiki Activity
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
4 Commits
2 Branches
4 Tags
1.7 MiB
JavaScript 98.5%
CSS 1.2%
HTML 0.2%
 
 
 
Go to file
iGor milhit 2c50be353c
introduction: termine la 1re version du document 
- Ajoute les captures d'écran nécessaires.
- Apporte les modifications au style pour la conversion.
- Met à jour les références bibliographiques.
- Finalise le contenu de l'introduction.
- Documente la génération du PDF dans le `README.md`.
- Documente le déroulé de la présentation.

Co-Authored-by: iGor milhit <igor@milhit.ch>
 		2023-04-27 11:54:17 +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.