Greasy Fork is available in English.

Itsnotlupus' I18N Support

no budget? no translators? no problem.

此脚本不应直接安装,它是一个供其他脚本使用的外部库。如果您需要使用该库,请在脚本元属性加入:// @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.