improve documentation
[westcastle.git] / doc / index.html
1 <!DOCTYPE html>
2 <html>
3 <head>
4 <meta charset="utf-8">
5 <title>Westcastle usage</title>
6 <link rel="stylesheet" href="doc/index.css">
7 </head>
8 <body><span class="tldr">TL;DR:</span>
9 <ol>
10 <li>Cliquer sur les joueurs absents dans l'onglet "joueurs"</li>
11 <li>Aller dans la section "appariements" et cliquer sur le bouton en haut</li>
12 <li>Lancer le chrono (section "chronomètre", puis click gauche [puis F11])</li>
13 <li>À la fin d'une ronde, cliquer sur chaque table pour indiquer les (mini-)points.</li>
14 </ol>
15 <p>Le classement est mis à jour dans la rubrique correspondante et dans joueurs.csv.</p>
16 <p>Voir aussi la <a href="https://auder.net/westcastle_demo.webm">vidéo de démonstration</a></p>
17 <hr><span>L'application est divisée en 4 sections :</span>
18 <ul>
19 <li>Participants : la liste des joueurs présents (et absents)</li>
20 <li>Appariements : répartition des joueurs présents par tables</li>
21 <li>Chronomètre : un chrono qui démarre à 1h30 et sonne une fois à zéro</li>
22 <li>Classement : le tableau des scores (voir aussi joueurs.csv)</li>
23 </ul>
24 <h2>Participants</h2>
25 <p>
26 Un clic sur un joueur présent l'enlève des joueurs actifs (il est absent) ;
27 réciproquement, un clic sur un absent le ramène dans la liste des joueurs actifs.
28 Les appariements sont déterminés pour les joueurs présents seulement - en revanche le classement indique tout le monde.
29
30 </p>
31 <h2>Appariements</h2>
32 <p>
33 Un clic sur le bouton "Nouvelle ronde" réinitialise toutes les tables, en (re-)répartissant les joueurs aléatoirement sur celles-ci.
34 Si nécessaire, un quatrième joueur "Toto" est ajouté en fin de table.
35 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.
36
37 </p>
38 <p>
39 En fin de ronde, un clic sur une table permet de donner les scores de chaque joueur - en mini-points.
40 Un clic sur "Enregistrer" valide les scores : le classement est automatiquement mis à jour dans la rubrique correspondante,
41 et la table s'affiche désormais sur fond vert. Un clic sur "Fermer" annule l'opération, aucun changement n'est effectué.
42
43 </p>
44 <p>En cas d'erreur, <strong>ne surtout pas scorer une nouvelle table :</strong> d'abord restaurer l'état précédent en cliquant sur le bouton "Restaurer"
45 sur l'écran de classement ; alternativement, on peut cliquer sur le lien présent dans l'avertissement lorsqu'on reclique sur la table en question.
46 Ensuite, rentrer les scores corrigés.
47
48 </p>
49 <h2>Chronomètre</h2>
50 <p class="small-spacing">
51 Ce chronomètre basique est conçu pour s'afficher centré en mode plein écran : il faut donc commencer par appuyer sur F11
52 (la touche peut varier suivant le navigateur...). Ensuite :
53
54 </p>
55 <ul>
56 <li>un clic gauche lance le chrono ou le met en pause. Un gong retentit une fois le temps écoulé.</li>
57 <li>un clic droit réinitialise le chrono (à 1h30 = 90 minutes)</li>
58 <li>un clic sur la croix en haut à droite revient à la section appariements (suite logique).</li>
59 </ul>
60 <p>
61 Note : le chronomètre reste actif même si l'on change de vue - penser à le mettre en pause ou le réinitialiser.
62
63 </p>
64 <h2>Classement</h2>
65 <p>
66 Les scores sont ordonnés par points de table décroissants d'abord, puis en cas d'ex-aequos par mini-points décroissants.
67
68 </p>
69 <p>
70 Un clic sur "Réinitialiser" remet tous les compteurs à zéro : par exemple pour démarrer un nouveau cycle de tournois.
71 Cette action peut être annulée (immédiatement après) en cliquant sur "Restaurer".
72 </p>
73 </body>
74 </html>