> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orriven.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 语言

> 以多种语言提供活动内容：「语言」卡片、翻译编辑器、逐条回退，以及页面如何选择语言。

活动的公开内容——名称、票种、加购、捆绑销售、议程、讲者与表单问题——只用一种语言填写一次。活动[公开页面](/zh/events/event-page)板块底部的**语言**卡片用于添加第二种语言。译文在其下方的编辑器中填写。此后公开内容按所请求的语言返回：通过 [Storefront API](/zh/developers/storefront) 出现在主办站点上，以及出现在 orriven 的[托管页面](/zh/events/hosted-pages)——结账、订单页与入场凭证——上。

涉及两类文字：

* 托管页面的**界面文案**——按钮、状态、提示——由平台翻译。
* **活动内容**在此翻译。

## 支持的语言

平台提供 **English** 与**简体中文**。只能提供托管页面自身能够渲染的语言，以免出现中文内容配英文按钮。为平台新增一种语言是单独的改动。没有机器翻译。

## 添加语言

<Steps>
  <Step title="打开活动的「公开页面」板块">
    **语言**卡片以复选框列出可用语言。
  </Step>

  <Step title="勾选要提供的语言，并选择默认语言">
    **默认语言**是未翻译字符串的回退目标，也是访客未作选择前看到的语言。它始终是已提供语言之一。取消勾选默认语言时，默认会移到剩余的第一种语言。
  </Step>

  <Step title="保存">
    提供两种及以上语言后，待翻译的文本出现在下方。
  </Step>
</Steps>

只提供一种语言的活动不显示编辑器——「当前为单一语言」——直到勾选第二种语言。

## 翻译

**文本**卡片选择当前**翻译为**哪种语言，一次一种。其下按来源分组列出字符串，顺序固定：

| 分组   | 列出的内容                           |
| ---- | ------------------------------- |
| 活动   | 活动名称。                           |
| 票种   | 每个票种的名称与描述——包括尚未开售的票种。          |
| 增值加购 | 名称与描述。                          |
| 捆绑销售 | 名称与描述。                          |
| 议程   | 每个场次的标题、描述，以及议程中显示的场地名称。        |
| 讲者   | 姓名、头衔与简介。                       |
| 表单   | 已发布表单中每个问题的标签、描述与说明，以及选择题的每个选项。 |

每一行左侧显示**原文**——默认语言的当前值，此处不可编辑；名称在名称所在之处修改——右侧是填写译文的输入框。较长的原文使用多行输入框。**留空即保留原文。** 有任何改动时出现保存栏。**重新载入文本**在其他地方的内容变更后重新取回原文。

列表取自访客实际会看到的页面：空字段不列出，隐藏票种不列出，之后新增的内容在下次载入时出现。尚无公开内容的活动显示「暂无可翻译内容」。

## 逐条回退

没有译文的字符串**单独**回退到默认语言——不是整页回退。部分翻译的活动仍会显示全部字段：已译的票种名称、未译的加购保持原文，页面不会缺项。

## 翻译无法改变的事

翻译只替换文字。它无法揭示隐藏票种、改变售罄或关闭状态、改动价格、增删条目，或让草稿活动可见。页面提供什么、提供给谁，在应用翻译之前就已决定。

有些文字不可翻译：**权益名称**与**赞助层级名称**（它们在公开页面上没有可供对照的标识），以及**订单中的条目名称**——那是下单时刻的快照。控制台跟随账号语言，而不是活动的语言。

## 访客如何获得语言

* **主办站点**在 Storefront API 上以 `?lang=`（例如 `?lang=zh-CN`）请求某种语言，即得到翻译后的内容。不带参数时为默认语言。
* **托管页面**的页头有语言切换器。两种界面语言始终可选。页面按以下顺序确定语言：链接上的 `?lang=`，其次访客上次的选择，其次浏览器语言，否则为英文。选择保存在访客自己的浏览器中。不需要登录，也不写 Cookie。界面文案与活动内容一同切换。

## 注意事项

* 只能提供 **English** 与**简体中文**。默认语言必须是已提供语言之一。
* 回退**逐条**进行，静默回退到默认语言。
* 翻译**不**影响提供什么、显示什么、定价多少、是否可售。
* 权益、赞助层级与订单条目不翻译。控制台也不随之改变。
* 语言是查询参数加一次记住的选择。没有按语言区分的地址。

## 相关页面

<CardGroup cols={2}>
  <Card title="活动页面" icon="globe" href="/zh/events/event-page">
    「语言」卡片所属的公开页面板块。
  </Card>

  <Card title="Storefront API" icon="store" href="/zh/developers/storefront">
    用 `?lang=` 读取翻译内容。
  </Card>

  <Card title="托管页面" icon="panel-top" href="/zh/events/hosted-pages">
    结账、订单页与入场凭证。
  </Card>

  <Card title="报名表单" icon="list-check" href="/zh/ticketing/registration-form">
    出现在「表单」分组中的问题。
  </Card>
</CardGroup>
