2023-04-19 12:29:23 +02:00
|
|
|
|
---
|
|
|
|
|
|
title: Rendez-vous de l'info scientifique sur markdown
|
|
|
|
|
|
date: 2023-04-19T10:13:18+02:00
|
|
|
|
|
|
id: 20230419101340
|
|
|
|
|
|
tags: [rdv-info, documentation, markdown]
|
|
|
|
|
|
---
|
2023-04-19 10:06:41 +02:00
|
|
|
|
|
2023-04-19 12:29:23 +02:00
|
|
|
|
## [Markdown, introduction et compléments][projet]
|
|
|
|
|
|
|
|
|
|
|
|
Ce répertoire contient le matériel utilisé pour les [deux « rendez-vous de
|
|
|
|
|
|
l'info scientifique » sur Markdown][rdv] proposés par la bibliothèque de
|
|
|
|
|
|
l'Université de Genève :
|
|
|
|
|
|
|
2023-04-25 16:53:48 +02:00
|
|
|
|
- [L'introduction à la prise de notes][intro].
|
|
|
|
|
|
- [Aller plus loin avec Markdown][avancé].
|
|
|
|
|
|
|
|
|
|
|
|
## 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) :
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
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 :
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
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.
|
2023-04-19 12:29:23 +02:00
|
|
|
|
|
|
|
|
|
|
[projet]: ./
|
|
|
|
|
|
[rdv]: https://www.unige.ch/biblio/index.php?cID=4127 "Présentation des 2 rendez-vous sur le site de la bibliothèque de l'Université de Genève"
|
2023-04-25 16:53:48 +02:00
|
|
|
|
[intro]: ./intro/intro.md
|
|
|
|
|
|
[avancé]: ./avancé/avancé.md
|
