Загрузка и выгрузка файлов локализации (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.<locale_name>.yml
        params:
          tags: accounts
      # emails
      - file: ./path/to/locales/emails.<locale_name>.yml
        params:
          tags: emails

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

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

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

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

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

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

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

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

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

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

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