Mathieu Benoit
e1245dcc08
Badges and printed views need a PDF writer, an embedded font whose metrics the tests can measure, and the paper the machine prints on. pdf-lib with fontkit writes the sheet; Noto Sans (OFL) ships with its provenance and SHA-256, and travels into www/ with every third-party notice that the minified bundle drops. The paper is kept per machine in reglages_locaux.json. A4 and Letter derive the A6 grid from their dimensions; the PDF libraries load in two deferred chunks, each under the 1000 kB threshold. Checked: 3048 node, 639 browser and 67 long tests green from the index. --- FR --- [ADD] sorties : pdf-lib, Noto Sans, formats de papier, imposition Les badges et les vues imprimables exigent un producteur de PDF, une police embarquée que les épreuves mesurent, et le papier de la machine. pdf-lib et fontkit écrivent la planche ; Noto Sans (OFL) arrive avec sa provenance et son SHA-256, et voyage dans www/ avec chaque avis de tiers que le paquet minifié retire. Le papier se garde par machine dans reglages_locaux.json. A4 et Lettre dérivent la grille A6 de leurs dimensions ; les bibliothèques PDF se chargent en deux morceaux différés, chacun sous le seuil de 1000 ko. Vérifié : 3048 node, 639 navigateur et 67 longues vertes depuis l'index. Assisted-by: Claude Opus 5.5
68 lines
3.2 KiB
Markdown
68 lines
3.2 KiB
Markdown
# Gestion table tournante Libre
|
|
|
|
Logiciel hors ligne qui place les personnes d'un événement autour de tables et
|
|
les fait tourner sur plusieurs tours, pour que chacune rencontre le plus de
|
|
monde possible.
|
|
|
|
## Installer et lancer
|
|
|
|
| système | installer | lancer |
|
|
|---|---|---|
|
|
| Linux, macOS | `./install.sh` | `./run.sh`, ou `make` |
|
|
| Windows | `install.cmd` | `run.cmd` |
|
|
| NixOS | `./install.sh` | `./run.sh` ; `make` dans `nix-shell scripts/installation/shell.nix` |
|
|
|
|
`./install_dev.sh` (sous Windows `install_dev.cmd`) installe en plus le Chromium
|
|
des épreuves du navigateur, des polices et, sur amd64, `podman`, sous lequel se
|
|
construit l'exécutable Windows.
|
|
|
|
L'installation pose les paquets du système qui manquent — apt, dnf, zypper ou
|
|
pacman, par `sudo` —, puis Node de la majeure écrite dans `.node-version`,
|
|
téléchargé de nodejs.org et vérifié contre sa somme, hors du dépôt :
|
|
`~/.local/share/gestion_table_tournante_libre`, sous Windows
|
|
`%LOCALAPPDATA%\gestion_table_tournante_libre`. Node n'exige donc aucun droit
|
|
d'administration. Sous NixOS, `scripts/installation/shell.nix` déclare Node,
|
|
Electron et Chromium, d'un nixpkgs épinglé.
|
|
|
|
Systèmes éprouvés, en conteneurs, par `make verifier_systemes` : Ubuntu 24.04,
|
|
25.10 et 26.04, Debian 12 et 13 (Proxmox VE 9 en dérive), Fedora 41 à 44,
|
|
AlmaLinux et Rocky Linux 9 et 10, openSUSE Leap 16.0 et Tumbleweed, Arch Linux,
|
|
et Nix ; les scripts Windows sous `pwsh`.
|
|
|
|
`./run.sh` lance la coquille Electron sur une session graphique ; sans écran,
|
|
ou là où Electron n'est pas publié (s390x, ppc64le), il sert l'application à un
|
|
navigateur sur http://localhost:5173. `./run.sh --web` et `./run.sh --electron`
|
|
forcent l'un ou l'autre.
|
|
|
|
## Commandes
|
|
|
|
| commande | effet |
|
|
|---|---|
|
|
| `make` | lance l'application, comme `./run.sh` |
|
|
| `make test` | série `node` : les fonctions pures, à chaque modification |
|
|
| `make test_long` | épreuves lourdes, avant un commit |
|
|
| `make test_navigateur` | épreuves de rendu dans Chromium, avant une livraison |
|
|
| `make build` | construit la page dans `www/` |
|
|
| `make windows` | construit l'exécutable Windows portable, sous `podman`, depuis Linux |
|
|
| `make essai_demarrage` | lance la vraie coquille Electron, lit son titre et ferme |
|
|
| `make help` | toutes les cibles |
|
|
|
|
Chaque cible passe par le Node du projet. Les commandes npm d'origine restent
|
|
valables avec un Node de la bonne majeure dans le `PATH` : `npm test`,
|
|
`npm run dev`, `npm run build`.
|
|
|
|
L'exécutable porte la version datée du logiciel dans son nom, selon le gabarit
|
|
`gestion_table_tournante_libre_v<AAAA>_<MM>_<JJ>_<NN>.exe`.
|
|
|
|
## Licence
|
|
|
|
© 2026 TechnoLibre. GNU Affero General Public License, version 3 ou ultérieure ;
|
|
texte complet dans `LICENSE`.
|
|
|
|
L'application embarque la police **Noto Sans** (Regular et Bold), sous la
|
|
**SIL Open Font License 1.1**, sans nom de police réservé : elle sert à la
|
|
planche de badges et à l'interface. Son texte est dans
|
|
`public/licences/NotoSans-OFL.txt`, sa provenance dans `src/polices/PROVENANCE`.
|
|
Les avis des paquets que la page incorpore — Svelte, pdf-lib, fontkit et ce
|
|
qu'ils tirent — sont dans `public/licences/TIERS.txt`. Les deux fichiers
|
|
voyagent avec la page, dans `www/licences/`.
|