Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,059 of 9,059 pages
About the help in other languages
All help pages

exp:i18n

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.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/examples/commands/i18n.md

On this page

exp:i18n

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.

Script bin/php/i18n.php, code in kernel/private/classes/commands/i18n.php. Run it from the installation root, as the user the web server runs as:

./console exp:i18n --help
php bin/php/i18n.php --help

Help text

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

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

Read from the option definitions in the code (startup(), getOptions(), options() or ezcConsoleOption). Every script also takes the standard options of the script framework (--help, --siteaccess, --debug, --quiet, --allow-root-user ...).

Arguments: [ACTION].


Generated by ./console exp:help:examples from bin/php/i18n.php, kernel/private/classes/commands/i18n.php. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x