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:
- Key list (left): every key with its status. Search, filter by status, and select several rows to act on them in bulk.
- Translation pane (middle): the source text and one field per locale you have open. The field saves when you leave it, or press Ctrl/⌘+Enter.
- Context sidebar (right): the key's description, screenshots, glossary matches, translation memory suggestions, comments and history.
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.
| Where | Keys | Action |
|---|---|---|
| Everywhere | Ctrl/⌘+K | Open the command palette |
| Everywhere | ? | Show keyboard shortcuts |
| Everywhere | g then o / k / r / a / s | Go to Overview / Keys / Review / Activity / Settings |
| Everywhere | g then p / m | Go to projects / members |
| Editor | j / ↓ | Next key |
| Editor | k / ↑ | Previous key |
| Editor | Enter | Edit the first translation field |
| Editor | x | Select or deselect the key |
| Editor | a | Approve the key |
| Editor | c | Comment on the key |
| Translation field | Ctrl/⌘+Enter | Save and leave the field |
| Translation field | Tab | Next locale that is missing a value |
| Translation field | Esc | Leave the field |
| Review | j / k | Next / previous string |
| Review | a | Approve |
| Review | e | Edit |
| Review | r | Request changes |
| Review | c | Comment |
| Review | d | Show or hide the diff |