Проекты (Strings)

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

Проекты — это место, где собраны основные компоненты переводческого проекта (задания, памяти переводов и терминологические базы). Прежде чем файлы можно будет назначить для перевода в качестве задания, они должны быть назначены и содержаться в проекте.

Назначенные проекты перечислены на вкладке Проекты на странице профиля, и их можно фильтровать по каталогу.

В зависимости от структуры Team, проекты могут определяться по продукту или платформе. Используйте один проект, если всем членам Team требуется получить доступ.

Страница проекта

Открытие проекта отображает его на странице проекта.

На странице проекта можно просматривать и редактировать все сведения о проекте. Также представлены все комментарии, теги, ключи и загруженные файлы.

Создать проект

Чтобы создать проект, выполните следующие действия:

На странице Проекты нажмите Новый проект.

Откроется окно Добавить проект.
Укажите название для проекта.
В раскрывающихся списках выберите Основной формат и Основная технология.
Выберите Контактное лицо из раскрывающегося списка.
Нажмите «Сохранить».

Проект добавлен в профиль.

Эти настройки (например, название проекта, основной формат или контактное лицо) можно изменить на вкладке Общие в Настройки проекта, доступной в меню Еще.

Существующие проекты можно дублировать, выбрав Дублировать проект в меню Еще на странице Проекты. Дублированный проект использует основной формат оригинала. Если этот формат не поддерживает pluralization по умолчанию, то множественное число недоступно. Если основной формат не определен, по умолчанию используется формат .CSV с отключенным множественным числом.

Определить проект

Добавить язык

Минимальное определение для проект — это оригинал и перевод язык. Это оригинал язык текстов и язык, на который они будут переведены, и они изначально определяются в настройка проект.

Чтобы настроить дополнительные языки, выполните следующие действия:

Наведите курсор на проект и нажмите язык.

Открывается вкладка язык.
Нажмите добавить язык. Открывается окно добавить язык.
На вкладке General укажите название языка и языковый код (языковой стандарт).
На вкладке Advanced Выберите оригинал языка из выпадающего список.
На вкладке Review Выберите параметры проверки.
Нажмите «Сохранить».

Язык добавлен в этот проект.

Дополнительные языки можно добавить, нажав добавить язык Add a Language на вкладке язык, а редактировать их можно в меню More options Open More Menu , выбрав Edit редактировать язык.

Настроить переменные

Фрагменты информации и флаги могут храниться в переменных проект. Переменные настраиваются и ими можно управлять через Центр перевода и интерфейс приложений API. Интеграции могут использовать переменные проекта для настройки рабочих процессов или переключения определенного поведения.

Переменные обычно доступны в скриптах через интерфейс приложений API. Как и переменные среды, значение переменной проекта представлено в виде строки, поэтому необходимо указать тип (например, boolean, integer).

Пример 1

У клиента есть разные типы проектов (маркетинговые и продуктовые). Они устанавливают переменную content_type: marketing.
Скрипт интеграции считывает переменную, чтобы решить, как действовать с этим проектом (например, пропустить его через различные проверки контроля качества (QA)).

Пример 2

Клиент работает с Phrase Strings и системой управления контентом (CMS). Они добавляют переменную template_id: 8734-ABCD.
Скрипт интеграции считывает переменную и извлекает правильный шаблон из системы управления контентом (CMS) при публикации локализованного контента.

Переменные могут быть установлены только администраторами и определяются на вкладке Variables в окне Настройки проекта.

Чтобы установить переменную, выполните следующие действия:

На странице проекта откройте окно Настройки проекта из раскрывающегося списка More.
Откройте вкладку Variables.
Укажите имя переменной и значение.

В идеале имена должны быть похожи на переменные среды, такие как MY_VAR, и должны быть уникальными для каждого проекта.
Нажмите Add variable, чтобы добавить больше переменных, и нажмите значок , чтобы удалить их.
Нажмите «Сохранить».

Окно закроется, и переменные будут сохранены.

Ведение нескольких проектов 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.yml на том же уровне, на котором запущен Phrase. Для поддержки более сложных рабочих процессов используйте несколько файлов конфигурации для различных целей.

Чтобы принудительно заставить CLI использовать файл конфигурации для определенных команд, укажите соответствующий файл .yml с помощью флага --config:

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