项目 (Strings)

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

项目是保存翻译项目主要组件（工作、翻译记忆库和术语库）的地方。在将文件分配为工作进行翻译之前，必须先将其分配并包含在项目中。

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

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

项目页面

打开项目时，它会显示在项目页面中。

在项目页面中，可以查看和编辑所有项目详细信息。所有评论、标记、键和上传内容也会在此显示。

创建项目

要创建项目，请按照以下步骤操作：

在项目页面中，点击新建项目。

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

项目已添加到个人资料中。

这些设置（即项目名称、主要格式或联系人）可以在项目设置的常规选项卡中更改，该选项卡可通过更多菜单访问。

可以通过在项目页面的更多菜单中选择复制项目来复制现有项目。复制的项目使用原始项目的文件格式。如果该格式默认不支持复数形式，则无法使用复数形式。如果未定义主格式，则默认使用 .CSV 格式，且禁用复数形式。

定义项目

添加语言

项目的最小定义是原文/源语和译文语言。这些是文本的原始语言以及将要翻译成的语言，并在项目设置中进行初始定义。

要设置更多语言，请按照以下步骤操作：

将鼠标悬停在项目上并点击语言。

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

语言已添加到该项目。

可以通过在语言选项卡中点击添加语言 Add a Language 来添加更多语言，并可通过更多选项 Open More Menu 菜单选择 Edit 编辑语言进行编辑。

设置变量

信息片段和标志可以存储在项目变量中。变量通过翻译中心和 API 进行设置和管理。集成可以使用项目变量来配置工作流或切换指定行为。

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

示例 1

客户有不同的项目类型（营销和产品）。他们设置变量 content_type: marketing。
集成脚本读取该变量以决定如何处理该项目（例如，通过不同的 QA 检查）。

示例 2

客户使用 Phrase Strings 和 CMS。他们添加变量 template_id: 8734-ABCD。
集成脚本读取该变量，并在发布本地化内容时从 CMS 获取正确的模板。

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

要设置变量，请按照以下步骤操作：

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

理想情况下，名称应类似于环境变量（例如 MY_VAR），并且在每个项目中必须是唯一的。
点击添加变量<1> 以添加更多变量，点击图标以移除它们。
点击保存。

窗口关闭，变量即被保存。

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

随着软件项目的发展和复杂程度的增加，将其分成不同模块有助于保持项目的可管理性。通过将翻译拆分为更小的类别（例如 frontend 和 backend）来限制项目范围，可以帮助进行此管理。

示例维护工作流

创建 Strings 项目。以示例为例，项目 Frontend 和项目 Backend。
创建与 Strings 项目对应的原文/源语区域文件。

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

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

    # backend
    - file: ./path/to/locales/backend/en.yml
      project_id: "0c45c0c3cbfcab15c05692a2a995c"
      params:
        locale_id: "fb6d368e61bc159d48e76802f789d9b8"
  pull:
    targets:
    # frontend
    - file: ./path/to/locales/frontend/<locale_name>.yml
      project_id: "5c05692a2a995c0c45c0c3cbfcab1"

    # backend
    - file: ./path/to/locales/backend/<locale_name>.yml
      project_id: "0c45c0c3cbfcab15c05692a2a995c"

通过 --config 标记提供配置

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

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

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