Language and voice
The Language and voice page (Control centre, Settings) controls the language of the whole app, the tone of headline messages and the optional narrator.
#How it works
Core/Language.csis the language layer. It walks every window, remembers the English original of each piece of text and shows the text for the current mode. Switching back to English restores the exact original strings. It runs before the personal wording layer, so personal wording is applied on top of the chosen language and clearing it restores the chosen language.Core/Strings.yue.csholds the Cantonese table plus pattern rules for built strings such as counts and times. Paths, commands, codes, format names, game titles and product names are deliberately left in English. Text in a monospace font is never translated, exactly like the wording layer.Core/Narrator.cswrapsWindows.Media.SpeechSynthesisand plays throughMediaPlayerwith a single queue.Core/Settings.Language.csholds the persisted settings.
#Developer hooks
Core.Language.Initialize(); // once at start-up, after WordingLayer.Install()
Core.Language.T("Clipboard history"); // text for the current mode
Core.Language.Headline("convert.done", "MP4"); // humour headline; facts go in as arguments
Core.Language.Title(title); // strips emoji when the switch is off
Narrator.Speak(title, Core.Language.Yue(title)); // queues speech for a toast titleInside a class derived from FrameworkElement (any window), write Core.Language or alias it, because FrameworkElement.Language hides the type name.
Headline keys: offline.title, online.title, ip.changed, convert.done, convert.failed, push.done, push.failed, game.mode, snooze, history.empty, search.none, update.available, welcome, narrator.test, plus convert.start, convert.cancelled, ffmpeg.missing, task.done, task.failed, shortcut.done, shortcut.failed, offline.noadapter, offline.noaddress, offline.noroute, offline.signin, offline.router, notice.* and mode.on. Language.NoticeTitle(title) maps a plain notice title to its key, and Language.NetHeadline(diagnosis) maps a network diagnosis the same way. Each key has five English and five Cantonese variants, and the self-test checks that the levels differ while keeping the same facts.
#Failure modes
- A string with no Cantonese entry stays in English in every mode; it is never replaced by a guess.
- Without an installed Cantonese voice, Cantonese is not spoken and the page says so, with a link to the Windows speech settings (
ms-settings:speech). - Speech failures are logged and shown on the page; they never block a toast.
#Verification
Compile-checked, with self-test checks written for headline levels and facts, accessible-name round trips and the School mode language page (not yet run by the author on a hidden desktop). Runtime checks still to do: switching the mode with several windows open, restoring English exactly, bilingual line breaks in narrow chips, and speaking with real installed voices.
#Reviewer sheet
cantonese-review.md lists every Cantonese table entry beside its English key, grouped by page, for a native speaker to review. No native review has happened yet. The self-test check language: every visible string on every page and window has a Cantonese entry writes the data it is built from.
Articles
App language
Read itEnglish humour and Cantonese humour
Read itEmoji in dialogs
Read itRead toasts aloud
Read itEnglish voice and Cantonese voice
Read itSpeaking rate
Read itTest voice and Stop speaking
Read itCantonese review sheet
This sheet lists every entry of the Hong Kong Cantonese table (Strings.Table in Core/Strings.yue.cs and Core/Strings.yue.More.cs), English on the left and Cantonese on the right, grouped by the page…
Read it