Outils pour utilisateurs

Outils du site


informatique:md-pandoc

Ceci est une ancienne révision du document !


Markdown et Pandoc

Documentation

But et intérêt

Installation

Utilisation avec vim

On peut utiliser le plugin vim-markdown (attention notamment à insérer let g:vim_markdown_folding_disabled=1 dans le .vimrc pour éviter le repli).

<delete>Personnellement, je ne suis pas tout à fait satisfait de ce plugin, c'est peut-être aussi que je ne sais pas l'utiliser correctement, mais j'ai des auto-indentations étranges, qui n'impactent pas le rendu, mais me dérangent au niveau de la lecture de la source en .md.</delete> Avec les versions plus récentes du plugin, ce problème a disparu.

Ce qui fonctionne bien, c'est de faire en sorte que vim reconnaisse bien le filetype : :set filetype=markdown ou carrément l'ajouter dans le .vimrc :

au BufRead,BufNewFile *.md set filetype=markdown

Commandes

PDF

Pour générer des PDF, il faut que LaTeX soit bien installé, avec les packages nécessaires, bien entendu.

La commande simple, à partir d'un fichier markdown :

 pandoc -o output.pdf input.md

Par défaut, cette commande produit un document en format US/letter, en anglais. Il est bien entendu possible de configurer la sortie en A4, en français (pour autant que tous les packages soient installés, bien entendu again) :

pandoc --variable=papersize:a4paper --variable=lang:french -o output.pdf input.md

Comme on a bien structuré notre document, il est possible de créer une table of content : --toc. Pour numéroter les chapitres avec un .odt, il suffit d'utiliser un template dont la numérotation des chapitres est configurée… Pour le faire dans un PDF, il faut utiliser l'argument -N.

-S améliore la qualité de la typographie, mais je n'ai pas trouvé comment obtenir des guillemets français.

Il est également possible de choisir le moteur LaTeX : –latex-engine=xelatex, par exemple.

Ce qui peut nous donner la commande suivante :

 pandoc -S -N --toc --latex-engine=xelatex --variable=lang:french --variable=papersize:a4paper -o output.pdf input.md

Citations

La documentation officielle sur le sujet est à l'URL suivante : http://pandoc.org/README.html#citations

Les sources des références

Pour les citations, il faut disposer d'un fichier .bib. Il est possible de le faire avec d'autres types de formats, comme par exemple du JSON, mais je ne suis pas parvenu à un quelconque résultat, alors que ça m'intéresserait bien.

Ce fichiers .bib peut être obtenu via Zotero : menu des Actions / Exporter la bibliothèque… On peut signaler le plugin autozotbib qui permet d'automatiser l'export, après les modifications de sa bibliothèque.

Ci-dessous un extrait de fichier .bib :

@article{gilmour_reference_2011,
	title = {Reference management software : a comparative analysis of four products},
	issn = {10921206},
	shorttitle = {Reference Management Software},
	url = {http://www.istl.org/11-summer/refereed2.html},
	number = {66},
	urldate = {2013-02-14},
	journal = {Issues in Science \& Technology Librarianship},
	author = {Gilmour, Ron and Cobus-Kuo, Laura},
	year = {2011},
	pages = {63--75}
}

@book{jorion_prix_2010,
	address = {Bellecombe-en-Bauges},
	series = {Collection Dynamiques socio-économiques},
	title = {Le prix},
	isbn = {9782914968768},
	publisher = {Ed. du Croquant},
	author = {Jorion, Paul},
	year = {2010},
	keywords = {* anthropologie économique, * économie politique, prix - formation}
}

Pour y faire référence, il faut indiquer dans les métadonnées !!yaml!! :

- bibliography: /path/to/file.bib

J'ai mis ce fichier dans mon /home pour toujours pouvoir y faire référence facilement.

Style de citation

Par défaut c'est le style Chicago. Si l'on veut utiliser un autre style, il faut l'indiquer dans les métadonnées !!yaml!!

- csl: /path/to/file.csl

Zotero met à jour les style de manière automatique. J'ai donc créé, dans mon /home un lien symbolique vers le fichier .csl qui m'intéresse (situé dans mon profil firefox, puis zotero/styles/…).

Insertion de citations

Il suffit d'insérer dans le texte la clé de la référence (telle qu'elle est indiquée dans le file.bib), sous la forme @clé (par exemple @jorion_prix_2010). En fin de document, la bibliographie est ajoutée après le dernier titre sans contenu.

informatique/md-pandoc.1450607191.txt.gz · Dernière modification: 2018/07/29 09:08 (modification externe)