Utilisateur:Jd/Skin bépo

Le thème (skin, template, …) bepo est une skin pour le logiciel MediaWiki, en vue d'une utilisation sur bepo.fr spécifiquement. Elle a été créée à l'occasion de la sortie de la version 1.0 de la disposition clavier.

Basée à l'origine sur le thème Cavendish, dépassé techniquement, la skin finale a été synchronisée avec la dernière version de Monobook (skin officielle de MediaWiki). Elle fait un large usage de jQuery pour créer, entre autre, des effets d'animation et de transparence et adapter les dimensions du site selon le contenu et la résolution écran. À ma connaissance, l'ensemble fonctionne dans tous les navigateurs modernes et se « dégrade » correctement en l'absence de JavaScript.

Pour les hack3rs, les feuilles de styles (ne pas oublier MediaWiki:Bepo.css et MediaWiki:Common.css, qui sont dynamiques) sont à parcourir avec le fichier jquery-enhancements.js ouvert, ce dernier contenant les divers hooks jQuery créés par mes soins. Le fichier principal est /dvorak/bepo.fr-web/htdocs/wiki/skins/Bepo.php (ftp).

TODO

• d'autres bannières pour l'en-tête
• contrôle de tous les modèles, certains sont cassés
• ce qui est mentionné dans la section Avertissements

Avertissements

Un certain nombre de petits bugs subsistent en raison de particularités liées au thème actuel, Monobook. Ils ne pourront être résolus que lorsque le thème par défaut sera « Bepo ».

• Des polices anormalement petites par-ci par-là. Essentiellement lié à des modèles qui déclarent en durs des styles non modifiables par une CSS externe (pas de classe ou d'identifiant définis). À terme, il faudra externaliser ces styles via des classes et ids, et les gérer par MediaWiki:Monobook.css, MediaWiki:Common.css et les CSS du thème Bepo. Je l'ai fait pour quelques modèles (exemple, {{touche}}).

jquery-enhancements.js : utilisation et astuces

Ne pas afficher le titre d'une page

La fonction bepo_DeleteTitles() permet de masquer le titre de niveau h1 de certaines pages. C'est notamment le cas de l'accueil et de la page principale d'installation. Les pages concernées sont indiquées dans Pages sans titre, à raison d'un titre par ligne. Commentaires autorisés, mais pas de formatage !

Tooltips sur les liens du dock

Le dock (barre supérieure) peut recevoir des liens pour lesquels sont affichés des tooltips (infobulles) avec l'aide de la librairie qTip. La déclaration se fait dans /skins/bepo.php, en respectant une certaine structure munie d'identifiant et de classes génériques. Ces tooltips étant des div standard, elles peuvent contenir tout type de contenu valide.

La structure type pour les tooltips du dock est la suivante :

<li id="trigger-[nom du trigger]">
  <a href="#" class="trigger" title="xxx">Mon trigger</a>
  <div class="tooltipContent">
    ... contenu du tooltip
  </div>
</li>

Dans la pratique, on a par exemple :

<li id="trigger-forum">
  <a href="http://forum.bepo.fr" class="trigger" title="Forum">forum</a>
  <div class="tooltipContent">
    <h2>forum de discussion</h2>
    le lieu principal d'échange – notez qu'il existe également une <a href="Communauté">liste de diffusion</a> !
  </div>
</li>

Dans le cas général, le trigger peut être n'importe de quel type, donc pas nécessairement un lien dans un item de liste comme j'ai fait ici : il suffit qu'il porte la classe trigger (on pourrait donc utiliser des icônes…). L'infobulle doit être déclarée à sa suite par un élément de classe tooltipContent. La portion de code jQuery associée à tout cela est à la fonction bepo_DockTooltips().

Évidemment, la technique peut-être mise à profit ailleurs que dans le dock ; mais il faudra faire attention aux identifiants et sans doute écrire un nouveau hook jQuery — peut-être en rationalisant le style associé (cf. la doc officielle) pour éviter de retaper grosso modo deux fois la même chose.