OptimiDoc ships its web and terminal interface in five languages, and administrators can review, correct, and extend those translations directly in the browser. Two tools work together: Translation Mode for editing strings in place, and the Translation Editor for working through every string in a table. Both let you export the result as a JSON file, and you can even bootstrap an entirely new language. All translation editing is administrator-only.
How It Works
OptimiDoc's interface text is stored as translation keys, each with a value per language. The built-in editor lets you override any of those values and preview the change live, then download the result. Edits are held in your browser session only — they are not written back to the server. To make a translation permanent, export it and provide the JSON file to your OptimiDoc contact so it can be included in a build. This makes the editor ideal for proofreading, tuning terminology to your organisation, or preparing a brand-new language file.
The interface is available in the following languages out of the box:
-
English
-
Czech
-
German
-
French
-
Polish
Translation Mode (in-context editing)
Translation Mode lets you edit strings where they appear, without hunting for keys.
-
Open the user (avatar) menu in the top-right corner.
-
Choose Enable Translation Mode. (The option is only shown to administrators.)
-
A small toolbar appears, and interface strings become editable — click a string to edit it in a pop-over. Your change is applied immediately across the interface so you can see it in context.
-
Choose Disable Translation Mode from the same menu when you are finished.
Edits made in Translation Mode are collected together with those made in the Translation Editor, ready to export.
The Translation Editor
The Translation Editor gives you a complete, searchable table of every translation key. Open it at /translations (administrator-only).
|
Control |
Purpose |
|---|---|
|
Ref language |
The reference column shown alongside each key, so you can translate against a known-good language. |
|
Edit language |
The language whose values you are editing. |
|
Namespace filter |
Narrows the table to one area of the interface (for example, |
|
Search |
Filters keys by key name or by text in any shown language. |
|
Diff / Full |
Exports your changes — see below. |
|
Discard |
Clears all pending edits and restores the original values. |
|
New language |
Creates a new working language (see below). |
To edit a value, click it in the Translation column, type the new text, and confirm. Edited rows are highlighted and counted, so you can always see how many changes are pending.
Creating a New Language
You can prepare a translation for a language OptimiDoc does not yet ship:
-
In the Translation Editor, click New language.
-
Enter a two-letter language code (for example,
sk) and a display name (for example,Slovenčina). -
Choose an existing language to copy from — its values become the starting point.
-
Translate the strings as needed, then export the full language file.
The new language exists only in your browser until you export it; hand the exported file to your OptimiDoc contact to have it added to the product.
Exporting Translations
Two export options are available, both of which download a JSON file:
|
Export |
Contents |
File name |
|---|---|---|
|
Diff |
Only the keys you have changed |
|
|
Full |
The complete set of values for the language |
|
Use Diff when submitting a handful of corrections, and Full when preparing a complete or new language file.
Important Notes
-
Translation editing is administrator-only — the menu option and the editor route are hidden from other users.
-
Edits are stored in the browser session and are lost if you clear them or the session ends. Export before you finish.
-
Nothing is written to the server automatically; exported files must be incorporated into an OptimiDoc build to take effect for everyone.