91 lines
3.9 KiB
Markdown
91 lines
3.9 KiB
Markdown
|
## Aperçu des possibilités avancées
|
|||
|
|
|
|||
|
|
### Ensemble de notes
|
|||
|
|
|
|||
|
|
Afin d'organiser ses notes, il est possible de réunir un ensemble de fichiers
|
|||
|
|
dans le même répertoires (y compris avec des sous répertoires) et de faire des
|
|||
|
|
liens entre les fichiers (et même au sein d'un seul fichier).
|
|||
|
|
|
|||
|
|
Certains éditeurs, ou certaines extensions d'éditeurs, proposent des facilités
|
|||
|
|
pour générer ces liens, au prix d'une syntaxe *ad hoc* (« wiki links »). Mais
|
|||
|
|
il est parfaitement possible de le faire avec la syntaxe « normale » du lien.
|
|||
|
|
|
|||
|
|
![Lien depuis le fichier `README.md` vers le fichier `points-a-ameliorer.md`][14]
|
|||
|
|
|
|||
|
|
La figure 5 montre sur la gauche une arborescence de fichiers, avec
|
|||
|
|
des sous-répertoires, et dans le fichier affiché (`README.md`), un lien vers le
|
|||
|
|
fichier `points-a-ameliorer.md`. Dans cet éditeur, en plaçant le curseur sur le
|
|||
|
|
lien et en tapant la touche « entrée », on ouvre le fichier cible.
|
|||
|
|
|
|||
|
|
La figure 6 montre la recherche du terme `rdv-info` lancée sur la même
|
|||
|
|
arborescence de fichiers que la figure 5, au moyen du logiciel Visual Studio
|
|||
|
|
Code. Il y a 13 occurrences du terme dans 7 fichiers. Ce type de recherche est
|
|||
|
|
facilité par le fait que ce sont des fichiers au format texte et se retrouve
|
|||
|
|
dans la plupart des éditeurs généralistes de qualité.
|
|||
|
|
|
|||
|
|
![Recherche dans Visual Studio Code][15]
|
|||
|
|
|
|||
|
|
### Export vers d'autres formats
|
|||
|
|
|
|||
|
|
La conversion d'un document markdown en un autre format, plus simple à partager
|
|||
|
|
devient assez vite utile. Pour les conversions, `pandoc` est l'outil le plus
|
|||
|
|
souvent utilisé. Il est soit utilisé par votre éditeur pour faire les exports
|
|||
|
|
(par exemple avec Zettlr), soit par vous même en ligne de commande. C'est un
|
|||
|
|
logiciel libre et gratuit, développé très activement.
|
|||
|
|
|
|||
|
|
Il est capable de lire et d'écrire dans un grand nombre de formats différents,
|
|||
|
|
parfois à l'aide de logiciels spécifiques. Par exemple, pour produire un
|
|||
|
|
fichier PDF, il peut utiliser plusieurs méthodes, dont LaTeX, ce qui suppose
|
|||
|
|
d'en avoir une version installée.
|
|||
|
|
|
|||
|
|
La commande pour une conversion simple est de la forme suivante :
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pandoc --output fichier.docx fichier.md
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Le format obtenu correspond à celui qui est indiqué en extension du nom de
|
|||
|
|
fichier de sortie `--output`, ici du DOCX. Mais il est possible de
|
|||
|
|
l'expliciter :
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pandoc --to docx --output fichier.docx fichier.md
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Le support de cours de cette introduction à markdown a été rédigée en markdown
|
|||
|
|
et est exportée en PDF grâce à `pandoc` et à *Paged.js*.[^3]
|
|||
|
|
|
|||
|
|
### Citations et Bibliographie
|
|||
|
|
|
|||
|
|
Pour insérer des citations et générer une bibliographie, il est nécessaire
|
|||
|
|
d'avoir au moins une collection de références bibliographiques, par exemple
|
|||
|
|
sous la forme d'un fichier `.bib`. Pour obtenir ce fichier, il est possible de
|
|||
|
|
passer par Zotero et d'exporter une collection dans le format BibTex (ou Better
|
|||
|
|
BibTex avec l'extension Zotero du même nom.)
|
|||
|
|
|
|||
|
|
Dans ce fichier (et dans Zotero), on trouve pour chaque référence une « clé de
|
|||
|
|
citation » qui permet de l'identifier de manière unique. C'est cette clé que
|
|||
|
|
l'on va insérer dans notre fichier markdown pour indiquer une citation. Elle
|
|||
|
|
est insérée avec la syntaxe suivante : `[@clé-de-citation]`.
|
|||
|
|
|
|||
|
|
On peut encore ajouter à la fin de notre fichier un titre de deuxième niveau
|
|||
|
|
avec le texte bibliographie, pour que `pandoc` puisse y insérer la
|
|||
|
|
bibliographie.
|
|||
|
|
|
|||
|
|
Pour être en mesure de traiter ces informations, il faut utiliser l'option de
|
|||
|
|
`--citeproc` intégrée dans `pandoc` :
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pandoc --citeproc \
|
|||
|
|
--to=pdf --pdf-engine=xelatex \
|
|||
|
|
--bibliography=references.bib \
|
|||
|
|
--output fichier.pdf fichier.md
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Dans l'exemple ci-dessus, nous voyons l'option `--citeproc` et l'option
|
|||
|
|
`--bibliography=` qui indique où se trouve le fichier des références
|
|||
|
|
bibliographiques. Par défaut le style est Chicago, de type auteur-date.
|
|||
|
|
|
|||
|
|
Pour aller plus loin, le mieux est de consulter la [documentation
|
|||
|
|
officielle][16] de `pandoc.`
|