Projects (Strings)

文本由 Phrase Language AI 从英语机器翻译而得。

项目是翻译项目的主要组成部分（工作、翻译记忆库和术语库）结合在一起的地方。在将文件分配为翻译工作之前，必须将其分配给项目并包含在项目中。

已分配的项目列在个人资料页面的项目选项卡下，可按空间筛选。

根据 Team 结构，项目可以按产品或平台定义。如果所有 Team 成员都需要访问，请使用单个项目。

项目页面

打开项目在项目页面中显示。

从项项目面，可以查看和编辑所有项目详细信息。同时显示所有备注、tags、keys 和 uploads。

创建项目

要创建项目，请遵循以下步骤：

从项目页面，单击新建项目。

添加项目窗口打开。
提供项目名称。
从下拉列表中，从下拉列表中选择一种主要格式和主要技术。
从下拉列表中提供联系点。
点击保存。

项目添加到个人资料。

这些设置可以在更多菜单访问的项目设置的常规选项卡上更改。

定义项目

添加语言

项目的最低定义是原文/源语和译文语言。这些是文本的原始语言以及它将被翻译成并在项目设置中最初定义的语言。

要进一步设置语言，请遵循以下步骤：

将鼠标悬停在项目上，然后单击语言。

语言选项卡打开。
点击添加语言。添加语言窗口打开。
从常规选项卡，提供语言名称和语言代码（区域）。
从高级选项卡，从下拉列表中选择原文/源语语言。
从审校选项卡，选择审校选项。
点击保存。

语言被添加到该项目。

通过单击语言选项卡中的添加语言可以添加更多语言，也可以通过选择编辑语言从更多选项菜单中进行编辑。

设置变量

信息和标志的比特可以存储在项目变量中。变量已设置，可通过翻译中心和 API 管理。集成可以使用项目变量来配置具有切换指定行为的工作流。

变量通常在脚本中通过 API 访问。与环境变量一样，项目变量的值以字符串表示，因此必须指定类型（例如布尔值、整数）。

变量只能由管理员设置，并在项目设置窗口的变量选项卡中定义。

要设置变量，请遵循以下步骤：

从项目页面，从更多下拉列表打开项目设置窗口。
打开变量选项卡。
提供变量的名称和值。

理想情况下，名称应该与环境变量类似，如MY_VAR，并且每个项目都必须是唯一的。
单击添加变量以添加更多变量，然后单击图标以移除它们。
点击保存。

窗口关闭并保存变量。

为一个本地化项目维护多个 Strings 项目

随着软件项目的发展和日益复杂，将其拆分为模块有助于保持项目的可管理性。通过将翻译分成前端和后端等较小的类别来限制项目的范围可以帮助这种管理。

维护工作流示例

创建 Strings 项目。例如，项目前端和项目后端。
创建 Strings 项目对应的原文/源语区域文件。

创建一个配置文件，其中包括原文/源语区域文件在项目中的位置，并将其与相应的 Strings 项目匹配：

phrase:
  access_token:"3d7e6598d955bfcabaf1b9459df5692ac4c28a17793"
  file_format: yml
  push:
    sources:
    # 前端
    - 文件：./path/to/locales/frontend/en.yml
      project_id:"5c05692a2a995c0c45c0c3cbfcab1"
      params:
        locale_id:"159d48e76802f789d9b8fb6d368e61bc"

    # 后端
    - 文件：./path/to/locales/backend/en.yml
      project_id:"0c45c0c3cbfcab15c05692a2a995c"
      params:
        locale_id: "fb6d368e61bc159d48e76802f789d9b8"
  pull:
    targets:
    # 前端
    - 文件:./path/to/区域/frontend/<locale_name>.yml
      project_id:"5c05692a2a995c0c45c0c3cbfcab1"

    # 后端
    - 文件:./path/to/区域/后端/<locale_name>.yml
      project_id:"0c45c0c3cbfcab15c05692a2a995c"

通过 --config 标记提供配置

默认情况下，CLI 将在运行 phrase 的同一级别尝试使用一个名为 .phrase.yml 的文件。要支持更复杂的工作流，请为不同目的使用多个配置文件。

要强制 CLI 对某些命令使用配置文件，请通过 --config 标记提供相应的 .yml 文件：

$ phrase push --config ./path/to/config.yml