README

hyva-themes/magento2-i18n-csv-diff

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

This package is licensed under the Open Software License (OSL 3.0).

• Copyright: Copyright © 2020-present Hyvä Themes. All rights reserved.
• License Text (OSL 3.0): The full text of the OSL 3.0 license can be found in the LICENSE.txt file within this package, and is also available online at http://opensource.org/licenses/osl-3.0.php.