tools

Les outils qui dessinent ce README

Aucune image de ce dépôt n'est un export d'un logiciel de dessin. Chacune est une page HTML que Chrome capture en mode headless, à deux ou trois fois la taille d'affichage pour rester nette sur un écran dense. Un texte de figure se corrige donc en modifiant une ligne de script.

Refaire toutes les images

bash docs/tools/tout.sh

Cela rend les deux langues. Les scripts écrivent dans docs/tools/png/, sec/, som/, grid/, tree/ et langues/, suffixés -en pour l'anglais, qui ne sont pas versionnés. installer.sh recopie ensuite les fichiers retenus dans docs/ et docs/en/.

Les deux langues

README.md porte le français, README.en.md l'anglais, et chaque page ouvre sur deux pastilles qui mènent à l'autre. GitHub retirant JavaScript et CSS des README, rien ne peut basculer la page sur place : ce sont deux fichiers et un lien.

langue.sh porte la bascule. Dans figures.sh, t <français> <anglais> choisit la chaîne : les deux versions d'un texte vivent sur la même ligne, ce qui rend impossible d'en corriger une en oubliant l'autre.

Ce que fait chaque script

• figures.sh : la bannière, les seize bandeaux de section, du 00 Sommaire au 15, et la grille des trois pièces.
• sommaire.sh : les quinze tuiles du sommaire, une image par tuile pour que chacune mène à sa section.
• anime.js : les dix-huit schémas, en SVG que GitHub joue dans une balise <img>. node docs/tools/anime.js, et LANGUE=en pour l'anglais. La vitrine embarque les six captures de vitrine/, de vrais écrans de la démo en JPEG 480 px ; la carte des lieux lit assets/lieux.json et refait le tirage de lib/domain/jour.dart. La planche ecrans.svg reprend les mêmes captures, fixes ; les chiffres de la stack, des couches et des tests sont relevés dans pubspec.yaml, lib/ et test/, et sont à mettre à jour avec eux.
• cartes.sh : le gabarit des bannières 1280x320.
• bandeaux.sh : le gabarit des bandeaux de section numérotés.
• grille.sh : le gabarit des grilles à deux ou trois colonnes.
• arbre.sh : le gabarit des arborescences, dont les traits de liaison sont calculés et non écrits à la main.
• pastilles.sh : les deux pastilles du sélecteur de langue.
• langue.sh : la bascule LANGUE et la fonction t.
• installer.sh : repose les images rendues dans docs/ ou docs/en/.
• telecharger.sh : le bouton de téléchargement, lien vers le dernier APK des Releases.
• social.sh : l'aperçu social 1280x640, à déposer à la main dans les réglages du dépôt.
• tout.sh : enchaîne tout ce qui précède, dans les deux langues.

Ce dont ils dépendent

Chrome est cherché dans C:\Program Files\Google\Chrome\Application. La variable d'environnement CHROME prend le dessus s'il est ailleurs.

Les polices, Syne, Space Grotesk et JetBrains Mono, sont chargées depuis Google Fonts au moment du rendu : il faut une connexion.

Les captures de vitrine/ sont de vraies captures de l'application, en français : tool/ecran.sh shot sur l'émulateur, puis réduites en JPEG. Aucun rendu ne les refait.