OOUI/Themes/nl

Thema's geven aan hoe OOUI-interfaces eruit zien en aanvoelen. Een maker van een skin kan thema's aanmaken en deze gebruiken in MediaWiki.

Thema's bieden voornamelijk de CSS, maar ze kunnen ook wat JavaScript-code leveren (in de praktijk wordt dit alleen gebruikt om pictogramvarianten te implementeren) en aangepaste pictogramafbeeldingen (in de praktijk nu niet gebruikt).



Ingebouwde thema's
Twee thema's worden standaard verstrekt.


 * "WikimediaUI" thema dat voldoet aan Wikimedia Foundation's ontwerp stijlgids. Dit is het standaardthema en in actieve ontwikkeling.
 * "Special:MyLanguage/Skin:Apex" thema geïnspireerd door de gelijknamige skin. Het ontvangt alleen onderhoudsupdates.

We zijn niet van plan om meer dan twee ingebouwde thema's te hebben vanwege de extra inspanning die nodig zou zijn om ze te onderhouden.



Aangepaste thema's
Het is mogelijk om aangepaste OOUI-thema's te maken. Merk op dat dit veel initieel werk en veel voortdurende inspanning vereist om uw thema up-to-date te houden met OOUI-wijzigingen.

OOUI-thema's moeten nu in dezelfde repository leven als de hoofdbroncode van OOUI (T76632), vanwege beperkingen in het bouwproces.

Een nieuw OOUI-thema maken:


 * 1) Fork de OOUI-repository, bijvoorbeeld van https://github.com/wikimedia/oojs-ui.
 * 2) Navigeer naar de map   en voer   uit
 * 3) Make sure you can build the library with   and view the demo. To initialise the demo, run   and open   in your browser.
 * 4) Run , substituting your theme's name for  . Rather than use the   theme, you can also start with   or.
 * 5) * This will create a copy of the template theme under a new name, and tweak the build process and demos to include your new theme. Run  afterwards to make the build process pick up the new theme.
 * 6) * Your theme's styles are now in src/themes/foobar/.
 * 7) * The theme names are case-sensitive; if you type the template theme's name in lowercase, you'll get confusing errors. You might want to name your theme with uppercase first letter too to avoid lint errors.
 * 8) Write the styles for your theme!
 * 9) * Run  (or  ) to build it, use the demo to test your changes.
 * 10) Regularly merge back the changes from the OOUI repository into your fork. We release OOUI every couple of weeks. You should probably do it at least for new MediaWiki versions (roughly every 6 months).
 * 11) * Although we don't usually make gratuitous changes that would require fixes to theme styles, they sometimes happen, and there probably won't be any warnings. Sorry. You can watch for changes in the Apex theme to spot things that are likely to affect your theme too (Apex is not in active development).
 * 12) * Even if there were no such breaking changes, you should still occasionally rebuild your version to include any changes to the base styles.



Thema's gebruiken
Every widget will use the theme defined by the current skin using  in extension.json. To use a built-in theme, this is all you need to do.

To use a custom theme in your MediaWiki skin:


 * 1) Run.
 * 2) Copy-paste the generated files from dist/ (you will need   and all , ignore the others) into a subdirectory in your skin. Also copy   from php/.
 * 3) If you have custom images, also copy-paste contents of dist/themes/foobar/ and the .json files from src/themes/foobar/.
 * 4) Define the theme using   in the skin.json file, and make your skin use the new theme with   as before.

Example change using a custom theme in a skin: https://gerrit.wikimedia.org/r/c/mediawiki/skins/Example/+/343240