Skip to the content
Documentation

exp:i18n

No ratings yet

Available since Exponential 6.0.15 (in development, not in a release yet).

Summary

The translation fallbacks: per locale the chain of translations it falls back to, and how much of the kernel and of each extension it shows translated; --check for CI

Usage

./console exp:i18n [options]
php bin/php/i18n.php [options]
./console exp:i18n [options]

Aliases

exp:i18n

Help

The output of ./console help exp:i18n (the script run with --help), without the standard options:

Usage: bin/php/i18n.php [OPTION]... [ACTION]
The translation fallbacks (i18n.ini [TranslationSettings], doc/eng-us/languages.md)

./console exp:i18n fallbacks                         every locale: its chain, kernel and extension coverage
./console exp:i18n fallbacks --only=fallback         only the locales translated through a fallback
./console exp:i18n fallbacks --locale=esl-AR,ger-AT  each step with its rule, and every extension
./console exp:i18n fallbacks --format=json           one JSON object
./console exp:i18n check [--strict]                  cycles, chains too long, missing targets, rules
                                                     that are none: exit 1 when there is one (CI)
./console exp:i18n coverage                          the totals and the world map at the top of
                                                     doc/eng-us/languages.md and doc/ger-de/sprachen.md:
                                                     write what changed (--raster: every WebP copy)
./console exp:i18n coverage --check                  compare only: exit 1 when they are out of date
./console exp:i18n waves                             the translation waves at the top of
                                                     doc/eng-us/translation-waves.md and
                                                     doc/ger-de/uebersetzungswellen.md: write what changed
./console exp:i18n waves --check                     compare only: exit 1 when a percentage changed or a
                                                     size is more than 3 % off
./console exp:i18n waves --list                      the whole queue, one wave a line
./console exp:i18n waves --wave=ara-SA/H-help        the pages (contexts, files) of a wave, which are done

Exit code: 0 fine, 1 problems found (check, or --check), 2 usage error.


Options:
  --locale=VALUE   Only these locales, comma separated (esl-AR,ger-AT): each step of the chain and every extension
  --format=VALUE   table (default) or json
  --only=VALUE     With the list: own (a translation of its own), fallback (translated through a fallback) or untranslated
  --check          Check the fallbacks as the check action does, after the list; with coverage: compare only, change nothing
  --strict         With check: warnings (a configured locale without a locale file, a chain without a translation) fail too
  --no-extensions  Leave out the coverage of the extensions (reading their files the first time takes seconds)
  --raster         With coverage: write the WebP copy of every map again, not only of the maps that changed
  --date=VALUE     With coverage: the date of the figures when they changed (YYYY-MM-DD, default today)
  --list           With waves: print the whole queue, one wave a line
  --wave=VALUE     With waves: the pages, contexts or files of one wave (ara-SA/H-help) or work set (A03), and which are done

Options

Option Value Description
--locale required Only these locales, comma separated (esl-AR,ger-AT): each step of the chain and every extension
--format required table (default) or json
--only required With the list: own (a translation of its own), fallback (translated through a fallback) or untranslated
--check - Check the fallbacks as the check action does, after the list; with coverage: compare only, change nothing
--strict - With check: warnings (a configured locale without a locale file, a chain without a translation) fail too
--no-extensions - Leave out the coverage of the extensions (reading their files the first time takes seconds)
--raster - With coverage: write the WebP copy of every map again, not only of the maps that changed
--date required With coverage: the date of the figures when they changed (YYYY-MM-DD, default today)
--list - With waves: print the whole queue, one wave a line
--wave required With waves: the pages, contexts or files of one wave (ara-SA/H-help) or work set (A03), and which are done

Arguments

[ACTION]

Standard options

Every script also takes the standard options of the script framework: --help, --quiet, --siteaccess, --debug, --colors, --no-colors, --logfiles, --no-logfiles, --verbose and --allow-root-user.

Source

bin/php/i18n.php, kernel/private/classes/commands/i18n.php

See also

Generated example: exp:i18n

Added to the reference for Exponential 6.0.15.

Contributors

Comments

Add a comment

Comments are read by a moderator before they appear.