Hypixel SkyBlock Wiki:International/Integrations

This part is about International Integrations for international wikis. This part will use "local" or "locally" to refer to a language wiki.

International Customization Standard for JavaScript
Most scripts on the English wiki are already internationally compatible (IC), meaning there is no error due to change of language environment.

Scripts on the English wiki that are internationally compatible and customizable (ICC) will be attached with an International Customization Standard Notice.

The latest version of ICS notice for ICC is as below:


 * Notes
 * For ICC scripts, unless it says "No language implementation" explicitly with the notice, at least one of the msg block and the config block must exist.
 * This approach helps editors or international helpers to fetch updates from a script on the English wiki onto a local environment.
 * You are encouraged to contact the English wiki for any modification for language customization.
 * Wikis may choose to not use localization for any part or at all. For example, console messages can be in English.

For English wiki script writers, revision number (REVISION: X) must be updated every time if anything within the language implementation changed. If the changes exist in the text inside one of the fields, try changing the field name by adding a number after.
 * Revision Number

For translators, when updating a script from the English wiki, replace the language implementation with the local one. If the revision number does not match the English one, update any fields that are added or deleted. After updating fields, update the revision number to match.

Flags exists with the ICS Notice. Flags must be updated to reflect current states of a script that is using ICS.
 * Flags
 * code-modified: If true, a wiki locally modified any part of the file to fit your needs, with clear notes for changes starting with // # LOCAL NOTE #. Editors who update this script must update carefully.
 * code-appended: If true, a wiki locally appended some code, most likely at the end. The code must be surrounded by // # LOCAL BEGIN # and // # LOCAL END #. Editors who update this script must handle those parts accordingly.
 * msg-verified: If false, this script was updated by an editor that has changes to the settings, and the settings are not fully verified in its local environment yet. Fresh imported settings must be labeled // # NEW #. They need to be verified on the local language and have labels removed.

To opt out of ICS flags for an ICS script, you must replace all flags with .

Use of necessary comments in a script is encouraged. When loaded with ImportJS, Gadgets, importArticles, or with a URL of /load.php?mode=articles&only=scripts&articles=..., a trimmed version of a script is loaded, without extra white space characters or comments. The addition of comments should not affect load time.
 * Use of Comments


 * ICC Standard Changelog
 * [ICC-NOTICE-V2] Added revision number
 * [ICC-NOTICE-V1] Added ref link: en:Project:INT#ICS
 * [ICC-NOTICE-V1] Added flags: code-modified, code-appended, msg-verified

CSS Integration
This is a method to import all the latest styling from the English wiki with one button, and maintain a separate local CSS for a local wiki. This is an optional feature provided for international wikis.


 * Creation
 * Script installation. The gadget script that loads the LESS script and relevant tools is: MediaWiki:Gadget-CssTools.js
 * To use Gadgets (scripts that user can opt in-out) for this feature, a wiki should have Gadgets enabled. After that, copy the script above to MediaWiki:Gadget-CssTools.js, then add this setting to MediaWiki:Gadgets-definition:
 * CssTools[ResourceLoader
 * To use normal loading instead of Gadgets, copy the script above to MediaWiki:Common.js/CssTools.js, then add this line to MediaWiki:ImportJS:
 * MediaWiki:Common.js/CssTools.js
 * After installing the script, copy this page from English to the local wiki: MediaWiki:Custom-common.less
 * Create all local CSS. They can be initialized empty or with local styling. This is the list of local CSS:
 * Page for staff colors: MediaWiki:Custom-common.less/staff-colors.less
 * Page for any other local CSS: MediaWiki:Custom-common.less/language-local.less

To prepare local styling for your wiki, put styling on the list of local CSS above. Tips:
 * Update Styling
 * Most CSS syntax or LESS syntax should be usable.
 * Most warnings provided by the editor may be ignored.
 * A LESS page by default is wikitext. The wikitext editor is often unfavourable for doing CSS. The editor can be changed to code mode: Go to Special:ChangeContentModel and select "CSS" for the content model.
 * If styling from English wiki are unfavourable, it is recommended to override them on language-local.less.

There will be two buttons on your MediaWiki:Custom-common.less. To push styling changes to effect:
 * 1) Update LESS Source - Updates the less source. This includes any changes to the core styling provided by the English wiki.
 * 2) Update CSS - It will pull styling from the English wiki and also your local ones.