i18n-help v0.1.4

i18n-help

A command-line tool to help manage multiple common.json files for internationalization (i18n) purposes.

Installation

You can install i18n-help using npm or yarn:

npm

npm install -g i18n-help

yarn

yarn global add i18n-help

Program Usage

Commands

The following commands are available:

setup

---

Option	Description
<targetFolder>	Target folder to setup
[additionalFolders...]	Additional folders to copy locale files to

Sets up the required config file.

Example:

i18nHelp setup /path/to/target/folder
# This command creates 'i18nHelper.config.json' file with targetFolder value set.

this is the i18nHelper.config.json config file.

{
  "targetFolder": "../path/to/common/folder",
  "additionalFolders": [
    "../other/path/to/copy/targetFolder/1",
    "../other/path/to/copy/targetFolder/2"
  ],
  "sortItemByName": true
}

find

Searches for a word in the common.json files.

Example:

i18nHelp find hello --search-in key --locale en
# This command will search for the word "hello" in the "key" field of the "tr" locale in the common.json files.

copy

Copies locale files from targetFolder to additionalFolders. This ll come in handy if you manually modify the files.

Example:

i18nHelp copy
# This command will copies files from `targetFolder` to `additionalFolders`

add

Adds a new key-value pair to all common.json files.

Example:

i18nHelp add hello world --locale tr=merhaba --overwrite
# This command will add the word 'hello' with value 'world' and the Turkish value 'merhaba' to the common.json files, overwriting any existing key. And if DEEPL_API_KEY has set in your `.env` file, default word 'world' will be translated to related language except locale "tr" because it's manually set.

in your .env.* files:

DEEPL_API_KEY=deepL api key

delete

Deletes a key from all common.json files.

Example:

i18nHelp delete hello --selective
# This command will find all occurrences of the word 'hello' in the common.json files, including partial matches, and ask you to select which ones to delete, separated by commas (e.g. 1,3,5). If "--selective" is not used, the command will delete the key only if it matches exactly.

unused

Finds unused keys in common.json files.

Example:

i18nHelp unused /path/to/directory
# These listed keys might be used as a parameter. Only keys found directly in the file are listed.

License

i18n-help is licensed under the MIT License.

Author

myniqx