Meridian handbook
ReferenceCLI

locale

engine-dmo locale: Locales: list, coverage, what has drifted, rebuild the staleness table, add a locale's drafts. Every subcommand, argument and flag.

Locales: list, coverage, what has drifted, rebuild the staleness table, add a locale’s drafts.

CommandWhat it does
engine-dmo locale addQueue a run that seeds a new locale with drafts of the chosen types, and a translation job that owns them
engine-dmo locale coverageThe translation dashboard, as data
engine-dmo locale listCodes, source, groups, fallback and coverage
engine-dmo locale rebuild-stateRecompute translation_field_state for every document
engine-dmo locale removeReport what removing a locale takes off the sites, and write the redirects to its fallback
engine-dmo locale staleWhat has drifted in a locale, by document and field

engine-dmo locale add

Queues a locale.add run: the documents enabled on every site that enables the locale are seeded in batches from --seed, resumable from where a batch stopped, and a translation job is made for the documents. --dry-run counts by type and writes nothing; --wait works the batches in this process and reports progress.

engine-dmo locale add <code> [flags]
ArgumentRequiredRepeatable
codeyesno
FlagTypeDefaultMeaning
--assignstringgroup to queue the job for (default: the locale’s translators group)
--dry-runboolcount by type without writing
--jobstringname of the translation job to create
--no-jobboolseed without creating a translation job
--seedstringsource locale (default: the source)
--strategystringdraftabsent | draft
--typesstringcomma separated type keys (default: every type)
--waitboolwork the batches in this process and report progress

--json prints the text output in the JSON envelope. Runs in a project.

engine-dmo locale coverage

The translation dashboard, as data.

engine-dmo locale coverage [flags]
FlagTypeDefaultMeaning
--sitestringsite key (default: the default site)

--json prints the command’s own JSON document. Runs in a project.

engine-dmo locale list

Codes, source, groups, fallback and coverage.

engine-dmo locale list [flags]
FlagTypeDefaultMeaning
--sitestringsite for the coverage figure

--json prints the command’s own JSON document. Runs in a project.

engine-dmo locale rebuild-state

Recompute translation_field_state for every document.

engine-dmo locale rebuild-state

--json prints the text output in the JSON envelope. Runs in a project.

engine-dmo locale remove

Lists every live path the locale answers with the fallback path that serves the same document, and the paths with no fallback, which will 404. --apply-redirects writes a permanent redirect for each path with a fallback; it takes effect when the locale leaves config/ and engine-dmo schema apply runs. Content is never deleted: the locale’s rows are kept, so enabling it again recovers everything.

engine-dmo locale remove <code> [flags]
ArgumentRequiredRepeatable
codeyesno
FlagTypeDefaultMeaning
--apply-redirectsboolwrite the proposed redirects
--dry-runboolreport without writing (the default unless --apply-redirects)

--json prints the command’s own JSON document. Runs in a project.

engine-dmo locale stale

What has drifted in a locale, by document and field.

engine-dmo locale stale [flags]
FlagTypeDefaultMeaning
--localestringthe target locale
--sitestringsite key (default: the default site)

--json prints the command’s own JSON document. Runs in a project.