| Les deux révisions précédentesRévision précédente | |
| issue142:c_c [2019/03/02 15:32] – auntiee | issue142:c_c [2019/03/06 17:55] (Version actuelle) – andre_domenech |
|---|
| Le cheminement | Le cheminement |
| |
| 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, je décidais 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. | 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 nécessite l'achat d'une 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 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. | 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 |
| Reddit à la rescousse | Reddit à la rescousse |
| |
| 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'était 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 ? ». | 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 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. | 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 à 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. | 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 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. | 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.** |
| |
| 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. | 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 cela, faîtes un fichier en MarkDown que vous aimeriez convertir. Puis, utilisez la commande 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" |
| L'avenir | L'avenir |
| |
| 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 peut 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. | 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 |
