Ceci est une ancienne révision du document !
Les sources principales de documentation :
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).
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
.
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
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 non plus encore trouvé comment obtenir des guillemets français.
Il est également possible de choisir le moteur LaTeX : –latex-engine=xelatex
, par exemple.
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} }