Vous pouvez utiliser pandoc sous Linux pour convertir entre plus de 40 formats de fichiers. Vous pouvez également l'utiliser pour créer un système simple de documents en tant que code en écrivant dans Markdown, en le stockant dans gitet la publication dans l'un de ses formats pris en charge.
Si vous avez un document dans l'un des pandoc's de nombreux formats de fichiers pris en charge, le convertir en n'importe lequel des autres est un jeu d'enfant. C’est un outil pratique à avoir!
Mais le vrai pouvoir de pandoc devient évident lorsque vous l'utilisez comme base d'un système de docs-as-code simple. Le principe de docs-as-code est d'adopter certaines des techniques et des principes du développement logiciel et de les appliquer à la rédaction de la documentation, en particulier pour les projets de développement logiciel. Vous pouvez cependant l'appliquer au développement de tout type de documentation.
Les développeurs de logiciels utilisent leur éditeur préféré ou environnement de développement intégré (IDE) pour écrire leurs programmes. Le code qu'ils saisissent est enregistré dans des fichiers texte. Ceux-ci contiennent le code source pour le programme.
Ils utilisent un système de contrôle de versionou VCS (Git est le plus populaire), pour capturer les modifications apportées au code source au fur et à mesure de son développement et de son amélioration. Cela signifie que le programmeur a un historique complet de toutes les versions des fichiers de code source. Il ou elle peut accéder rapidement à n'importe quelle version précédente d'un fichier. Git stocke les fichiers dans un référentiel. Il existe un référentiel local sur l'ordinateur de chaque développeur et un référentiel central, partagé et distant, souvent hébergé dans le cloud.
Lorsqu'ils sont prêts à produire une version de travail du programme, ils utilisent un compilateur pour lire le code source et générer un exécutable binaire.
En écrivant vos documents dans un langage de balisage léger basé sur du texte, vous pouvez utiliser un VCS pour contrôler la version de votre écriture. Lorsque vous êtes prêt à distribuer ou publier un document, vous pouvez utiliser pandoc pour générer autant de versions différentes de votre documentation que vous le souhaitez, y compris sur le Web (HTML), traitement de texte ou composition (LibreOffice, Microsoft Word, Texas), Portable Document Format (PDF), livre électronique (ePub), etc.
Vous pouvez faire tout cela à partir d'un ensemble de fichiers texte légers contrôlés par version.
À installer pandoc sur Ubuntu, utilisez cette commande:
sudo apt-get install pandoc
Sur Fedora, la commande dont vous avez besoin est la suivante:
sudo dnf install pandoc
Sur Manjaro, vous devez taper:
sudo pacman -Syu pandoc
Vous pouvez vérifier la version que vous avez installée en utilisant le --version option:
pandoc --version
Si tu utilises pandoc sans aucune option de ligne de commande, il accepte également les entrées tapées. Vous appuyez simplement sur Ctrl + D pour indiquer que vous avez terminé de taper. pandoc s'attend à ce que vous tapiez au format Markdown, et il génère une sortie HTML.
Regardons un exemple:
pandoc
Nous avons tapé quelques lignes de Markdown et sommes sur le point d'appuyer sur Ctrl + D.
Dès que nous le faisons, pandoc génère la sortie HTML équivalente.
Pour faire quelque chose d'utile avec pandoc, cependant, nous devons vraiment utiliser des fichiers.
Markdown est un langage de balisage léger, et une signification particulière est donnée à certains caractères. Vous pouvez utiliser un éditeur de texte brut pour créer un fichier Markdown.
Markdown peut être lu facilement, car il n'y a pas de balises visuellement encombrantes pour distraire du texte. Le formatage dans les documents Markdown ressemble au formatage qu'il représente. Voici quelques principes de base:
* Cela sera souligné *** Ce sera en gras **#). Le texte est séparé du hachage par un espace. Utilisez un hachage pour un en-tête de niveau supérieur, deux pour un deuxième niveau, etc.()) et l'URL entre parenthèses (()) ainsi: (Lien vers How to Geek) (https://www.howtogeek.com/).! ()). Tapez tout texte alternatif pour l'image entre crochets. Ensuite, placez le chemin d'accès à l'image entre parenthèses (()“). Voici un exemple: ! (Le Geek) (HTG.png).Nous couvrirons plus d'exemples de tous ces éléments dans la section suivante.
EN RELATION: Qu'est-ce que le Markdown et comment l'utilisez-vous?
Les conversions de fichiers sont simples. pandoc peut généralement déterminer les formats de fichiers avec lesquels vous travaillez à partir de leurs noms de fichiers. Ici, nous allons générer un fichier HTML à partir d'un fichier Markdown. le -o (sortie) indique pandoc le nom du fichier que nous souhaitons créer:
pandoc -o sample.html sample.md
Notre exemple de fichier Markdown, sample.md, contient la courte section de Markdown montrée dans l'image ci-dessous.
Un fichier appelé sample.html est créé. Lorsque nous double-cliquez sur le fichier, notre navigateur par défaut l'ouvre.
Maintenant, générons un Format de document ouvert document texte que nous pouvons ouvrir LibreOffice Writer:
pandoc -o sample.odt sample.md
Le fichier ODT a le même contenu que le fichier HTML.
Une touche nette est le texte alternatif pour l'image est également utilisé pour générer automatiquement une légende pour la figure.
le -F (de) et -t (à) les options sont utilisées pour dire pandoc vers quels formats de fichier vous souhaitez convertir et vers. Cela peut être utile si vous travaillez avec un format de fichier qui partage une extension de fichier avec d'autres formats associés. Par exemple, Texas, et Latex les deux utilisent l'extension «.tex».
Nous utilisons également le -s (autonome) donc pandoc générera tout le préambule LaTeX requis pour qu'un document soit un document LaTeX complet, autonome et bien formé. Sans le -s (autonome), la sortie serait toujours un LaTeX bien formé qui pourrait être inséré dans un autre document LaTeX, il ne serait pas analysé correctement en tant que document LaTeX autonome.
Nous tapons ce qui suit:
pandoc -f markdown -t latex -s -o sample.tex sample.md
Si vous ouvrez le fichier "sample.tex" dans un éditeur de texte, vous verrez le LaTeX généré. Si vous avez un éditeur LaTeX, vous pouvez ouvrir le fichier TEX pour voir un aperçu de la façon dont les commandes de composition LaTeX sont interprétées. Rétrécir la fenêtre pour l'adapter à l'image ci-dessous donnait à l'écran un aspect étroit, mais en réalité, c'était bien.
Nous avons utilisé un éditeur LaTeX appelé Texmaker. Si vous souhaitez l'installer dans Ubuntu, tapez ce qui suit:
sudo apt-get install texmaker
Dans Fedora, la commande est:
sudo dnf install texmaker
À Manjaro, utilisez:
sudo pacman -Syu texmaker
Vous commencez probablement à comprendre la flexibilité pandoc fournit. Vous pouvez écrire une fois et publier dans presque tous les formats. C’est un grand exploit, mais les documents semblent un peu vanillés.
Avec les modèles, vous pouvez dicter quels styles pandoc utilise lorsqu'il génère des documents. Par exemple, vous pouvez dire pandoc d'utiliser les styles définis dans un Feuilles de style en cascade (CSS) avec le --css option.
Nous avons créé un petit fichier CSS contenant le texte ci-dessous. Il modifie l'espacement au-dessus et en dessous de l'en-tête de niveau d'un style. Il change également la couleur du texte en blanc et la couleur d'arrière-plan en une nuance de bleu:
h1 {
couleur: #FFFFFF;
couleur de fond: # 3C33FF;
margin-top: 0px;
marge en bas: 1px;
}
La commande complète est ci-dessous – notez que nous avons également utilisé l'option autonome (-s):
pandoc -o sample.html -s --css sample.css sample.md
pandoc utilise le style unique de notre fichier CSS minimaliste et l'applique à l'en-tête de niveau un.
Une autre option de réglage précis dont vous disposez lorsque vous travaillez avec des fichiers HTML consiste à inclure le balisage HTML dans votre fichier Markdown. Cela sera transmis au fichier HTML généré en tant que balisage HTML standard.
Cependant, cette technique doit être réservée lorsque vous ne générez qu'une sortie HTML. Si vous travaillez avec plusieurs formats de fichiers, pandoc ignorera le balisage HTML pour les fichiers non HTML et sera transmis à ceux-ci sous forme de texte.
Nous pouvons également spécifier les styles utilisés lors de la génération des fichiers ODT. Ouvrez un document LibreOffice Writer vierge et ajustez les styles de titre et de police en fonction de vos besoins. Dans notre exemple, nous avons également ajouté un en-tête et un pied de page. Enregistrez votre document sous le nom «odt-template.odt».
Nous pouvons maintenant l'utiliser comme modèle avec le --reference-doc option:
pandoc -o sample.odt --reference-doc = odt-template.odt sample.md
Comparez cela avec l'exemple ODT précédent. Ce document utilise une police différente, a des en-têtes colorés et comprend des en-têtes et des pieds de page. Cependant, il a été généré à partir du même fichier Markdown "sample.md".
Les modèles de document de référence peuvent être utilisés pour indiquer différentes étapes de la production d'un document. Par exemple, vous pourriez avoir des modèles qui ont des filigranes «Brouillon» ou «Pour révision». Un modèle sans filigrane serait utilisé pour un document finalisé.
Par défaut, pandoc utilise le moteur PDF LaTeX pour générer des fichiers PDF. Le moyen le plus simple de vous assurer que les dépendances LaTeX appropriées sont satisfaites est d'installer un éditeur LaTeX, tel que Texmaker.
C'est une grosse installation, cependant – Tex et LaTeX sont tous les deux assez lourds. Si votre espace sur le disque dur est limité ou si vous savez que vous n'utiliserez jamais TeX ou LaTeX, vous préférerez peut-être générer un fichier ODT. Ensuite, vous pouvez simplement l'ouvrir dans LibreOffice Writer et l'enregistrer au format PDF.
L'utilisation de Markdown comme langue d'écriture présente plusieurs avantages, notamment les suivants:
gedit , Vigueur , et Emacs, utilisez la coloration syntaxique avec le texte Markdown.EN RELATION: Qu'est-ce que GitHub et à quoi sert-il?
Il y a beaucoup plus d'options et de fonctionnalités dans pandoc que ce que nous avons couvert ici. Les processus de conversion pour la plupart des types de fichiers peuvent être modifiés et affinés. Pour en savoir plus, consultez les excellents exemples sur le site officiel (et extrêmement détaillés) page web pandoc.