Crowdin

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

Настройка

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

After the project is ready, you need to add Crowdin project ID to i18n options in the config.js file. Ensure that you also have defaultLocale set there as well:

const i18nOptions = {
  defaultLocale: "en",
  crowdin: {
    id: "cmints-website"
  }
};

module.exports = {i18nOptions};

Загрузка исходных строк перевода

После настройки проекта вы можете использовать интеграцию CMintS API для загрузки всех исходных строк перевода вашего веб-сайта в Crowdin проекта, для этого используйте ключ API Crowdin с помощью Crowdin Синхронизация API. Вы можете найти ключ API Crowdin на ключевой вкладке проекта страница настроек:

Crowdin api location

После того, как вы найдете ключ API crowdin, запустите команду ниже в корневом каталоге Crowdin, заменив crowdin-key на фактический ключ :

# Replace {crowdin-key} with the actual one
cmints --crowdin update-sources --key {crowdin-key}

Это создаст исходные JSON-файлы из проекта <fix1> и загрузите их в проект Crowdin.

Скачать переводы

После того, как переводы будут готовы в crowdin, которые будут загружены, и перевод проекта, выполните команду ниже в корневом каталоге Crowdin:

# Replace {crowdin-key} with the actual one
cmints --crowdin get-translations --key {crowdin-key}

Примечание:, чтобы обновить правильные локали, имена каталогов внутри locales должен быть совместим с переводом Crowdin именами локалей .

Загрузить переводы

Используйте команду ниже, чтобы обновить проект crowdin с помощью локального перевода:

# Replace {crowdin-key} with the actual one
cmints --crowdin update-translations --key {crowdin-key}

Using environment variables

If the environment variables CROWDIN_KEY is set, no need to pass the --key argument so you can invoke translation as shown below:

cmints --crowdin update-sources
cmints --crowdin get-translations
cmints --crowdin update-translations