Crowdin

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

Настройка

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

После того, как проект готов, вам нужно добавить идентификатор проекта Crowdin в параметры i18n в config.js. Убедитесь, что у вас также установлен главный язык(defaultLocale):

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}

Использование переменных environment
Если переменные environment CROWDIN_KEY установлен, не нужно использовать --key
аргумент, вы можете переводить, как показано ниже:
cmints --crowdin update-sources
cmints --crowdin get-translations
cmints --crowdin update-translations