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) Zorg ervoor dat u de bibliotheek kunt maken met   en bekijk de demo. Om de demo te initialiseren, voert u   uit en opent u   in uw browser.
 * 4) Voer   uit en vervang de naam van uw thema door  . In plaats van het thema   te gebruiken, kunt u ook beginnen met   of.
 * 5) * Hiermee wordt een kopie van het sjabloonthema onder een nieuwe naam gemaakt en worden het bouwproces en de demo's aangepast om uw nieuwe thema op te nemen. Voer daarna  uit om het bouwproces het nieuwe thema te laten oppikken.
 * 6) * De stijlen van uw thema staan nu in src/themes/foobar/.
 * 7) * De themanamen zijn hoofdlettergevoelig; Als u de naam van het sjabloonthema in kleine letters typt, krijgt u verwarrende fouten. Misschien wilt u uw thema ook een hoofdletter met hoofdletters geven om lint-fouten te voorkomen.
 * 8) Schrijf de stijlen voor uw thema!
 * 9) * Voer  (of  ) uit om het te bouwen, gebruik de demo om uw wijzigingen te testen.
 * 10) Voeg regelmatig de wijzigingen uit de OOUI-repository samen in uw fork. We brengen om de paar weken een versie van OOUI uit. U moet het waarschijnlijk op zijn minst doen voor nieuwe MediaWiki-versies (ongeveer elke 6 maanden).
 * 11) * Hoewel we meestal geen onnodige wijzigingen aanbrengen waarvoor oplossingen voor themastijlen nodig zijn, gebeuren ze soms en zijn er waarschijnlijk geen waarschuwingen. Sorry. U kunt kijken naar wijzigingen in het Apex-thema om dingen te herkennen die waarschijnlijk ook van invloed zijn op uw thema (Apex is niet in actieve ontwikkeling).
 * 12) * Zelfs als er geen dergelijke brekende wijzigingen waren, moet u uw versie nog steeds af en toe opnieuw opbouwen om eventuele wijzigingen in de basisstijlen op te nemen.



Thema's gebruiken
Elke widget gebruikt het thema dat is gedefinieerd door de huidige skin met behulp van   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