✎ pandoc [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

{{tag>Xenial bureautique LaTeX}}
----
 
====== 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.

===== 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 bash>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 bash>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 bash> 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 bash>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 bash>native, json, docx, odt, epub, epub3, fb2, html, html5, s5, slidy, slideous, dzslides, revealjs, 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 =====
 
  * [[https://enacit1.epfl.ch/markdown-pandoc/|Élaboration et conversion de documents avec Markdown et Pandoc
par Jean-Daniel Bonjour - EPFL]]
  * **(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 21/12/2017, 08:52//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : B Y V D O Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported