Horloge avancée#

L'horloge avancée est pensée pour être utilisée avec deux écrans : un projeté avec l'horloge, et un autre pour l'enseignant-e sur lequel il peut modifier les horaires et/ou les messages.

Les horaires et messages sont chargés dynamiquement et rafraîchis toutes les minutes, on peut donc mettre à jour ces derniers sans toucher à l'écran projeté.

Principe#

Décompresser le fichier clock.zip (cf. Installation)
Dans le dossier décompressé, il faut modifier les fichiers
- data\messages.md : le vider si rien n'est affiché (ou laisser juste le titre, par exemple). C'est le fichier qui permet de diffuser des éléments (remarques, erreur dans le sujet...) durant l'examen.
Exemple de message

Le dossier contient un fichier message.md déjà rempli avec quelques lignes qui donnent l'affichage de la capture d'écran sur la page d'accueil de cette documentation.
- data/horaires.json : chaque horloge affichée doit être configurée en donnant un label (l'étiquette au dessus de l'heure) et une heure de fin.
Exemple d'horaires

Le dossier contient un fichier horaires.json déjà rempli, qui donne l'affichage de la capture d'écran sur la page d'accueil de cette documentation.
Lancer le serveur avec la commande python <dossier>\server.py. Si le serveur ne peut pas se lancer sur le port par défaut (8010), il faut faire python <dossier>\server.py -p <port> en précisant un autre numéro de port. Si python est lancé depuis un autre dossier, il faut aussi l'option -d <chemin vers le dossier> Le lien à cliquer ou copier pour ouvrir dans le navigateur sera affiché dans le terminal.
Optionnellement, on peut mettre l'horloge en plein écran, ou basculer du mode clair au mode sombre à laide des des icônes en haut à droite.

Configuration des horaires de fin#

Il est possible d'afficher entre 0 et 4 heures de fin. Voici des modèles pour chacun des cas que vous pouvez copier et coller pour remplacer le contenu de horaires.json :

Pas d'horaire de fin à afficher

{
    "horaires": []
}

Un seul horaire de fin à afficher

{
    "horaires": [
        {
            "label": "Fin",
            "fin": "15:30"
        }
    ]
}

Deux horaires de fin à afficher

{
    "horaires": [
        {
            "label": "Fin (Non-TT)",
            "fin": "15:30"
        },
        {
            "label": "Fin (TT)",
            "fin": "16:00"
        }
    ]
}

Trois horaires de fin à afficher

{
    "horaires": [
        {
            "label": "Fin épreuve 1",
            "fin": "15:30"
        },
        {
            "label": "Fin épreuve 2",
            "fin": "16:00"
        },
        {
            "label": "Fin épreuve 3",
            "fin": "16:15"
        }
    ]
}

Quatre horaires de fin à afficher

{
    "horaires": [
        {
            "label": "Fin épreuve 1",
            "fin": "15:30"
        },
        {
            "label": "Fin épreuve 2",
            "fin": "16:00"
        },
        {
            "label": "Fin épreuve 3",
            "fin": "16:15"
        },
        {
            "label": "Fin épreuve 4",
            "fin": "16:30"
        }
    ]
}

Messages#

Les messages sont mis dans un fichier Markdown, le script sait gérer le Markdown standard, le plus gros du Markdown CommonMark, et une partie du Markdown "Github".

L'extension marked-extended-tables est activée pour gérer les tables plus complexes.
La coloration syntaxique (avec highlight.js) pour le code est activée.
Quelques règles CSS sont mises en places pour pouvoir faire des colonnes (cf. fichier messages.md fourni) et des admonitions (idem).
MathJax est activé pour formatter les équations et expression mathématiques.

Admonitions#

L'exemple donné sur la page d'accueil de cette documentation utilise l’admonition error, il en existe d'autre, il suffit de remplacer admonition-error par admonition-<type> (par exemple, admonition-warning) :

abstract
attention
bug
caution
danger
error
example
failure
hint
info
note
question
quote
success
tip
warning