norcube langsync terms import
Import terms and translations from a CSV file
Imports a CSV file with a header row into a namespace: one column holds the marks (source strings), the others context or translations.
Columns are matched by their header: mark, key, term or source is the mark; context, description, comment or note is the context; a language code or name attached to the namespace (en, cs, "Czech") holds that language's translations. Map any other header with --column "<header>=<mark|context|ignore|language code>"; the command refuses to guess.
Existing terms with the same mark are skipped unless --overwrite is set.
With --auto-translate, AI fills in the languages the file leaves empty.
The import finishes on the server after the command returns; --wait
waits for it (and exits 1, code job_failed, when it failed), and
terms import status <import-id> checks on it later.
--dry-run shows how each column would be imported, without uploading.
Usage
norcube langsync terms import <file.csv> [flags]
norcube langsync terms import <command> [flags]Examples
norcube langsync terms import strings.csv --namespace web
norcube langsync terms import export.csv -n web --column "String ID=mark" --column "Notes=ignore"
norcube langsync terms import strings.csv -n web --overwrite --auto-translate --dry-run
norcube langsync terms import strings.csv -n web --waitCommands
| Command | Description |
|---|---|
status | Show how a CSV import is doing |
Flags
| Flag | Default | Description |
|---|---|---|
--auto-translate | AI-translate the languages the file leaves empty | |
--column | Map a CSV header: "<header>=<mark|context|ignore|language code>" (repeatable) | |
--dry-run | Show how each column would be imported, without uploading | |
-n, --namespace | Namespace name; picker opens when omitted and stdin is a TTY | |
--overwrite | Replace existing terms that have the same mark | |
--prompt | Custom prompt id for --auto-translate instead of the namespace's default | |
--wait | Wait until the import finishes (Ctrl-C stops waiting, not the import) | |
--wait-timeout | 30m0s | Give up waiting after this long (the job keeps running on the server) |
Every command also takes the global flags: --profile, --org, -o, --query, --debug and more.
See also
norcube langsync terms: Manage terms (source strings) inside a namespace