User:MonkeysHK/sandbox3

International Integrations
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
 * 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.

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

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.