Загрузка и выгрузка файлов локализации (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

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

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

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

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

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

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

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

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

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

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

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