'update'

[westcastle.git] / doc / index.pug

diff --git a/doc/index.pug b/doc/index.pug
index 8e08c5e..3e68ab4 100644 (file)
--- a/doc/index.pug
+++ b/doc/index.pug
@@ -4,20 +4,35 @@ html
        head
                meta(charset="utf-8")
                title Westcastle usage
        head
                meta(charset="utf-8")
                title Westcastle usage

-               link(rel="stylesheet", href="doc/index.css")
+               link(rel="stylesheet", href="index.css")

 
        body
 
 
        body
 

+               span.tldr TL;DR:
+               ol
+                       li Bouton "(Ré)initialiser" : charger la liste des joueurs, puis cliquer sur les absents
+                       li Aller dans la section "appariements" et cliquer sur le bouton "Nouvelle ronde"
+                       li Lancer le chrono (section "Chronomètre", puis clic gauche [puis F11])
+                       li Après la ronde, cliquer sur chaque table pour indiquer les (mini-)points, #[br] #[strong puis cliquer sur "Valider".]
+               p Le classement est mis à jour dans la rubrique correspondante.
+
+               p Voir aussi la #[a(href="https://auder.net/westcastle_demo.webm") vidéo de démonstration]
+
+               hr
+

                span L'application est divisée en 4 sections :
                ul
                        li Participants : la liste des joueurs présents (et absents)
                        li Appariements : répartition des joueurs présents par tables
                        li Chronomètre : un chrono qui démarre à 1h30 et sonne une fois à zéro
                span L'application est divisée en 4 sections :
                ul
                        li Participants : la liste des joueurs présents (et absents)
                        li Appariements : répartition des joueurs présents par tables
                        li Chronomètre : un chrono qui démarre à 1h30 et sonne une fois à zéro

-                       li Classement : le tableau des scores (voir aussi joueurs.csv)
+                       li Classement : le tableau des scores

 
                h2 Participants
 
 
                h2 Participants
 

-               img(src="doc/screen_players.png")
+               p.
+                       Au premier lancement de l'application, la liste des joueurs est vide : il faut cliquer sur "(Ré)initialiser",
+                       puis choisir le fichier participants.csv contenant les prénoms + noms des joueurs en lignes, comme dans participants.csv.sample.
+                       Le contenu de la première ligne d'en-tête est arbitraire, mais celle-ci doit être présente.

 
                p.
                        Un clic sur un joueur présent l'enlève des joueurs actifs (il est absent) ;
 
                p.
                        Un clic sur un joueur présent l'enlève des joueurs actifs (il est absent) ;


@@ -26,32 +41,22 @@ html
 
                h2 Appariements
 
 
                h2 Appariements
 

-               img(src="doc/screen_pairings_new.png")
-

                p.
                        Un clic sur le bouton "Nouvelle ronde" réinitialise toutes les tables, en (re-)répartissant les joueurs aléatoirement sur celles-ci.
                        Si nécessaire, un quatrième joueur "Toto" est ajouté en fin de table.
                p.
                        Un clic sur le bouton "Nouvelle ronde" réinitialise toutes les tables, en (re-)répartissant les joueurs aléatoirement sur celles-ci.
                        Si nécessaire, un quatrième joueur "Toto" est ajouté en fin de table.

-                       Si seulement 1, 2, ou 5 ou 6 joueurs sont présents, aucune configuration ne permet de faire jouer tout le monde : il y aura des joueurs exempts.
-
-               img(src="doc/screen_pairings_scoring.png")
+                       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.

 
                p.
                        En fin de ronde, un clic sur une table permet de donner les scores de chaque joueur - en mini-points.
                        Un clic sur "Enregistrer" valide les scores : le classement est automatiquement mis à jour dans la rubrique correspondante,
                        et la table s'affiche désormais sur fond vert. Un clic sur "Fermer" annule l'opération, aucun changement n'est effectué.
 
 
                p.
                        En fin de ronde, un clic sur une table permet de donner les scores de chaque joueur - en mini-points.
                        Un clic sur "Enregistrer" valide les scores : le classement est automatiquement mis à jour dans la rubrique correspondante,
                        et la table s'affiche désormais sur fond vert. Un clic sur "Fermer" annule l'opération, aucun changement n'est effectué.
 

-               img(src="doc/screen_pairings_restore.png")
-

                p.
                p.

-                       En cas d'erreur, ne surtout pas scorer une nouvelle table : d'abord restaurer l'état précédent en cliquant sur le bouton "Restaurer"
-                       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.
-                       Ensuite, rentrer les scores corrigés.
+                       En cas d'erreur, re-cliquer sur la table à corriger : cliquer ensuite sur "Annuler", puis ré-entrer les scores.

 
                h2 Chronomètre
 
 
                h2 Chronomètre
 

-               img(src="doc/screen_timer.png")
-
-               p.
+               p.small-spacing.

                        Ce chronomètre basique est conçu pour s'afficher centré en mode plein écran : il faut donc commencer par appuyer sur F11
                        (la touche peut varier suivant le navigateur...). Ensuite :
 
                        Ce chronomètre basique est conçu pour s'afficher centré en mode plein écran : il faut donc commencer par appuyer sur F11
                        (la touche peut varier suivant le navigateur...). Ensuite :
 


@@ -65,11 +70,11 @@ html
 
                h2 Classement
 
 
                h2 Classement
 

-               img(src="doc/screen_ranking.png")
-

                p.
                        Les scores sont ordonnés par points de table décroissants d'abord, puis en cas d'ex-aequos par mini-points décroissants.
                p.
                        Les scores sont ordonnés par points de table décroissants d'abord, puis en cas d'ex-aequos par mini-points décroissants.

+                       Ils peuvent être téléchargés via le bouton en haut à droite. Dans le fichier, "pdt" indique les points de table cumulés
+                       et "session" les points de session cumulés (aussi appelés mini-points).

 
 

-               p.
-                       Un clic sur "Réinitialiser" remet tous les compteurs à zéro : par exemple pour démarrer un nouveau cycle de tournois.
-                       Cette action peut être annulée (immédiatement après) en cliquant sur "Restaurer".
+               p
+                       | Un clic sur "Réinitialiser" remet tous les compteurs à zéro : par exemple pour démarrer un nouveau cycle de tournois. 
+                       strong Attention cette action est irréversible.