| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| issue142:c_c [2019/03/02 15:05] – ancienne révision (2019/02/28 11:12) restaurée auntiee | issue142:c_c [2019/03/06 17:55] (Version actuelle) – andre_domenech |
|---|
| **A few months ago, I wrote an article on using LaTeX to easily manage and track a CV. I ended up using LaTeX instead of my first choice (Markdown + HTML Stylesheets), because I had a great deal of trouble getting the page sizing working properly. Since then, I’ve learned a fair bit more, and want to share my knowledge with you!** | **A few months ago, I wrote an article on using LaTeX to easily manage and track a CV. I ended up using LaTeX instead of my first choice (Markdown + HTML Stylesheets), because I had a great deal of trouble getting the page sizing working properly. Since then, I’ve learned a fair bit more, and want to share my knowledge with you!** |
| |
| Il y a quelques mois, j'ai écrit un article sur l'utilisation de LaTeX pour gérer et mettre à jour facilement un CV. J'ai fini par utiliser LaTeX plutôt que mon premier choix (Markdown + les feuilles de styles du HTML) parce que j'avais un gros problème pour obtenir que le dimensionnement de la page fonctionne correctement. J'en ai appris un peu plus et je veux partager mes connaissances avec vous ! | Il y a quelques mois, j'ai écrit un article sur l'utilisation de LaTeX pour facilement gérer et mettre à jour un CV. J'ai fini par utiliser LaTeX plutôt que mon premier choix (Markdown + les feuilles de styles du HTML), parce que faire fonctionner le dimensionnement de la page correctement me posait de gros problèmes. J'en ai appris un peu plus et je veux partager mes connaissances avec vous ! |
| |
| **The Path | **The Path |
| Le cheminement | Le cheminement |
| |
| Peu de temps après avoir écrit l'article mentionné ci-dessus, j'ai entendu qu'Adam Wathan tape son livre « Refactoring UI » (Refaire une interface utilisateur) en Markdown et génère ses PDF à partir de ces fichiers. Il m'informa sur Twitter qu'il utilise Prince XML pour compiler les fichiers PDF. En regardant ça, je décidais que c'était une solution trop chère pour l'usage (professionnel) occasionnel que je prévoyais. Mais, ça m'a indiqué que c'était possible. Si vous cherchez un outil gratuit pour un usage personnel, Prince l'autorise bien, et ajoute juste un petit logo sur la première page. | Peu de temps après avoir écrit l'article mentionné ci-dessus, j'ai entendu qu'Adam Wathan composait son livre « Refactoring UI » (Refaire une interface utilisateur) en Markdown et générait ses PDF à partir de ces fichiers. Il m'a informé sur Twitter qu'il utilisait Prince XML pour compiler les fichiers PDF. En regardant ça, j'ai décidé que c'était une solution trop chère pour l'usage (professionnel) occasionnel que je prévoyais. Mais cela m'a démontré que c'était possible. Si vous cherchez un outil gratuit pour un usage personnel, Prince l'autorise bien, et n'ajoute qu'un petit logo sur la première page. |
| |
| À la place, j'ai filé ensuite sur alternativeto.net et cherché des alternatives à Prince XML. Trois options étaient proposées - wkhtmltopdf, PDFReactor et WeasyPrint. À PDFReactor est aussi associé un coût de licence ; aussi, je me suis concentré sur les deux autres. | À la place, j'ai filé ensuite sur alternativeto.net et cherché des alternatives à Prince XML. Trois options étaient proposées : wkhtmltopdf, PDFReactor et WeasyPrint. PDFReactor nécessite l'achat d'une licence ; aussi, je me suis concentré sur les deux autres. |
| |
| **WeasyPrint | **WeasyPrint |
| WeasyPrint | WeasyPrint |
| |
| Mon premier regard a été pour WeasyPrint, car il ressemblait beaucoup à Prince XML. Il prend un site Web et le transforme en un merveilleux PDF. Si vous avez besoin de faire des brochures, ou des documents avec des images/graphiques/icônes, ce serait probablement ma recommandation. Il n'est pas trop compliqué à paramétrer et utiliser, mais il nécessite que vous créiez un peu le fichier HTML, en incluant tous les éléments fixes et les styles. Une combinaison avec Tailwind CSS serait probablement la façon la plus rapide de créer un PDF au bel aspect. Cependant, je voulais quelque chose de similaire - juste un ensemble de fichiers MarkDown qui puissent être transformés en PDF de base, avec seulement du texte. | Mon premier regard a été pour WeasyPrint, car il ressemblait le plus à Prince XML. Il prend un site Web et le transforme en un merveilleux PDF. Si vous avez besoin de faire des brochures, ou des documents avec des images/graphiques/icônes, ce serait probablement ma recommandation. Il n'est pas trop compliqué à paramétrer et utiliser, mais il vous oblige à créer le fichier HTML d'une façon ou d'une autre, en incluant tous les éléments fixes et les styles. Une combinaison avec Tailwind CSS serait probablement la façon la plus rapide de créer un PDF au bel aspect. Cependant, je voulais quelque chose de similaire, juste un ensemble de fichiers MarkDown qui puissent être transformés en PDF de base, avec seulement du texte. |
| |
| **wkhtmltopdf | **wkhtmltopdf |
| wkhtmltopdf | wkhtmltopdf |
| |
| Le moteur peut être utilisé avec Pandoc (que j'ai utilisé avant pour transformer des fichiers .docx en MarkDown) et il peut prendre directement des fichiers MarkDown ; et, avec une seule commande, il génère le HTML puis le PDF. Vous pouvez inclure des fichiers CSS et beaucoup d'autres options. J'admets que je n'ai pas trouvé trop de guides faciles à suivre et j'ai trouvé que leur documentation est confuse quand vous avez peu d'expérience de pandoc. Remarque, pandoc supporte aussi weasyprint. | Ce moteur peut être utilisé avec Pandoc (que j'ai déjà utilisé pour transformer des fichiers .docx en MarkDown). Il peut prendre directement des fichiers MarkDown et, avec une seule commande, il génère le HTML puis le PDF. Vous pouvez inclure des fichiers CSS et beaucoup d'autres options. J'admets que je n'ai pas encore trouvé trop de guides faciles à suivre et je pense que leur documentation est confuse quand vous avez peu d'expérience de pandoc. Remarque, pandoc supporte aussi weasyprint. |
| |
| **Reddit to the Rescue | **Reddit to the Rescue |
| Reddit à la rescousse | Reddit à la rescousse |
| |
| Comme je n'ai fait que des tests rapides, je n'ai pas eu le temps de m'investir dans la création de styles décents pour chacun des outils, spécialement car c'était là où j'ai eu le plus de problèmes initialement. À la place, je ai mis ça de côté et j'ai continué à travailler sur mes divers autres projets. Ceci, jusqu'à la fin de la première semaine de février, quand un utilisateur a posté un message à propos de /r/unixporn subreddit de Reddit. Son paramétrage inclut un très joli PDF généré à partir d'un fichier MarkDown à l'aspect ordinaire. À l'affût dans les commentaires, j'ai trouvé quelqu'un qui avait déjà posé la question du « comment ? ». | Comme je n'ai fait que quelques tests rapides, je n'ai pas eu le temps de m'investir dans la création de styles décents pour l'un ou l'autre des outils, surtout parce que c'est là où j'ai eu le plus de problèmes initialement. À la place, je l'ai mis de côté et j'ai continué à travailler sur mes divers autres projets. Et ce, jusqu'à la première semaine de février, quand un utilisateur a posté un message à propos de /r/unixporn subreddit de Reddit. Son paramétrage incluait un très joli PDF généré à partir d'un fichier MarkDown à l'aspect ordinaire. En parcourant les commentaires, j'ai trouvé quelqu'un qui avait déjà posé la question du « comment ? ». |
| |
| Eh ! Bien ! Il apparaît que c'était pandoc + wkhtmltopdf. En suivant dans la boîte de dialogue (et la recommandation de tufte-css), j'ai compilé avec succès quelques fichiers faciles en MarkDown en fichiers PDF utilisables et lisibles. | Eh bien..., il s'avère que c'était pandoc + wkhtmltopdf. En suivant dans la boîte de dialogue (et la recommandation de tufte-css), j'ai compilé avec succès quelques fichiers simples en MarkDown en fichiers PDF utilisables et lisibles. |
| |
| **Why? | **Why? |
| Pourquoi ? | Pourquoi ? |
| |
| J'ai beaucoup entendu cette question quand on arrivait sur des sujets que je passe mon temps à investiguer. La réponse pour celui-ci est aussi très ordinaire - l'efficacité. Comme développeur, je dois souvent écrire de la documentation et faire des notes sur des processus ou autres. Quand je m'attends à avoir 5 pages de documentation (particulièrement avec des images, un index, etc), je préfère Sphinx. Celui-ci est vraiment utile, car je peux sortir en LaTeX, PDF, ePub ou HTML (entre autres). Suivant les besoins de mon client, je peux lui compiler les mêmes fichiers dans n'importe quelle combinaison de formats dont il pourrait avoir besoin. | J'ai beaucoup entendu cette question à propos des sujets que je passe mon temps à investiguer. La réponse à celle-ci est aussi très ordinaire : l'efficacité. Comme développeur, je dois souvent écrire de la documentation et faire des notes sur des processus ou autres. Quand je m'attends à avoir 5 pages de documentation (surtout avec des images, un index, etc.), je préfère Sphinx. Celui-ci est vraiment utile, car je peux sortir en LaTeX, PDF, ePub ou HTML (entre autres). Suivant les besoins de mon client, je peux compiler les mêmes fichiers dans n'importe quelle combinaison de formats dont il pourrait avoir besoin. |
| |
| Cependant, si je n'envisage peut-être qu'une unique page de documentation, paramétrer Sphinx est une énorme perte de temps dans ce genre de situation. Particulièrement si ce n'est pas pour un client et que je veux juste garder une trace d'un processus que j'ai utilisé. Je tends à écrire ceci en MarkDown (même avant que je puisse le compiler facilement en PDF) parce que, parfois, je veux regrouper des sujets variés ou l'ajouter à ma documentation interne (qui est en HTML créé à partir de MarkDown). Ainsi donc, écrire des courtes notes en MarkDown a toujours été ma première approche. Maintenant, je peux compiler le MarkDown en HTML (comme d'habitude), mais aussi en PDF pour un stockage à long terme ou un partage. | Cependant, si je n'envisage qu'une unique page de documentation, paramétrer Sphinx est une énorme perte de temps. Particulièrement si ce n'est pas pour un client et que je veux juste garder une trace d'un processus que j'ai utilisé. Je tends à écrire ce genre de choses en MarkDown (même avant que je puisse le compiler facilement en PDF), parce que, parfois, je veux regrouper des sujets variés ou l'ajouter à ma documentation interne (qui est en HTML créé à partir de MarkDown). Ainsi, donc, écrire des courtes notes en MarkDown a toujours été ma première approche. Maintenant, je peux compiler le MarkDown en HTML (comme d'habitude), mais aussi en PDF pour un stockage à long terme ou un partage. |
| |
| **I also find Markdown much faster to type and format than anything like Google Drive, Microsoft Word, or Pages documents, since formatting is taken care of with just a few characters, instead of memorizing ever-changing (between the various applications) shortcuts, or having to use the mouse to select individual styles and settings. Best of all, Markdown is repeatable. I can write a dozen documents, and format them all the same way at the same time with one CSS file.** | **I also find Markdown much faster to type and format than anything like Google Drive, Microsoft Word, or Pages documents, since formatting is taken care of with just a few characters, instead of memorizing ever-changing (between the various applications) shortcuts, or having to use the mouse to select individual styles and settings. Best of all, Markdown is repeatable. I can write a dozen documents, and format them all the same way at the same time with one CSS file.** |
| |
| J'ai trouvé aussi que le MarkDown est beaucoup plus rapide à saisir et à formater que d'autres, comme les documents Google Drive, Microsoft Word ou Page, car le formatage est réalisé avec juste quelques caractères, au lieu de mémoriser des raccourcis toujours changeants (d'une application à l'autre), ou en devant utiliser la souris pour sélectionner les styles individuels et les paramètres. Le meilleur de tout, c'est que MarkDown est répétable. Je peux écrire une douzaine de documents et les formater tous de la même manière au même moment avec un seul fichier CSS. | Je trouve aussi que le MarkDown est beaucoup plus rapide à saisir et à formater que d'autres, comme les documents Google Drive, Microsoft Word ou Page, car le formatage est réalisé avec quelques caractères, au lieu de devoir mémoriser des raccourcis toujours changeants (d'une application à l'autre), ou en devant utiliser la souris pour sélectionner les styles individuels et les paramètres. Le meilleur c'est que MarkDown est répétable. Je peux écrire une douzaine de documents et les formater tous de la même manière au même moment avec un seul fichier CSS. |
| |
| **How? | **How? |
| Comment ? | Comment ? |
| |
| C'est surprenant de simplicité. En utilisant les liens de la section « Pour aller plus loin », assurez-vous que vous avez téléchargé le fichier Tufte CSS et les polices (ou n'importe quel fichier CSS que vous souhaitez utiliser), et sauvez-les quelque part. Après ça, faîtes vous-même un fichier en MarkDown que vous aimeriez convertir. Puis, utilisez la formule ci-dessous : | C'est surprenant de simplicité. En utilisant les liens de la section « Pour aller plus loin », assurez-vous que vous avez téléchargé le fichier Tufte CSS et les polices (ou n'importe quel fichier CSS que vous souhaitez utiliser), et sauvegardez-les quelque part. Après cela, faites un fichier en MarkDown que vous aimeriez convertir. Puis utilisez la commande ci-dessous : |
| |
| pandoc -f markdown -t html5 ./fcm-notes/pandoc.md --pdf-engine wkhtmltopdf --css tufte.css -o "pandoc.pdf" | pandoc -f markdown -t html5 ./fcm-notes/pandoc.md --pdf-engine wkhtmltopdf --css tufte.css -o "pandoc.pdf" |
| Les options se comprennent facilement : -f pour le format d'entrée (« from », à partir de), -t pour le format cible (« to », vers), --pdf-engine pour le moteur à utiliser, --css pour le fichier CSS cible, -o pour le nom du fichier de sortie (« output », sortie). | Les options se comprennent facilement : -f pour le format d'entrée (« from », à partir de), -t pour le format cible (« to », vers), --pdf-engine pour le moteur à utiliser, --css pour le fichier CSS cible, -o pour le nom du fichier de sortie (« output », sortie). |
| |
| Vous pouvez aussi faire plus compliqué en créant un script pour viser un fichier particulier, ou un bash pour accélérer le processus de compilation de fichier. Quoi qu'il en soit, ceci vous permettra de démarrer ! | Vous pouvez aussi faire plus compliqué en créant un script pour viser un fichier particulier, ou un alias bash pour accélérer le processus de compilation de fichier. Quoi qu'il en soit, ceci vous permettra de démarrer ! |
| |
| **Future | **Future |
| Now that I have the Markdown -> PDF workflow working, I will see about using pandoc to convert Markdown into Doc formats. This way, I can start writing Markdown files for articles, and host them internally as a website for easy searching, instead of hunting through a folder of Word and google documents.** | Now that I have the Markdown -> PDF workflow working, I will see about using pandoc to convert Markdown into Doc formats. This way, I can start writing Markdown files for articles, and host them internally as a website for easy searching, instead of hunting through a folder of Word and google documents.** |
| |
| Futur | L'avenir |
| |
| Maintenant que je dispose d'une enchaînement du MarkDown vers le PDF qui marche, je me mettrai à utiliser pandoc pour convertir du MarkDown aux formats Doc. De cette façon, je peut commencer à écrire des fichiers MarkDown pour des articles et les accueillir en interne comme des sites Web pour une recherche facile, plutôt que les pister dans un dossier plein de documents Word ou Google. | Maintenant que je dispose d'une enchaînement du MarkDown vers le PDF qui fonctionne, j'envisagerai d'utiliser pandoc pour convertir du MarkDown aux formats Doc. De cette façon, je peux commencer à écrire des fichiers MarkDown pour des articles et les héberger en interne comme des sites Web pour une recherche facile, plutôt que les pister dans un dossier plein de documents Word ou Google. |
| |
| **Conclusion | **Conclusion |
| Conclusion | Conclusion |
| |
| Alors que pandoc peut faire une énorme quantité de choses, un début avec quelques options simples (mais puissantes) semblent le mieux. De là, vous pouvez passer à la création de diaporamas en reveal.js, ou un grand nombre d'autres formats. L'avez-vous déjà utilisé ? Ou vous sentez-vous inspiré pour l'utiliser maintenant ? Sentez-vous libre de partager n'importe quel cas d'utilisation fantastique avec moi par mail. Ou joignez-moi par lswest34+fcm@gmail.com avec vos recommandations, questions ou demandes d'articles. | Bien que Pandoc puisse faire une énorme quantité de choses, un début avec quelques options simples (mais puissantes) semblent le mieux. De là, vous pouvez passer à la création de diaporamas en reveal.js, ou un grand nombre d'autres formats. L'avez-vous déjà utilisé ? Ou aimeriez-vous l'utiliser maintenant ? N'hésitez pas à partager n'importe quel cas d'utilisation fantastique avec moi par mail. Ou écrivez-moi à lswest34+fcm@gmail.com avec vos recommandations, questions ou demandes d'articles. |
| |
| **Further Reading | **Further Reading |
