Загрузка и скачивание файлов локализации (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/<тег>.en.yml
        params:
          Идентификатор_языковой стандарт: "abcd1234cdef1234abcd1234cdef1234"
  pull:
    targets:
      # учетные записи
      - file: ./path/to/locales/accounts.<имя_языковой стандарт>.yml
        params:
          теги: учетные записи
      # электронные письма
      - file: ./path/to/locales/emails.<имя_языковой стандарт>.yml
        params:
          теги: электронные письма

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

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

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

Дополнительное различие требуется, если:

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

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

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

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

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

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

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