给组件做白标
游戏自定义 改变组件里面的游戏。白标改变 组件外壳,即每个挑战周围的外饰:它的措辞、它的颜色和品牌标记,以及它品牌条里的链接。你在仪表盘里撰写覆盖,Caputchin 把它们提供给每一次组件挂载,无需改代码、无需 fork。
白标是一个 Apex 档 的功能。
它住在哪里
打开一个团队,或一个站点密钥,前往它的 白标 页(在设置下)。它用和游戏自定义同一个编辑器,但它针对组件外壳、而非某个特定游戏,所以它适用于组件所运行的每一个挑战。
三个维度
白标有和一个游戏同样的三个维度,应用到外壳的内置字段集上:
| 维度 | 它控制什么 |
|---|---|
| 语言 | 外壳的字符串:验证标签、品牌字标、状态和关闭标签,以及无障碍标签。 |
| 皮肤 | 外壳的颜色和它的品牌徽标。 |
| 配置 | 品牌条的链接目标:主页链接和法律链接。 |
你只覆盖你想要的那些字段;你原封不动的一切都保持 Caputchin 的默认。
范围与默认
白标覆盖以和 游戏自定义 同样的方式解析,最具体者胜:一个 站点密钥 的预设胜过 团队 的基线,团队的基线又胜过 Caputchin 的捆绑默认,逐个值计算。在团队上设一次基线,并逐密钥覆盖例外。每个组(每种语言、亮和暗各一个、那个单一的配置组)有一个默认,你在编辑器里标记它。一个模式为 any 的皮肤在两种背景上都工作,显示在亮组和暗组下,并能被设为其中一个或两个的默认。你可以扩展一个捆绑预设、只改你需要的那些字段。同样的字段类型和预设模型驱动两者;见 模式参考。
它如何传播
保存一个预设会在几秒内在每一个受影响的组件挂载上生效。组件在加载时短暂地等你的覆盖,然后如果拉取很慢就回退到捆绑的外观,于是一个慢网络绝不会让一位访客盯着一个空白组件。
外壳交付的语言
组件外壳(每次验证周围的外饰,而非它里面的游戏)为这 11 种语言交付内置的 语言 预设,以英语为默认。一位 浏览器语言 是其中之一的访客会自动看到那种语言的外壳;其他任何人都回退到英语。这是外壳自己的覆盖范围,并独立于一个游戏的语言,后者由每个游戏的作者各自选择。
| 语言 | 标签 |
|---|---|
| 英语(默认) | en |
| 中文(简体) | zh-Hans |
| 西班牙语 | es |
| 阿拉伯语 | ar |
| 葡萄牙语 | pt |
| 法语 | fr |
| 德语 | de |
| 俄语 | ru |
| 日语 | ja |
| 韩语 | ko |
| 印尼语 | id |
你不配置这些;它们默认开启。两件事替你处理好了:一种从右到左的语言(阿拉伯语)自动把外壳的布局翻转为 rtl,而那些 CJK 语言(中文、日语、韩语)用访客的系统字体渲染,两边都无需设置。
要 更改 这些里面任何一种的措辞,或 添加 一种未列出的语言,就用上面的语言维度:为那个语言标签编辑或创建一个预设,就和你覆盖任何其他外壳字符串一样。
另见
- 组件如何解析它的语言和皮肤:一位访客看到哪种语言和皮肤。
- 用 CSS 给组件设样式:调整白标不覆盖的布局和细节。
- 模式参考:外壳的内置字段和字段类型。
- 我们的理念:白标坐落在自定义阶梯的何处,以及只有它能做什么。