Faire des qcm simplement - retour accueil
git clone git://bebou.netlib.re/qcm
Log | Files | Refs | README |
commit 25896902a1a2beb74929b3a71d465f0d7cca3778 parent 0b3454a99e004687c5ce897ba8903bbecc594494 Auteurice: Arthur Pons <arthur.pons@unistra.fr> Date: Fri, 8 Nov 2024 09:20:55 +0100 MAJ README en accord avec l'article Diffstat:
| M | README | | | 36 | +++++++++++++++++++++++++----------- |
1 file changed, 25 insertions(+), 11 deletions(-)
diff --git a/README b/README @@ -2,6 +2,17 @@ Faire des sondages simples en parsant les logs d'un serveur web +Sur un vieux concept déjà décrit +[ici](/sondages/#par-greppage-de-logs-de-serveurs-web). L'idée est d'en faire +une sorte de [kahoot !](https://kahoot.it/) ou +[wooclap](https://www.wooclap.com/fr/) like entièrement descriptible par un +fichier texte, ne nécessitant qu'un serveur accessible sur le web. + +`qcm` est installé sur bebou mais uniquement les personnes ayant un compte +dessus peuvent l'utiliser pour créer des questionnaires. Il est cependant très +simple d'installer `qcm` sur votre serveur linux, et j'espère pas beaucoup plus +sur une autre variante Unix-like. + ## Dépendances * un shell posix (testé avec dash) @@ -10,13 +21,15 @@ Faire des sondages simples en parsant les logs d'un serveur web * un `sed` posix * un `xargs` posix -Testé sous debian 12 et le serveur web nginx packagé pour. +Testé sous debian 12 et le serveur web nginx packagé pour. Le code +parsant les logs convient pour le format par défaut d'nginx. Il se peut +qu'il ne fonctionne pas pour d'autres formats. ## Les défauts -url par défaut : http://bebou.netlib.re (modifiable dans le code) -log par défaut : /var/log/nginx/access.log (modifiable dans le code) -nombre de question par défaut : 4 (ABCD) +url par défaut : http://bebou.netlib.re (modifiable dans le code) +log par défaut : `/var/log/nginx/access.log` (modifiable dans le code) +nombre de questions par défaut : 4 (ABCD) ## Installation @@ -24,7 +37,7 @@ nombre de question par défaut : 4 (ABCD) make install Il est possible de modifier le dossier de destination du script exécutable en -modifiant la variable DEST dans le makefile. +modifiant la variable `DEST` dans le makefile. ## Usages et exemples @@ -127,22 +140,23 @@ le `:` et `nom` mais avec un espace après le `:`. La liste des attributs : - * `question` : L'intitulé de la question. Optionnel, s'il n'existe pas rien ne sera affiché - * `type` : le type de question. Optionnel, `qcm`, type par défaut, proposera + * `question` : L'intitulé de la question. Optionnel. S'il n'existe pas rien + ne sera affiché + * `type` : le type de question. Optionnel. `qcm`, type par défaut, proposera un choix multiple (A, B, C...), uniquement ces réponses seront valides. Si `options` existe il fera correspondre les options aux différentes lettres. En l'absence d'`options` `qcm` proposera 4 choix par défaut (A, B, C et D). Malgré son nom `qcm` n'admet par défaut qu'une seule réponse possible. Voir `choix`. `ouverte` permettra n'importe quelle réponse et ignore `options`. * `options` : la liste des réponses possibles séparées par des `~`. Il ne - doit pas y avoir de `~` à la fin. Optionnel, s'il n'existe pas c'est `-n` + doit pas y avoir de `~` à la fin. Optionnel. S'il n'existe pas c'est `-n` qui décidera du nombre de réponses possibles qui sera le même pour toutes les questions. - * `unique` : si une seule réponse par IP est autorisée ou pas. Optionnel, "non" + * `unique` : si une seule réponse par IP est autorisée ou pas. Optionnel. "non" enregistrera toutes les réponses, n'importe quoi d'autre (`oui` par exemple) filtrera sur les IP pour ne laisser que la première réponse passer. Par défaut `unique` est à oui. - * `choix` : si la question est à choix multiple ou pas. Optionnel, "multiple" + * `choix` : si la question est à choix multiple ou pas. Optionnel. "multiple" permettra de choisir plusieurs options, n'importe quoi d'autre l'empêchera. Par défaut les questions ne sont pas à choix multiple. Si la question est de `type` `ouverte` cet attribut est ignoré puisqu'il n'y a pas d'options @@ -187,7 +201,7 @@ Posera cinq questions en tout. 1. celle par défaut, un qcm avec quatre choix, aucun intitulé, aucune réponse possible d'affichée (juste les lettres). Par défaut ne permet de choisir qu'une seule réponse une seule fois. Utile si les questions et les réponses - sont gérées par ailleurs. + sont gérées par ailleurs, par exemple projetée via des diapos. 2. une qcm offrant le choix entre les trois équipes de foot. Il est possible d'en choisir plusieurs à la fois. Est toujours un qcm par défaut et ne permet de répondre qu'une seule fois.