Présenter
Les commandes qui montrent un modèle : les animations, les écrans du produit, l’application Arche et les stories.
Commandes : archec animation · archec ui · archec app · archec story
| Commande | Ce qu’elle fait |
|---|---|
archec animation list [category] [--json] |
Les modèles d’animation d’Arche — ceux que propose son éditeur — par catégorie : flux, timing, machines à états, signaux, matériel, mission, communications… animation v-x "…" from <template> { … } part de l’un d’eux (animations). |
archec animation show <template> |
Ce que dessine un modèle d’animation, chaque donnée qu’il lit (sa forme, son sens, son exemple), ce qu’il peut prendre du modèle (machine, scenario), et un bloc de départ. |
archec animation new <template> <id> [--label "…"] [--into file.arche] |
Un bloc animation de départ, dont les données sont l’exemple du modèle d’animation écrit dans le langage. Il est affiché, ou ajouté à un fichier. |
archec animation preview <main.arche> [id] [-o page.html] [--open] |
Une page qui joue l’animation (chacune, sans id) dans un cadre isolé, comme une diapositive la montre. Ses ${…} sont calculés à partir des constantes et des paramètres, en thème clair ou sombre. Dossier par défaut : arche-out/animations. |
archec ui <main.arche> [--json] [--id <component>] |
L’interface utilisateur du produit telle qu’archec la résout (ui) : l’appareil et le thème de chaque ui, ses écrans et, élément par élément, ce à quoi il est lié (avec son type et son unité), l’effet d’un appui, la destination des écrans et les noms qu’il lit. --json affiche le modèle lui-même (UiModel, src/ui.ts) : ce que lit un aperçu, un simulateur ou un générateur de code. Le build écrit la même chose dans ui/<component>.json. |
archec ui preview <main.arche> [--screen S] [--id <component>] [-o screens.html] [--png screens.png] [--chrome path] |
Les écrans dessinés (ui) : une page autonome avec chaque écran et chaque dialogue de chaque ui (ou --screen S) et les surcouches par-dessus. Chaque élément affiche une valeur d’exemple : les premières valeurs du modèle lui-même (les variables et l’état de chaque part au début d’une exécution du simulateur dans le navigateur), ses constantes et, pour un message pas encore reçu, une valeur dans la plage de son type. Un clic sur un élément indique ce qu’il est, ce qu’il lit et fait, et le fichier et la ligne où il est écrit. -o nomme la page (screens.html par défaut). --png en prend aussi une image avec Chrome headless (--chrome, $CHROME, sinon les emplacements habituels). archec doc --html montre les mêmes écrans comme figures. |
archec ui snapshot <main.arche> [--update] [--screen S] [--id <component>] [--tolerance 0.1] [-o <diff dir>] [--chrome path] |
Captures de référence (ui) : chaque écran et chaque dialogue est dessiné par Chrome headless, comme le fait archec ui preview --png, puis comparé pixel par pixel à ui/screenshots/<ui>/<screen>.png à côté du fichier principal. --update les écrit. Un écran dont plus de --tolerance pour cent des pixels ont changé (0,1 par défaut ; un canal à 24 près de la référence compte comme identique) échoue. Son diff est écrit dans -o (arche-out/.archec/ui-diff/<ui>/<screen>.png : la référence estompée, les changements en rouge, et <screen>.now.png). Sans Chrome, la commande le signale et ne compare rien (code de sortie 0). Code de sortie 1 quand un écran diffère ou n’a pas de référence. |
archec story list <main.arche> |
Les stories, et le nombre d’étapes de chacune. |
archec story export <main.arche> [story] [-o story.html] [--lang en] [--open] |
Une story en un seul fichier HTML, pour quelqu’un qui n’a pas Arche. On y trouve ses étapes dans l’ordre, leur texte dans la langue demandée (une traduction, sinon le texte tel qu’écrit), les animations qu’elles jouent, qui tournent dans des cadres isolés avec leurs données calculées, et les images. Une étape sur un système montre le schéma-blocs de ce système (son canevas, ou son fichier). Ce que seule l’application montre est nommé (In Arche: the memory map · KRIA260.yaml). Flèches, Début/Fin, n pour les notes, f pour le plein écran. p (ou #play dans l’adresse) la joue toute seule, chaque étape pendant son dwell (8 s par défaut). Rien n’est téléchargé. Par défaut : arche-out/<story>.html. |
archec story export <main.arche> --tries [dir] [--run id] [--scenario TP/TC] [--task "…"] [-o reel.html|reel.gif|reel.webm] [--seconds s] [--width px] [--fps n] [--theme dark] [--chrome path] |
Les essais d’une séance de réglage (réglage, .arche/tries/, la séance la plus récente sans --run) sous forme de film (regarder les essais) : un carton de titre avec la tâche, chaque essai rejoué en 3D à partir de ses poses avec ses verdicts par-dessus, le dernier essai, un carton de fin. .html le joue (et chaque essai peut être parcouru) ; .gif (image par image) ou .webm (en temps réel) l’enregistre dans Chrome sans interface. Par défaut : arche-out/<run>.html. |
archec animation render <main.arche> [id] [-o out.gif|dir] [--theme dark] [--seconds s] [--fps n] [--width px] [--chrome path] |
Un GIF de l’animation, enregistré comme le fait l’export .pptx d’Arche (ses propres images, peintes par le dessin), dans Chrome ou Chromium headless (--chrome, $CHROME, ou les emplacements habituels). Il couvre un cycle de sa duration (3 s par défaut) à son fps (10). |
archec app [main.arche] [--port 8080] [--host 127.0.0.1] [--static <dir>] [--allow-python] [--allow-build] [--token <t>] [--source-index] |
L’application Arche (l’éditeur visuel) sur les sources .arche du projet (app). Chaque fichier YAML qu’elle lit est construit à partir d’elles, et chaque enregistrement y est réécrit, après une vérification qui reconstruit les sources avant toute écriture. Dans VS Code : Arche: Open Arche App. |