Переводы фреймворка

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

Дополнения с переводами

С помощью нашего коммьюнити, мы предоставляем переводы сообщений фреймворка на несколько языков в виде дополнений с переводами. Дополнение с переводом – это набор файлов сообщений, запакованных в JAR, которые можно добавить в ваш проект как зависимость. Дополнения с переводами можно найти в каталоге дополнений Jmix: откройте окно инструментов Jmix в Studio, выберите пункт Add-ons и нажмите Marketplace в его контекстном меню. В открывшемся окне Add-ons отфильтруйте содержимое по тегу Localization.

Перевод сообщений фреймворка в проекте

Если необходимо перевести сообщения фреймворка на другой язык, можно сделать это прямо в проекте. Ниже приведен рекомендуемый способ:

  • Клонируйте репозиторий https://github.com/jmix-framework/jmix и выберите ветку, соответствующую версии Jmix, используемой в проекте.

  • В зависимости от того, какие дополнения используются в вашем проекте, скопируйте все или некоторые файлы messages.properties из папки jmix-translations/content в те же пути в папке src/main/resources вашего проекта.

  • Переименуйте файлы messages.properties в messages_<language>.properties (например, messages_fr.properties для французского) и переведите сообщения.

Вклад в переводы

Если вы хотите внести свой вклад в перевод фреймворка, присылайте нам пул-реквесты с новыми языками или изменениями в существующих переводах.

Выполните следующие шаги, чтобы создать pull request:

  1. Сделайте форк репозитория https://github.com/jmix-framework/jmix, нажав кнопку Fork на странице репозитория. Убедитесь, что выбрана галочка Copy the master branch only.

  2. Клонируйте форк в локальную папку, например /work:

    cd /work
    git clone https://github.com/<your-username>/jmix.git
  3. Создайте набор файлов messages_<language>.properties в папке /work/jmix/jmix-translations/content. Вы можете скопировать английские файлы messages.properties, переименовать их в messages_<language>.properties (например, messages_es.properties для испанского) и перевести сообщения.

  4. Сделайте коммит изменений и отправьте их в форк:

    git add -A
    git commit -m "<your_language> translation"
    git push
  5. Перейдите на страницу вашего форка https://github.com/<your-username>/jmix и нажмите ContributeOpen pull request. На странице Comparing changes введите заголовок и описание, затем нажмите Create pull request.