Préface
Markdown est un excellent moyen d'écrire un petit article, et parfois un texte assez volumineux, avec une mise en forme simple en italique et en gros caractères. Markdown est également bon pour écrire des articles avec le code source inclus. Mais parfois, je veux le transférer dans un fichier PDF régulier et bien conçu sans pertes, danser avec un tambourin, et pour qu'il n'y ait pas de problèmes pendant la conversion, qui, par exemple, étaient les miens - vous ne pouvez pas écrire en russe dans les commentaires du code source, les lignes trop longues ne sont pas transférées, mais d'autres problèmes mineurs sont supprimés. L'instruction vous permettra de configurer rapidement le convertisseur md2pdf sans particulièrement comprendre comment il fonctionne. Le script pour une installation moins automatique est ci-dessous dans la section appropriée.
Installer TexLive
Bien sûr, vous ne pouvez installer que les parties nécessaires de ce package. Mais personnellement, j'étais franchement paresseux pour rechercher l'installation de travail minimale nécessaire. Pour que tout fonctionne, installez l'intégralité du package TexLive. Il est appelé texlive-full et pèse un peu plus de 2 gigaoctets, gardez cela à l'esprit. Nous exécutons la commande:
user@hostname:~$ sudo apt install texlive-full -y
Après une installation suffisamment longue, vous pouvez passer à l'étape suivante.
Installer Pandoc Converter
Pandoc est un package Linux qui vous permet de convertir certains formats de texte en d'autres. Il possède de nombreuses fonctionnalités intéressantes que vous pouvez vous familiariser sur Internet. Nous ne sommes intéressés que par la possibilité de convertir un fichier de démarque en PDF. Vérifiez si Pandoc est installé et sinon, installez-le. Par exemple, comme ceci:
user@hostname:~$ dpkg -s pandoc
Si la sortie indique qu'elle n'est pas installée - installez:
user@hostname:~$ sudo apt install pandoc -y
Installer MD2PDF
Vous pouvez accéder à la page de script sur GitHub, puis procéder selon les instructions.
Ou téléchargez l' archive , décompressez-la dans n'importe quel dossier, ouvrez-la dans le terminal et suivez à nouveau les instructions.
Ouvrez un terminal et faites:
git clone https://github.com/melichron/md2pdf.git && cd md2pdf
Exécutez ensuite en tant que root, par exemple:
sudo ./install.sh
Gardez à l'esprit que le script utilise un utilitaire pour créer des boîtes de dialogue whiptail de console. Si vous ne l'avez pas installé, ou si vous ne voulez pas l'installer, ou si vous voulez tout faire vous-même, installez manuellement texlive-full et pandoc et suivez les instructions plus loin.
Installez md2pdf pour tous les utilisateurs:
root@host:~/md2pdf# cp ./src/template.tex $(kpsewhich -expand-var='$TEXMFLOCAL') root@host:~/md2pdf# echo "#!/bin/bash" | tee usr/local/bin/md2pdf root@host:~/md2pdf# echo "pandoc --output=\$1.pdf --from=markdown_github --latex-engine=pdflatex --listings --template=$(kpsewhich -expand-var='$TEXMFLOCAL')/template.tex \$1" | tee -a usr/local/bin/md2pdf root@host:~/md2pdf# chmod 755 /usr/local/bin/md2pdf
Installez md2pdf pour l'utilisateur actuel:
user@host:~/md2pdf$ cp ./src/template.tex $(kpsewhich -expand-var='$TEXMFHOME') user@host:~/md2pdf$ echo "#!/bin/bash" | tee ~/.local/bin/md2pdf user@host:~/md2pdf$ echo "pandoc --output=\$1.pdf --from=markdown_github --latex-engine=pdflatex --listings --template=$(kpsewhich -expand-var='$TEXMFHOME')/template.tex \$1" | tee -a ~/.local/bin/md2pdf user@host:~/md2pdf$ chmod 755 ~/.local/bin/md2pdf
Utilisation de md2pdf
Ouvrez simplement le dossier avec le fichier Markdown ( some_file.md ) dans le terminal et exécutez la commande:
user@hostname:~$ md2pdf some_file.md
Par conséquent, le fichier some_file.md.pdf apparaît dans le dossier.
Conclusion
En fonction de la méthode décrite, vous pouvez créer n'importe quel style de fichiers PDF; vous pouvez également convertir d'autres formats au lieu de md, tous pris en charge par Pandoc. J'ose espérer qu'un jour cette instruction sera utile à 3 personnes et demie.