From 9020278b7de4b44dca7a5cff7e338fede0e54da7 Mon Sep 17 00:00:00 2001 From: skyace65 Date: Fri, 25 Jul 2025 16:10:14 -0400 Subject: [PATCH] Document previewing translations in editor --- tutorials/i18n/img/locale_editor_preview.webp | Bin 0 -> 10658 bytes tutorials/i18n/internationalizing_games.rst | 11 +++++++++-- 2 files changed, 9 insertions(+), 2 deletions(-) create mode 100644 tutorials/i18n/img/locale_editor_preview.webp diff --git a/tutorials/i18n/img/locale_editor_preview.webp b/tutorials/i18n/img/locale_editor_preview.webp new file mode 100644 index 0000000000000000000000000000000000000000..7aa0f39de9fff6a3c0dfdb8e82cc68b15794ca57 GIT binary patch literal 10658 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 literal 0 HcmV?d00001 diff --git a/tutorials/i18n/internationalizing_games.rst b/tutorials/i18n/internationalizing_games.rst index 9ae09fe97..b46ce4dbf 100644 --- a/tutorials/i18n/internationalizing_games.rst +++ b/tutorials/i18n/internationalizing_games.rst @@ -355,10 +355,10 @@ buttons). Otherwise, they can remain the same. Testing translations -------------------- -You may want to test a project's translation before releasing it. Godot provides two ways +You may want to test a project's translation before releasing it. Godot provides three ways to do this. -First, in the Project Settings, under **Internationalization > Locale** (with advanced settings enabled), there is a **Test** +First, in the Project Settings, under :menu:`Internationalization > Locale` (with advanced settings enabled), there is a **Test** property. Set this property to the locale code of the language you want to test. Godot will run the project with that locale when the project is run (either from the editor or when exported). @@ -369,6 +369,13 @@ Keep in mind that since this is a project setting, it will show up in version co it is set to a non-empty value. Therefore, it should be set back to an empty value before committing changes to version control. +Second, from within the editor go to the top bar and click on :button:`View` on the top bar, then go down to +:ui:`Preview Translation` and select the language you want to preview. + +.. image:: img/locale_editor_preview.webp + +All text in scenes in the editor should now be displayed using the selected language. + Translations can also be tested when :ref:`running Godot from the command line `. For example, to test a game in French, the following argument can be supplied: