Génération de trombinoscope en pdf automatique, à partir d'une liste et d'un ensemble de photos.
- auteur: Sebastien Kramm
- statut: stabilisé en v1 (2022-09-03)
- home page: https://github.com/skramm/trombino
- licence: WTFPL
Calibré pour des groupes de 3-16..20 personnes par page, pour une année d'une promo de type universitaire (20-100 ou plus personnes, réparties en plusieurs groupes).
- bash (incluant le calculateur
bc
) - LaTeX, avec le package
tabularx
Il est possible d'utiliser le programme directement depuis le dépot cloné. Mais il est préférable de l'installer sur la machine, via:
$ sudo ./install
Ceci va copier le script dans /usr/local/bin/
et le fichier de configuration (fichier d'en-tête LaTeX) dans /etc/trombino/
.
Il faut avoir une liste des personnes, et prendre une photo par personne, dans l'ordre de la liste. En cas d'absence, il faut prendre une photo "vide", pour conserver l'ordre.
Ensuite, un petit traitement batch des photos est probablement nécessaire (recadrage, augmentation de la luminosité, conversion en N&B, etc). Ceci se fait facilement avec des outils comme Imagemagik. Dans l'idéal, il faudrait avoir des photos de quelques dizaines de ko.
Le script va générer deux fichiers pdf:
trombi_global.pdf
: trombinoscope global, sur plusieurs pages;trombi_groupes.pdf
: trombinoscope avec une page par groupe, avec les étudiants faisant partie de ce groupe.
- une liste en CSV contenant sur 3 champs:
Groupe, Nom, Prénom
A coller dans le dossier racine. Les lignes vides seront ignorées. - copier dans le dossier
photos
les photos, dans l'ordre de la liste.
Attention, il doit y avoir autant de photos que de lignes dans le fichier d'entrée!
L'exécution se fait dans un terminal ouvert dans le dossier où se trouve le fichier-liste et le dossier des photos:
$ trombino
On peut avoir les options disponibles avec:
$ trombino -h
(voir ci-dessous).
- éditer le fichier
entete_ecole.txt
et y mettre le nom de l'établissement, de la promo, etc. Sera imprimé dans l'en-tête de gauche. - éditer le fichier
entete_annee.txt
et y mettre l'année en cours (ou ce que vous voulez d'autre!). Sera imprimé dans l'en-tête de droite.
Des valeurs par défaut sont prévues, mais on peut passer des options pour les modifier.
$ trombino [-hs] [-l fichier_liste] [-p dossier_photos] [-o nom_pdf] [-c nb_cols]
-l
: pour spécifier un autre nom du fichier csv d'entrée (liste des étudiants)-p
: pour indiquer un autre dossier pour les photos-o
: pour donner un autre nom au fichier pdf généré (sans extension!!)
Par exemple,-o aaa
produira les deux fichiersaaa_global.pdf
etaaa_groupes.pdf
-c
: pour modifier le nombre de colonnes. La taille des photos est automatiquement ajustée.-s
: permute nom - prénom-h
: affiche cette aide-d
: active le mode "debug", ce qui imprimera le nom du fichier de la photo avec la photo (utile en cas d'erreur nom/photo)
Des données de démo dont incluses, vous pouvez tester directement. Il y a:
- une liste de noms (thx: https://fossbytes.com/tools/random-name-generator)
- une liste de "photos" (thx: https://multiavatar.com/)
Ces avatars sont générés via le script
gen_avatars.sh
(requires Imagemagick)
Tapez la commande suivante dans le dossier racine, une fois le repo cloné:
$ ./trombino
Ceci doit vous donner dans un fichier trombi.pdf
, similaire à celui qui est fourni (trombi_exemple.pdf
).
Vous pouvez aussi essayer ceci pour voir les mêmes données en 5 colonnes:
$ ./trombino -c 5