Function translateString

src/engine/i18n.ts:17–40

(engine: VisualNovelEngine, key: string)

 * user's preferences.
 */
export function translateString (engine: VisualNovelEngine, key: string): string | undefined {
  const language = engine.preference ('Language') as string;

  if (typeof engine._translations[language] === 'undefined') {
    FancyError.show ('engine:translation:language_not_found', {
      language: language,
      availableLanguages: Object.keys (engine._translations),
      languageSelectorValue: `<pre><code class='language-markup'>${$_('[data-action="set-language"]').value ()}</code></pre>`
    });

    return undefined;
  }

  if (typeof engine._translations[language][key] === 'undefined') {
    FancyError.show ('engine:translation:key_not_found', {
      key: key,
      language: language,
      elements: $_(`[data-string="${key}"]`).collection,
      availableStrings: Object.keys (engine._translations[language])
    });
  }

  return engine._translations[language][key];
}

export function localize (engine: VisualNovelEngine): void {
  engine.trigger ('willLocalize');