Docs

Translator guide

How to translate and review strings in the GlotFox editor. You can also edit a string directly in a running app: see in-context editing.

The editor

Open a project and choose Keys. The editor has three panes:

Drag the dividers to resize the panes. On narrow screens the panes stack and you move between them.

Several locales at once

Pick more than one locale in the locale picker to translate them side by side against the same source text. Tab in a field jumps to the next locale that is still missing a value.

Plurals

Keys that use an ICU plural show one field per plural category of the language: for example one and other in German, and one, few, many and other in Lithuanian, plus exact matches such as =0. Text before and after the plural is edited separately and a live preview shows the result. Raw ICU switches to the plain message text; it cannot switch back while the text is not a valid plural.

QA warnings

While you type, GlotFox checks the translation and shows warnings under the field, for example a missing or extra placeholder, a missing plural category, a glossary term not used, or a different number of leading/trailing spaces. Warnings do not block saving, but strings with errors cannot be approved until fixed.

Comments

Open the Comments tab (or press c) to discuss a key. Mention a teammate with @ to notify them. Ctrl/⌘+Enter posts, Esc cancels.

History

The History tab lists every change to the string in every locale: who changed it, when, and the previous value. Restore an earlier version with one click.

Review

Review lists drafts waiting for approval. For each string you see the source, the proposed translation and, with d, a diff against the approved text. Approve it, edit it, or request changes with a note; the translator is notified. Approved strings are included in the next export or pull request.

Keyboard shortcuts

Press ? anywhere in the app to see the full list for the current page. Ctrl/⌘+K opens the command palette. Single-key shortcuts are ignored while you type in a field.

WhereKeysAction
EverywhereCtrl/⌘+KOpen the command palette
Everywhere?Show keyboard shortcuts
Everywhereg then o / k / r / a / sGo to Overview / Keys / Review / Activity / Settings
Everywhereg then p / mGo to projects / members
Editorj / ↓Next key
Editork / ↑Previous key
EditorEnterEdit the first translation field
EditorxSelect or deselect the key
EditoraApprove the key
EditorcComment on the key
Translation fieldCtrl/⌘+EnterSave and leave the field
Translation fieldTabNext locale that is missing a value
Translation fieldEscLeave the field
Reviewj / kNext / previous string
ReviewaApprove
RevieweEdit
ReviewrRequest changes
ReviewcComment
ReviewdShow or hide the diff