项目（字符串）

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

项目是翻译项目（工作、翻译记忆和术语库）的主要组成部分的集合。在文件可以被分配为工作进行翻译之前，它们必须被分配到一个项目中并包含在其中。

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

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

项目页面

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

从项目页面，可以查看和编辑所有项目详细信息。所有评论、标签、密钥和上传内容也会显示。

创建项目

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

从项目页面，点击新项目。

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

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

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

现有项目可以通过在更多菜单中选择复制项目来复制。复制的项目使用原始项目的主要文件格式。如果该格式默认不支持复数化，则复数化不可用。如果未定义主要格式，则默认使用.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，并且每个项目必须唯一。
点击添加变量以添加更多变量，并点击图标以移除它们。
点击保存。

窗口关闭，变量被保存。

为一个本地化项目维护多个字符串项目

随着软件项目的增长和变得更加复杂，将它们拆分成模块有助于保持可管理性。通过将翻译限制在更小的类别中，例如前端和后端，可以帮助管理。

示例维护工作流

创建字符串项目。根据示例，项目前端和项目后端。
创建与字符串项目对应的源区域文件。

创建一个配置文件，其中包括项目中源区域文件的位置，并将其与相应的字符串项目匹配：

短语：
  access_token: "3d7e6598d955bfcabaf1b9459df5692ac4c28a17793"
  file_format: yml
  推送：
    源：
    # 前端
    - 文件：./path/to/locales/frontend/en.yml
      project_id: "5c05692a2a995c0c45c0c3cbfcab1"
      参数：
        locale_id: "159d48e76802f789d9b8fb6d368e61bc"

    # 后端
    - 文件：./path/to/locales/backend/en.yml
      project_id: "0c45c0c3cbfcab15c05692a2a995c"
      参数：
        locale_id: "fb6d368e61bc159d48e76802f789d9b8"
  拉取：
    目标：
    # 前端
    - file: ./path/to/locales/frontend/<locale_name>.yml
      project_id: "5c05692a2a995c0c45c0c3cbfcab1"

    # 后端
    - 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