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.


 * le thème "WikimediaUI" – conformément au guide de style de conception de la Fondation Wikimedia. C'est le thème par défaut et qui se trouve en développement actif.
 * le 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.

Nous n'avons pas l'intention d'avoir plus de deux thèmes prédéfinis à cause de l'effort supplémentaire qui serait demandé pour les maintenir.



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) Vérifiez que vous pouvez construire la bibliothèque avec   et regardez la démonstration. Pour initialiser la démonstration, exécutez   et ouvrez   dans votre navigateur.
 * 4) Exécutez , en substituant le nom de votre thème par  . Plutôt que d'utiliser le thème  , vous pouvez aussi commencer avec   ou.
 * 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. Ensuite exécutez  pour que la construction prenne en compte le nouveau thème.
 * 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. Vous pouvez aussi nommer votre thème en commençant son nom par une lettre majuscule pour éviter les erreurs de lint.
 * 8) Ecrivez les styles pour votre thème !
 * 9) * Exécutez  (ou  ) pour le construire, utilisez la démonstration pour tester vos modifications.
 * 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. Vous devriez probablement le faire au moins pour les nouvelles versions de MediaWiki (en gros tous les six mois).
 * 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
Chaque widget va utiliser le thème défini par l'habillage actuel en utilisant  de 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) Si vous avez des images personnalisées, copiez et collez les contenus des fichiers dist/themes/foobar/ et .json de 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.

Exemple de modification utilisant un thème personnalisé dans un habillage : https://gerrit.wikimedia.org/r/c/mediawiki/skins/Example/+/343240