Outils pour utilisateurs

Outils du site


informatique:md-pandoc

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
informatique:md-pandoc [2015/02/01 09:49]
igor [PDF]
informatique:md-pandoc [2018/07/29 09:08] (Version actuelle)
Ligne 18: Ligne 18:
 On peut utiliser le plugin [[https://github.com/plasticboy/vim-markdown|vim-markdown]] (attention notamment à insérer ''let g:vim_markdown_folding_disabled=1'' dans le ''.vimrc'' pour éviter le repli). On peut utiliser le plugin [[https://github.com/plasticboy/vim-markdown|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''.+<del>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''.</del> 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'' : 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   au BufRead,BufNewFile *.md set filetype=markdown
- 
- 
- 
  
 ===== Commandes ===== ===== Commandes =====
Ligne 47: Ligne 44:
 Il est également possible de choisir le moteur LaTeX : ''--latex-engine=xelatex'', par exemple. 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
 +
 +==== Microsoft Office, Word ====
 +
 +Il n'y a pas de //template// pour Word. Par défaut, ce doit être le //template// pour LibreOffice (''.opendocument''). Mais il bien entendu possible d'utiliser un modèle :
 +
 +   pandoc -t docx --reference-docx [file.docx|file.dotx] -o outputfile.docx inputfile.md
      
  
 ===== Citations ===== ===== Citations =====
  
-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.+La documentation officielle sur le sujet est à l'URL suivante : http://pandoc.org/README.html#citations
  
-Ce fichiers ''.bib'' peut être obtenu via [[https://www.zotero.org|Zotero]] : menu des Actions / Exporter la bibliothèque... On peut signaler le plugin [[http://www.rtwilson.com/academic/autozotbib|autozotbib]] qui permet d'automatiser l'export, après les modifications de sa bibliothèque.+==== 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 CSL JSON. 
 + 
 +Ce fichiers ''.bib'' ou ''.json'' peut être obtenu via [[https://www.zotero.org|Zotero]] : menu des Actions / Exporter la bibliothèque... On peut signaler le plugin [[https://github.com/retorquere/zotero-better-bibtex|Zotero Better Bib(La)TeX]] qui permet d'automatiser l'export, après les modifications de sa bibliothèque.
  
 Ci-dessous un extrait de fichier ''.bib'' : Ci-dessous un extrait de fichier ''.bib'' :
Ligne 81: Ligne 91:
 }</code> }</code>
  
-FIXME+Pour y faire référence, il faut indiquer dans les métadonnées !!yaml!! : 
 + 
 +<code yaml>bibliography: /path/to/file.bib</code> 
 + 
 +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!! : 
 + 
 +<code yaml>csl: /path/to/file.csl</code> 
 + 
 +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/...''). 
 + 
 +==== Liens entre la citation et la référence ==== 
 + 
 +À noter qu'il est possible de faire en sorte que l'année de la citation puisse être cliquée pour renvoyer à la référence. Pour cela, il faut activer l'option dans les métadonnées !!yaml!! : 
 + 
 +<code yaml>link-citations: true</code> 
 + 
 +==== 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. 
 + 
 +Attention : ''@jorion_prix_2010'' et ''[@jorion_prix_2010]'' auront un effet différent. La première solution considère que c'est une citation en ligne : 
 + 
 +> Jorion (2010) dit que 
 + 
 +La deuxième solution permet d'ajouter une parenthèse du type : 
 + 
 +> (Jorion 2010).
informatique/md-pandoc.1422780545.txt.gz · Dernière modification: 2018/07/29 09:08 (modification externe)