gestion_table_tournante_libre/GUIDE-WINDOWS.md

Gestion table tournante Libre sous Windows

Ce guide dit comment obtenir le logiciel, le lancer, où il range vos événements, comment les sauvegarder, quoi faire si un antivirus le bloque, où lire sa version et comment signaler un problème. Le déroulement d’une soirée, de la liste des participants à l’impression, est dans GUIDE-USAGE.md.

Ce guide n’a pas d’images : les écrans qu’il décrit sont ceux de Windows, et les captures du guide d’usage sont prises ailleurs.

Obtenir l’exécutable

Le logiciel tient en un seul fichier, un exécutable portable : il n’y a rien à installer, et il ne demande aucun droit d’administrateur. Il fonctionne sans connexion à Internet.

Vous le recevez de la personne ou de l’organisme qui vous le fournit, sur une clé, par courriel ou dans un dossier partagé. Son nom suit le gabarit gestion_table_tournante_libre_v<AAAA>_<MM>_<JJ>_<NN>.exe : <AAAA>, <MM> et <JJ> sont l’année, le mois et le jour de la version, <NN> son rang dans la journée. Cherchez donc le fichier dont le nom commence par gestion_table_tournante_libre_v ; ce qui suit change à chaque version, et le nom ne porte qu’un seul point, celui de .exe.

Rangez l’exécutable dans le dossier où vous voulez garder vos événements, par exemple un dossier à vous sur le disque ou sur une clé USB : le logiciel essaie d’écrire à côté de lui (voir « Le dossier de travail »). Évitez de le lancer directement depuis une pièce jointe ou depuis une archive ouverte sans l’extraire : Windows le place alors dans un dossier temporaire, et vos événements iraient dans vos Documents.

Passer à une version plus récente. Lisez d’abord, dans CHANGELOG.md, ce que la nouvelle version change et ce qu’il faut faire en remplaçant. Posez le nouvel exécutable dans le même dossier que l’ancien : il retrouve le même dossier de travail et les mêmes événements. Gardez l’ancien tant que la nouvelle version n’a pas fait ses preuves. Un fichier écrit par une version plus ancienne s’ouvre normalement, et le bandeau annonce qu’il se convertira à votre première modification ; un fichier écrit par une version plus récente s’ouvre en lecture seule.

Le lancer

Double-cliquez sur l’exécutable. Le démarrage prend quelques secondes : le fichier se décompresse à chaque lancement. Au tout premier lancement, Windows peut afficher un avertissement ; la section « Si l’antivirus bloque » dit comment passer.

La fenêtre s’ouvre sur la liste des événements. Elle affiche en clair le dossier de travail de la séance, sous « Dossier de travail ». Quand aucun événement n’existe encore, elle offre de créer un événement et de charger l’une des démonstrations.

Un événement s’ouvre toujours en lecture : rien ne peut le modifier par mégarde. La commande « Modifier », toujours à la même place, passe en écriture ; après un moment d’inactivité, le logiciel revient seul en lecture.

Pour quitter, fermez la fenêtre. Il n’y a rien à enregistrer : chaque geste achevé est déjà sur le disque.

Le dossier de travail

À chaque lancement, le logiciel choisit son dossier de travail par une règle fixe, puis l’affiche sur la liste des événements. La règle a deux issues :

1. Le mode portable : le dossier data à côté de l’exécutable. Le logiciel crée au besoin un dossier data dans le dossier de l’exécutable, puis vérifie qu’il peut y écrire et relire un fichier. S’il le peut, c’est son dossier de travail : l’exécutable et vos événements voyagent ensemble, et copier ce dossier suffit à tout emporter.
2. Sinon, un dossier dans vos Documents : Documents\Gestion table tournante Libre. Le logiciel le crée et dit pourquoi, une fois par lancement, sans rien bloquer. Les raisons possibles : le dossier de l’exécutable n’est pas connu ; l’exécutable est rangé sous les données applicatives de Windows ou dans un dossier temporaire ; ou le dossier data refuse l’écriture — une clé verrouillée en lecture seule, un dossier protégé comme celui des programmes, un antivirus.

Le logiciel ne range jamais vos événements dans un dossier caché.

La commande « Ouvrir dans l’explorateur », sous le chemin affiché sur la liste des événements, ouvre le dossier de travail dans l’Explorateur de fichiers.

Ce qui arrive ensuite est réglé aussi :

• si le dossier data contient des événements mais refuse l’écriture, le logiciel ne bascule pas en silence vers les Documents. Il nomme le dossier, dit ce qui l’empêche, et vous laisse choisir : « Réessayer », « Travailler dans les Documents, en y copiant ces événements », ou « Continuer : ouvrir la liste, aucun geste ne s’y enregistrera » ;
• si le dossier de travail est neuf et vide alors que l’autre emplacement contient des événements, le logiciel le dit et propose « Importer ces événements ». L’import les copie : les originaux restent où ils sont ;
• si une écriture échoue en cours de séance, par exemple quand la clé est retirée, le logiciel nomme le fichier et le dossier, et propose d’écrire ailleurs. Tant que ce n’est pas fait, le dernier geste n’est pas sur le disque, et le logiciel le dit ;
• sur une clé ou un disque amovible, le mode portable protège moins bien contre une coupure pendant une écriture ; le logiciel l’annonce.

Ce que contient le dossier. Chaque événement y tient en deux fichiers ordinaires, nommés d’après lui : <nom>.gtt.json, son état complet, et <nom>.gtt-journal.jsonl, son historique. Les deux portent le même identifiant interne, et c’est lui qui les apparie, pas leur nom ; renommez un événement par la commande « Renommer » de la liste plutôt que dans l’explorateur. Le dossier corbeille reçoit les événements supprimés, chacun dans un dossier daté ; le logiciel ne la vide jamais. Le fichier reglages_locaux.json garde les réglages de ce poste, comme le format de papier. Les planches de badges produites se déposent à côté des fichiers de l’événement.

Sauvegarder

Ouvrez le dossier de travail par « Ouvrir dans l’explorateur », puis copiez-le en entier sur une clé, un autre disque ou un dossier sauvegardé. En mode portable, copiez le dossier qui contient l’exécutable et son dossier data. Faites la copie logiciel fermé : aucun fichier n’est alors en cours d’écriture.

Pour envoyer un seul événement, joignez ses deux fichiers, <nom>.gtt.json et <nom>.gtt-journal.jsonl. Pour le reprendre, déposez-les dans le dossier de travail, ou utilisez « Importer un événement depuis un fichier… » sur la liste des événements. Ces fichiers se lisent sans le logiciel : ce sont des fichiers texte ordinaires.

Ils contiennent les noms, et parfois les courriels et les notes, des participants : traitez-les comme toute liste de personnes, et ne les envoyez qu’à qui doit les recevoir.

Si l’antivirus bloque

Au premier lancement, Windows peut afficher « Windows a protégé votre ordinateur » : l’exécutable est récent et peu répandu, Windows ne le connaît pas encore. Si le fichier vient bien de la source habituelle, cliquez sur « Informations complémentaires », puis sur « Exécuter quand même ». En cas de doute, demandez à la personne qui vous l’a fourni avant de l’ouvrir.

Si l’antivirus met l’exécutable en quarantaine ou l’empêche de démarrer, demandez à la personne qui gère votre poste de l’autoriser, ou ajoutez-le vous-même aux exceptions de l’antivirus.

Si l’antivirus empêche d’écrire dans le dossier data, le logiciel travaille dans vos Documents et dit pourquoi. Si la protection de Windows nommée « Accès contrôlé aux dossiers » est active, elle peut refuser l’écriture dans les Documents aussi : le logiciel dit alors que le dossier de travail refuse l’écriture. Ajoutez l’exécutable aux applications autorisées de cette protection.

Si une écriture échoue parce qu’un fichier est occupé, réessayez : un antivirus ou un outil de synchronisation de fichiers garde parfois un fichier ouvert un court instant.

Où lire la version

La version se lit sans rien chercher :

• dans le bandeau en haut de chaque écran, et sur la liste des événements ;
• dans le titre de la fenêtre, après le nom du logiciel ;
• au pied de chaque page imprimée ; un badge découpé n’en porte pas ;
• dans le panneau « À propos », ouvert depuis le bandeau. Il montre un bloc d’une ligne — la version, la version Windows, la plateforme, la provenance de la construction et la version de format des fichiers — que la commande « Copier » met dans le presse-papiers.

Les propriétés du fichier, dans l’Explorateur, montrent la version Windows, une autre écriture du même numéro : le bloc d’« À propos » porte les deux, ce qui permet de faire le lien.

Signaler un problème

Écrivez à la personne ou à l’organisme qui vous a fourni le logiciel, en joignant :

1. le bloc d’« À propos », collé tel quel après « Copier » : un numéro recopié à la main se recopie faux ;
2. ce que vous faisiez, ce que vous attendiez, et ce qui s’est passé, avec le texte exact du message s’il y en a un ;
3. une capture d’écran qui montre le bandeau : il porte la version ;
4. si le problème tient à un événement précis, et seulement avec l’accord des personnes concernées, ses deux fichiers.

Le logiciel n’envoie rien de lui-même : il ne se connecte à aucun service.