OOUI/Themes/fr

Les thèmes spécifient l'aspect et le comportement des interfaces OOUI. Les auteurs d'habillages peuvent créer des thèmes supplémentaires et les utiliser dans MediaWiki.

Les thèmes fournissent principalement le CSS, mais ils peuvent également apporter du code JavaScript (en pratique uniquement pour l'implémentation des variantes d'icônes) et des images d'icônes personnalisées (pas utilisé en pratique actuellement).



Thèmes prédéfinis
Deux thèmes vous sont proposés prêts à l'emploi.


 * “WikimediaUI” theme conforming to Wikimedia Foundation's design style guide. C'est le thème par défaut et qui se trouve en développement actif.
 * Thème Special:MyLanguage/Skin:Apex inspiré par l'habillage du même nom. Il ne reçoit que des mises à jour de maintenance uniquement.

We do not plan to have more than two built-in themes due to the additional effort that would be required to maintain them.



Thèmes personnalisés
Il est possible de créer des thèmes OOUI personnalisés Note that this requires a lot of initial work and a lot of continuing effort to keep your theme up-to-date with OOUI changes.

OOUI themes currently must live in the same repository as the main OOUI source code (T76632), due to limitations of the build process.

Pour créer un nouveau thème OOUI :


 * 1) Faites un fork du répertoire OOUI par exemple à partir de https://github.com/wikimedia/oojs-ui.
 * 2) Aller jusqu'au répertoire   et exécuter
 * 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) * Les styles de votre thème sont maintenant dans 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) Ecrivez les styles pour votre thème !
 * 9) * Run  (or  ) to build it, use the demo to test your changes.
 * 10) Penser à fusionner régulièrement dans votre fork, les modifications venant du dépôt OOUI. Nous fournissons une version de OOUI toutes les deux semaines. 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.



Utiliser les thèmes dans MediaWiki
Every widget will use the theme defined by the current skin using  in extension.json. Pour utiliser un thème prédéfini, c'est tout ce que vous avez à faire.

Pour utiliser un thème personnalisé dans votre habillage MediaWiki :


 * 1) Exécuter.
 * 2) Copy-paste the generated files from dist/ (you will need   and all , ignore the others) into a subdirectory in your skin. Copier aussi   de php/.
 * 3) If you have custom images, also copy-paste contents of dist/themes/foobar/ and the .json files from src/themes/foobar/.
 * 4) Définir le thème en utilisant   dans le fichier skin.json, et faites que votre habillage utilise le nouveau thème avec   comme auparavant.

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