{{tag>precise LaTeX BROUILLON}}
----
 
====== Pandoc ======
 
**Pandoc** est "le couteau suisse de la création des documents", une application en ligne de commande permettant de convertir un fichier texte balisé depuis les formats :
  * markdown, 
  * reStructuredText, 
  * textile, 
  * HTML, 
  * DocBook, 
  * [[latex|LaTeX]].
Vers les formats :
  * Formats HTML : XHTML, HTML5, et diaporama HTML Slidy, S5, ou DZSlides.
  * Formats de traitements de texte : Microsoft Word docx, OpenOffice/LibreOffice ODT, OpenDocument XML
  * Ebooks : EPUB
  * Formats de documentation : DocBook, GNU TexInfo, Groff man pages
  * TeX : LaTeX, ConTeXt, LaTeX Beamer slides
  * PDF via LaTeX
  * Formats balisés légers : Markdown, reStructuredText, AsciiDoc, MediaWiki markup, Emacs Org-Mode, Textile.
===== Pré-requis =====
 
  * Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.

===== Installation =====
 
Pour installer ce logiciel, il suffit d'[[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>pandoc]]**
 
===== Utilisation =====

==== Lancement basique ====
 
Lancez l'application via le [[:terminal]] (toutes versions d'Ubuntu) avec la [[:commande_shell|commande]] suivante :
<code>pandoc -[options] [fichier source]</code>

Par exemple, pour convertir un fichier LaTeX en DOCX :

<code>pandoc -f latex -t docx -o exemple.docx -s exemple.tex</code>

La même chose avec quelques améliorations :

<code>pandoc -f latex -t docx -o exemple.docx --biblatex --table-of-contents -s -N --natbib exemple.tex</code>


<note>Veillez à vous placer dans le répertoire du fichier avant de commencer la conversion, surtout si celui-ci contient des dépendances (images insérées par exemple). Pour ce faire, si le fichier en question se trouve dans le répertoire ''/home/utilisateur/Mon-dossier'', tapez d'abord en console:

<code> cd ~/Mon-dossier</code></note>

<note important>La conversion automatique d'un fichier texte n'est **jamais parfaite**. Pensez à bien relire et corriger le fichier de destination.</note>

==== Liste des options ====

=== -f ===
Spécifie le format d'origine du fichier. Paramètres acceptés : 

<code>native, json, markdown, markdown_strict, markdown_phpextra, markdown_mmd, rst, mediawiki, docbook, textile, html, latex</code>

=== -t ===
Spécifie le format de destination du fichier. Paramètres acceptés :

<code>native, json, docx, odt, epub, epub3, fb2, html, html5, s5, slidy, slideous, dzslides, docbook, opendocument, latex, beamer, context, texinfo, man, markdown, markdown_strict, markdown_phpextra, markdown_github, markdown_mmd, plain, rst, mediawiki, textile, rtf, org, asciidoc</code>

=== -o ===
Spécifie le nom du fichier de sortie (avec son extension). Exemple : "exemple.odt".
Pandoc va tenter de deviner le format du fichier à partir de son extension.

=== -s ===
Spécifie le fichier source (avec son extension). Exemple : "exemple.md".
Pandoc va tenter de deviner le format du fichier à partie de son extension.

=== Liste complète ===

Voyez la [[http://johnmacfarlane.net/pandoc/README.html|documentation officielle]] du programme **(en)**.

 
===== Désinstallation =====
 
Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
 
===== Voir aussi =====
 
  * **(en)** [[http://code.google.com/p/pandoc/|Page Google Code de Pandoc]]
  * **(en)** [[http://johnmacfarlane.net/pandoc|Site du développeur]]
  * [[http://pascal.peter.free.fr/pampi.html|pampi ou comment réaliser des présentations html (impress.js) en mark down !! ]]
 
----
//Contributeurs principaux : [[:utilisateurs:aurelien88|aurelien88]] Le 30/05/2012, 13:51.//