Загрузка и выгрузка файлов локализации (Strings)

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

На любой странице проекта выберите Загрузки в меню Еще, чтобы получить доступ к архиву загрузок.

Архив загрузок содержит все исторические загрузки во всех возможных статусах. Нажмите на раскрывающийся список Все статусы, чтобы фильтровать загрузки по статусу (Успешно, Ошибка и/или Ход выполнения). Чтобы найти конкретную загрузку, используйте поле поиска в верхней части, чтобы выполнить поиск по имени.

Получить доступ к подробным сводкам загрузки затронутых ресурсов можно, нажав на загрузку в списке. Все успешные загрузки также представлены в ленте активности проект.

Параметры скачивания отображаются при скачивании файла в окне Скачать с вкладками Общие, Дополнительно и Кодировка.

Выбор различных форматов файлов предоставляет различные параметры. Для получения более подробной информации обратитесь к соответствующей статье о конкретном формате файла.

При необходимости используйте поле Имя файла на вкладке Общие, чтобы указать Пользовательский имя файла для экспорта, или оставьте его пустым, чтобы создать системное имя.

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

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

Хранение отдельных файлов

Как правило, храните все переводы для каждого языка в одном файле. Это делает загрузку ресурсов быстрее и надежнее. Переводы организованы в проекты, поэтому отдельные небольшие файлы не требуются.

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

Присваивайте ключам уникальные имена во всех файлах для обеспечения бесперебойного рабочего процесса. При подходе на основе пар «ключ-значение» ключу должны быть назначены одинаковые значения в каждом контексте. Некоторые фреймворки позволяют использовать неуникальные ключи в нескольких файлах. Некоторые форматы, такие как Symfony, поддерживают отрасли сообщений. Эти отрасли определяются по имени файла. Ключи не ограничиваются автоматически отраслями на основе имени файла, но это можно решить, используя уникальный префикс отрасли для ключей внутри файла.

Пример конфигурации CLI

При работе с CLI или подключении проекта к хранилищу (например, GitHub, GitLab или Bitbucket) настройте файл конфигурации для управления загрузкой и выгрузкой.

Для примера, в проекте есть несколько семантически именованных файлов перевода для оригинала языкового стандарта. Например: accounts.en.yml, emails.en.yml и т. д. Эти семантические имена управляются с помощью тегов.

Настройте .phrase.yml, чтобы отразить организацию файлов в проект локализации и связать их с тегами в проект Strings, включив заполнитель тега в путь к файлу:

phrase:
  access_token: "3d7e6598d955bfcab104c45c40af1b9459df5692ac4c28a17793"
  project_id: "23485c9c5dfb15d85b32d9c5f3d2hl54"
  file_format: yml
  push:
    sources:
      - file: ./path/to/locales/<tag>.en.yml
        params:
          locale_id: \"abcd1234cdef1234abcd1234cdef1234\"
  pull:
    targets:
      # accounts
      - file: ./path/to/locales/accounts.<языковой стандарт_name>.yml
        params:
          tags: accounts
      # emails
      - file: ./path/to/locales/emails.<языковой стандарт_name>.yml
        params:
          tags: emails

Параметр tags также можно использовать в разделе push вместо использования заполнителя <tag>.

Конфигурация создает ключи с тегами на основе файла, из которого они были получены, при выполнении push или запуске синхронизации из хранилища. При выполнении pull или запуске экспортировать в хранилище ключи группируются в файлы на основе их тегов.

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

Дальнейшее разграничение требуется, если:

Локализация статического продукта

Если продукт полностью разработан и редко обновляется, отдельная версия продукта может существовать в рамках проекта.

Локализация проекта с постоянными обновлениями

Если продукт постоянно обновляется новым контентом (ключи), применять эти обновления к нескольким проектам и поддерживать их синхронизацию сложно. Использовать выделенные языки в рамках проекта для их поддержки.

Языковые коды, соответствующие стандарту ISO (например, en-US), не обязательно должны быть уникальными, поэтому можно создать внутри проекта множество версий одного и того же языка. Различайте регионы, клиентов или аудитории, используя уникальное название языка.

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

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