hyva-themes/magento2-i18n-csv-diff

Magento command to display all translations that are present in the first CSV file but not in the second.

1.0.2 2023-08-11 09:36 UTC

This package is auto-updated.

Last update: 2024-10-28 10:57:07 UTC


README

Hyvä Themes

hyva-themes/magento2-i18n-csv-diff

Supported Magento Versions

This module adds the bin/magento i18n:diff-csv and i18n:translate-csv commands.

i18n:diff-csv

The command takes two CSV files as arguments.
It displays all translations that are present in the first CSV file but not in the second, based on the first colum in the files.

i18n:translate

The command takes a target language 2-letter ISO code as the argument.
It reads a Magento localization CSV dictionary from stdin, translates it using the DeepL API, and writes it to stdout.
Be sure to check the automatic translations afterwards!

Usage Examples:

  • Collect all Magento and Hyvä strings:

    bin/magento i18n:collect-phrases vendor/magento/ > magento-strings.csv
    bin/magento i18n:collect-phrases vendor/hyva-themes/magento2-default-theme/ > hyva-strings.csv
    bin/magento i18n:collect-phrases vendor/hyva-themes/magento2-theme-module/ >> hyva-strings.csv
  • Find all Hyvä specific translations that are not part of native Magento:

    bin/magento i18n:diff-csv hyva-strings.csv magento-strings.csv
  • Find all translations that are missing in a Hyvä translation file:

    bin/magento i18n:diff-csv hyva-strings.csv i18n/de_DE.csv
  • Find all translations that are in a translation file but are not used in Hyvä:

    bin/magento i18n:diff-csv i18n/de_DE.csv hyva-strings.csv
  • Add new translations to an existing dictionary file.

    bin/magento i18n:diff-csv hyva-strings.csv i18n/de_DE.csv | bin/magento i18n:translate-csv DE >> i18n/de_DE.csv

Installation

  1. Install via composer
    composer require hyva-themes/magento2-i18n-csv-diff
    
  2. Enable module
    bin/magento setup:upgrade
    

Configuration

To use the Deepi18n:translate-csv command, configure your API key in the system configuration at Hyva Themes > Localization CLI > Translation > DeepL API Key.

License

The BSD-3-Clause License. Please see License File for more information.