Itsnotlupus' I18N Support

no budget? no translators? no problem.

此腳本不應該直接安裝,它是一個供其他腳本使用的函式庫。欲使用本函式庫,請在腳本 metadata 寫上: // @require https://update.greasyfork.org/scripts/471000/1226218/Itsnotlupus%27%20I18N%20Support.js

作者
itsnotlupus
版本
1.2.2
建立日期
2023-07-17
更新日期
2023-07-27
授權條款
MIT

There are 2 kind of localized strings you'll find in userscripts:

  1. strings found in the original web page.
  2. strings used by the userscript itself.

To get the former translated, you will need to hook into the web app and somehow get a hold of the proper localized strings.
For the latter, you can rely on this library to ask Google Translate for some machine-translated strings.
It's not going to be flawless, but it should generally be close enough.
API results are cached locally to keep things friendly with Google.

Pass an array for strings found in the original page, and an object mapping ids to strings for your userscript strings.

Usage pattern:

    await i18n.init({
      stringsArray: [ <Array of english app strings> ],
      stringsObject: { <Object mapping ids to english script settings> },
      strings: ,
      lang: "<language code ('en','fr','es', etc.)>",
      callback: async (stringsArray) => return { <Object mapping english app strings to localized app strings> }
    });

All of the object values are optional, but you'll probably want to pass at least one of the strings values.
document.documentElement.lang will be used as value for lang by default.
The callback function can be asynchronous and will be awaited correctly.
Only pass a callback if you pass an array of string, as it's useless otherwise.
Note that the .init() method is asynchronous and must be awaited before you can start using t`string`.

Afterward, you can use t`<english app string>` or t`<script id>` to get a localized string.

( setEnStrings, setLanguage and initLanguage are kept around for backward whateverability, but probably don't use them. )

MISSING: templating, pluralization, or really anything difficult. this is just a cheap stop-gap.