Contextuele help (F1)

Elke knop, elk veld, elk tabblad en elke opdracht van EVENT heeft een sleutel, en elke sleutel heeft zijn sectie in deze help: de toets F1 opent de help precies op de juiste plaats.

Het principe

1. Eén sleutel per element. In EVENT draagt elk element waarnaar u kunt zoeken een vaste sleutel: courses.generer voor de knop ‘Races genereren’, inscriptions.dossards voor ‘Rugnummers…’. Het zijn de sleutels van het zoeken in de kop (Ctrl+K): de volledige lijst is de zoekcatalogus van EVENT.
2. Eén sectie per sleutel. In de naslag per scherm heeft de sectie die een element beschrijft de sleutel als identificatie: de pagina reference/composition.html bevat de sectie courses.generer.
3. Eén tabel. Het bestand aide/commun/f1/event.json koppelt elke sleutel aan zijn pagina en zijn sectie: "courses.generer": "reference/composition.html#courses.generer".
4. F1. EVENT vertrekt van het element dat de focus heeft (anders van het element onder de muis) en gaat omhoog tot aan het venster, waarbij het elke tegengekomen sleutel noteert, het gekozen tabblad inbegrepen; de eerste sleutel die in f1.json bekend is, geeft de pagina en de sectie (bijvoorbeeld reference/composition.html#courses.generer). Geen enkele: de startpagina van de help bij EVENT. Een geopend menu: F1 richt zich op de opdracht ervan. De beoogde sectie wordt enkele seconden gemarkeerd.

Probeer het met een link: reference/composition.html#courses.generer.

Waar de help staat, en zonder F1

EVENT opent de help die ermee is geïnstalleerd (map aide naast het programma), in de taal van het programma (in het Frans voor een pagina waarvan de vertaling nog volgt). Zonder geïnstalleerde help opent het de online help, op de website chronofeed.ca. Om een sectie zonder F1 te vinden:

• Typ in deze help het label van het element in het zoekveld (Ctrl+K, bovenaan elke pagina): ‘startwaarde’, ‘Rugnummers’, ‘finishlijn’. Elke sectie van de naslag is geïndexeerd, met haar trefwoorden.
• In EVENT vindt het zoeken in de kop (Ctrl+K) hetzelfde element met dezelfde woorden en toont het op het scherm.
• De tabel hieronder leidt van elke sleutel naar zijn sectie.

De modi

Sommige sleutels bestaan alleen voor één modus van het evenement: het zoeken van EVENT stelt ze alleen voor als het geopende evenement in die modus staat, en hun sectie draagt een badge Tijd of Positie. ‘SSR-prestaties’ wordt alleen voorgesteld bij langebaanschaatsen.

Alle sleutels

De 296 sleutels uit de zoekcatalogus van EVENT, in de volgorde van de catalogus, met het label en de plaats zoals het programma ze toont.

Voor de redacteurs

Een element dat aan de zoekcatalogus van EVENT wordt toegevoegd, vraagt een sectie waarvan de id de sleutel is, en een regel in f1.json; de controle tools/verif/aide_liens.py meldt de sleutels die nog geen sectie hebben. De handleiding staat in aide/LISEZMOI.md.