Un nom aussi beau implique une excellente description...
verbose-pancake (oui oui) est un petit outil visant à faciliter la rédaction de writeups de CTFs pour HackademINT. Il installe automatiquement pandoc et les packages nécessaires au bon fonctionnement du template latex utilisé. L'idée est de cloner ce repo à chaque fois que vous voulez créer des writeups pour un nouveau CTF !
Il suffit de lancer ./install.sh
Le script a été testé sous Debian stretch, il est donc très probable qu'il fonctionne moins bien sous d'autre distributions.
Si c'est le cas, installez manuellement les packages LaTeX manquants ;)
Toute rédaction commencer par sourcer . source.sh. Le script configure quelques variables d'environnement et alias pour rédiger tranquillement.
Les commandes utiles sont les suivantes :
mkwriteup <nom_fichier> <nom_chall>dont les arguments sont le nom souhaité pour le fichier et le nom (joli) du challgenpdfsans argument, qui génère le pdf du fichier Markdown dans le dossier courant
- Vous clonez le dépot
git clone https://github.com/Frazew/verbose-pancake.git. - Vous exécutez
./install.shet indiquez le nom du CTF et votre pseudo. - Vous sourcez
source.shavec. source.sh - Vous exécutez
mkwriteup example_writeup1 "Example de writeup 1". - Vous modifiez example_writeup1.md comme vous voulez
- Vous générez le pdf avec
genpdf - ???
- Enjoy!
- (Retour à l'étape 4 pour faire d'autres writeups sur ce même ctf)
En Markdown, il est possible de spécifier qu'un bout de texte doit être traité comme du "code" avec la syntaxe `mon code`.
pandoc va alors gérer automatiquement la mise en forme syntaxique en fonction du langage détecté, ce qui peut s'avérer gênant.
Il est possible de préciser le langage utilisé : `moncode`{.java}, mais pas de désactiver complètement la mise en forme, ce qui sert par exemple pour afficher une simple commande.
Ce template s'en chargera, tout code de la forme `moncode`{.bash} sera traité comme une ligne de commande et affiché en tant que tel !