update TODO
[westcastle.git] / doc / index.pug
1 doctype html
2 html
3
4 head
5 meta(charset="utf-8")
6 title Westcastle usage
7 link(rel="stylesheet", href="index.css")
8
9 body
10
11 span.tldr TL;DR:
12 ol
13 li Bouton "(Ré)initialiser" : charger la liste des joueurs, puis cliquer sur les absents
14 li Aller dans la section "appariements" et cliquer sur le bouton "Nouvelle ronde"
15 li Lancer le chrono (section "Chronomètre", puis clic gauche [puis F11])
16 li Après la ronde, cliquer sur chaque table pour indiquer les (mini-)points, #[br] #[strong puis cliquer sur "Nouvelle ronde".]
17 p Le classement est mis à jour dans la rubrique correspondante.
18
19 p Voir aussi la #[a(href="https://auder.net/westcastle_demo.webm") vidéo de démonstration]
20
21 hr
22
23 span L'application est divisée en 4 sections :
24 ul
25 li Participants : la liste des joueurs présents (et absents)
26 li Appariements : répartition des joueurs présents par tables
27 li Chronomètre : un chrono qui démarre à 1h30 et sonne une fois à zéro
28 li Classement : le tableau des scores
29
30 h2 Participants
31
32 p.
33 Au premier lancement de l'application, la liste des joueurs est vide : il faut cliquer sur "(Ré)initialiser",
34 puis choisir le fichier participants.csv contenant les prénoms + noms des joueurs en lignes, comme dans participants.csv.sample.
35 Le contenu de la première ligne d'en-tête est arbitraire, mais celle-ci doit être présente.
36
37 p.
38 Un clic sur un joueur présent l'enlève des joueurs actifs (il est absent) ;
39 réciproquement, un clic sur un absent le ramène dans la liste des joueurs actifs.
40 Les appariements sont déterminés pour les joueurs présents seulement - en revanche le classement indique tout le monde.
41
42 h2 Appariements
43
44 p.
45 Un clic sur le bouton "Nouvelle ronde" réinitialise toutes les tables, en (re-)répartissant les joueurs aléatoirement sur celles-ci.
46 Si nécessaire, un quatrième joueur "Toto" est ajouté en fin de table.
47 Si seulement 1, 2, ou 5 joueurs sont présents, aucune configuration ne permet de faire jouer tout le monde : il y aura des joueurs exempts.
48
49 p.
50 En fin de ronde, un clic sur une table permet de donner les scores de chaque joueur - en mini-points.
51 Un clic sur "Enregistrer" valide les scores : le classement est automatiquement mis à jour dans la rubrique correspondante,
52 et la table s'affiche désormais sur fond vert. Un clic sur "Fermer" annule l'opération, aucun changement n'est effectué.
53
54 p.
55 En cas d'erreur, re-cliquer sur la table à corriger : cliquer ensuite sur "Annuler", puis ré-entrer les scores.
56
57 p.
58 Même s'il n'y a plus aucune ronde, ne pas oublier de #[strong cliquer sur "Nouvelle ronde"] :
59 cela mémorise les appariements actuels, et surtout enregistre les derniers scores en mémoire.
60 le bouton "Annuler", quant à lui, efface les scores déjà entrés et relance la ronde (nouvel appariement).
61
62 h2 Chronomètre
63
64 p.small-spacing.
65 Ce chronomètre basique est conçu pour s'afficher centré en mode plein écran : il faut donc commencer par appuyer sur F11
66 (la touche peut varier suivant le navigateur...). Ensuite :
67
68 ul
69 li un clic gauche lance le chrono ou le met en pause. Un gong retentit au début et une fois le temps écoulé.
70 li Un appui sur la barre d'espace permet d'éditer le temps initial (en minutes).
71 li un clic droit réinitialise le chrono (90 minutes = 1h30 par défaut).
72 li un clic sur la croix en haut à droite revient à la section appariements (suite logique).
73
74 p.
75 Note : le chronomètre reste actif même si l'on change de vue - penser à le mettre en pause ou le réinitialiser.
76
77 h2 Classement
78
79 p.
80 Les scores sont ordonnés par points de table décroissants d'abord, puis en cas d'ex-aequos par mini-points décroissants.
81 Ils peuvent être téléchargés via le bouton en haut à droite. Dans le fichier, "pdt" indique les points de table cumulés
82 et "session" les points de session cumulés (aussi appelés mini-points).
83
84 p
85 | Un clic sur "Réinitialiser" remet tous les compteurs à zéro : par exemple pour démarrer un nouveau cycle de tournois.
86 strong Attention cette action est irréversible.