Sv443 55e68235f3 ref: refactor imports 6 ماه پیش
..
fonts ee3a55a210 feat: add cascadia code font 6 ماه پیش
icons 7b6d0657a1 feat: generic prompt dialog 6 ماه پیش
images 73eceaa945 feat: ok actually final icon no cap on god on jah frfr 6 ماه پیش
style c36ade8292 fix(#106): volume features now work with both normal and expanded slider elements 6 ماه پیش
translations 55e68235f3 ref: refactor imports 6 ماه پیش
README.md 7cb7b7c050 feat: plugin registration stuff 11 ماه پیش
locales.json fb2287c890 fix: edit locale codes to match bcp 47 6 ماه پیش
plugins.json 5d52d42ec2 fix: gen-readme works now 1 سال پیش
require.json 23d014a7ea ref: include eof line break 6 ماه پیش
resources.json a08f0d42ee ref: use build branch for changelog resource url 6 ماه پیش

README.md

Asset formats explained


Images:

  • PNG images and external assets are stored in assets/images
  • SVG images are stored in assets/icons
  • CSS files in assets/style
  • Translations are in assets/translations


JSON file formats:

[!NOTE]
Note: If a property is wrapped with square brackets ([name]), it means that the property is optional


locales.json

This file contains a definition of the available locales and translations.
The keys of the object are the locale codes, and the values are the locale objects, with the following properties:

Property Type Description
name string The name of the locale in the locale's language
nameEnglish string The name of the locale in English
emoji string The flag emoji of the locale
userscriptDesc string The description of the userscript in the locale's language
authors string[] The authors of the translations


plugins.json

(Not fully implemented yet, but should still be filled out when a plugin is added)

For the structure of this array of objects, see type PluginObj in src/types.ts


require.json

This file contains the npm libraries that are loaded into the runtime through the @require userscript directive.
It's an array of objects, which each have one of the following sets of properties:

Using npm and a CDN: | Property | Type | Description | | :---------- | :-------- | :------------------------------------------------------------------------------------ | | pkgName | string | The name of the npm package, as in npm i <pkgName> | | path | string | The path to the file that should be loaded, relative to the library root dir | | global | string | The name of the global variable that the library exports | | [baseUrl] | string | Base URL of the CDN to use - https://cdn.jsdelivr.net/npm/ by default | | [link] | boolean | Whether npm link is active and the library should instead be included in the bundle |

Using a direct URL: | Property | Type | Description | | :------- | :-------- | :------------------------------------------------------------------------------------ | | url | string | URL to the file to include | | global | string | The name of the global variable that the library exports | | [link] | boolean | Whether npm link is active and the library should instead be included in the bundle |