Trombino

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).

Exemple de résultat (réel)

Outils nécessaires

• bash (incluant le calculateur bc)
• LaTeX, avec le package tabularx

Installation

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/.

Utilisation

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 peut générer le trombinoscope en deux formats, pdf (via LaTeX, si installé) et en HTML. Chaque format va générer deux fichiers, l'un global, avec tous les nom, l'autre classé par groupe:

• trombi_global.pdf (ou .html): trombinoscope global, sur plusieurs pages;
• trombi_groupes.pdf (ou .html): trombinoscope avec une page par groupe, avec les étudiants faisant partie de ce groupe.

(Le concept de "page" ne s'applique évidemment qu'à la version pdf)

Données d'entrées du script

• 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).

Paramétrage

• éditer le fichier head_left.txt et y mettre ce que vous souhaitez pour l'en-tête gauche (par exemple, le nom de l'établissement, de la promo, etc.)
• éditer le fichier head_right.txt et y mettre ce que vous souhaitez pour l'en-tête de droite. Si ce fichier est absent, l'année courante y sera imprimée.

Syntaxe d'appel

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 fichiers aaa_global.pdf et aaa_groupes.pdf
• -c: pour modifier le nombre de colonnes. La taille des photos est automatiquement ajustée.
• -s: permute nom - prénom
• -w: Génère les deux version en web (html)
• -x: pas de génération en pdf (utile si LaTeX pas installé)
• -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)

Exemple/demo

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