Skip to content

Translation

tech-kev edited this page Mar 24, 2026 · 1 revision

Translation

SharedMoments includes a built-in Translation Manager - Languages can be added and edited directly from the web interface.

Currently included languages: German and English.


Accessing the Translation Manager

Open the sidebar and select Manage Translations (requires the "Manage Translations" permission).


Adding a New Language

  1. Click Create new translation in the Translation Manager
  2. Enter the language code (e.g. fr-FR, es-ES, pt-BR)
  3. SharedMoments automatically generates all required translation entries for the new language

All entries start empty and can be filled in using the editor.


Editing Translations

  1. Select a language from the list
  2. Edit the translated text for each entry
  3. Changes are saved and applied immediately

Each entry shows the original text and an optional help text for context.

Focus Mode

Use the focus mode to translate entries at a time, making it easier to work through large translation sets.


After You're Done

Once you've finished translating, you can test your work and contribute it back to the project:

  1. Go to User Settings and change your language to the one you just translated
  2. Browse the app to verify everything looks correct
  3. When you're happy with the result, go back to the Translation Manager and click Export to download your translation as a JSON file
  4. Head over to the SharedMoments GitHub repository and create a Pull Request with your translation file

Your contribution will be reviewed and included in a future release for everyone to use.

Admin Tools

Load from Code

Scans the codebase for all translatable texts (marked with _()) and loads them into the English language as base entries.

Approve Translations

Takes all newly added English base entries and distributes them to every other language. This creates empty translation entries so translators can fill them in.

Reset Language

Resets a language back to its default state by reloading from the built-in JSON files. This overwrites all manual edits for that language.

Clone this wiki locally