Function localize

src/engine/i18n.ts:42–69

(engine: VisualNovelEngine)

}

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

  // Setup the correct locale for the dates
  const language = engine.preference ('Language') as string;

  const langMetadata = engine._languageMetadata[language];

  if (langMetadata?.code) {
    Settings.defaultLocale = langMetadata.code;
  }

  engine.element ().find ('[data-string]').each ((element) => {
    const stringKey = $_(element).data ('string');

    if (stringKey) {
      const string_translation = translateString (engine, stringKey);

      // Check if the translation actually exists and is not empty before
      // replacing the text.
      if (typeof string_translation !== 'undefined' && string_translation !== '') {
        $_(element).text (string_translation);
      }
    }
  });

  engine.trigger ('didLocalize');
}

/**
 * This method will try to translate parts of a string