上下文帮助(F1)
EVENT 中的每个按钮、字段、选项卡或命令都有一个键,而每个键在本帮助中都有对应的条目:按F1 键,帮助就会准确地打开到相应位置。
原理
- 每个元素一个键。在 EVENT 中,每个可搜索的元素都有一个固定的键:
courses.generer对应“生成比赛”按钮,inscriptions.dossards对应“号码布…”。这些就是标题区搜索(Ctrl+K)所用的键:完整列表即 EVENT 的搜索目录。 - 每个键一个条目。在按界面分类的参考中,描述某个元素的条目以该元素的键作为标识符:页面
reference/composition.html包含条目courses.generer。 - 一张对照表。文件
aide/commun/f1/event.json将每个键与其页面和条目对应起来:"courses.generer": "reference/composition.html#courses.generer"。 - F1。EVENT 从拥有焦点的元素(否则为鼠标下方的元素)开始,一直向上追溯到窗口,记下沿途遇到的每个键(包括所选的选项卡);
f1.json中第一个已知的键给出页面和条目(例如reference/composition.html#courses.generer)。一个都没有时:打开 EVENT 帮助首页。菜单处于打开状态时:F1 指向菜单中的命令。目标条目会高亮显示几秒钟。
可以用一个链接试试:reference/composition.html#courses.generer。
帮助在哪里,以及不使用 F1 时
EVENT 打开随其一起安装的帮助(程序旁边的 aide 文件夹),使用软件的界面语言(尚待翻译的页面以法语显示)。如果没有安装帮助,则打开 chronofeed.ca 网站上的在线帮助。不使用 F1 查找条目的方法:
- 在本帮助中,在搜索框(Ctrl+K,每页顶部)中输入元素的标签:“种子”、“号码布”、“终点线”。参考中的每个条目都已编入索引,包括其关键词。
- 在 EVENT 中,标题区的搜索(Ctrl+K)可以用同样的词找到同一个元素,并在屏幕上将其显示出来。
- 下表列出了从每个键到其条目的链接。
模式
有些键只存在于某一种赛事模式中:只有当打开的赛事属于该模式时,EVENT 的搜索才会列出它们,其条目带有时间或名次徽标。“SSR 成绩”只在速度滑冰大道中提供。
所有键
EVENT 搜索目录中的全部 296 个键,按目录顺序排列,标签和位置与软件中显示的一致。
致编写者
添加到 EVENT 搜索目录中的元素,需要一个 id 为其键的条目,并在f1.json 中添加一行;检查工具 tools/verif/aide_liens.py 会列出尚无条目的键。使用说明见aide/LISEZMOI.md。