« Utilisateur:Jd/Skin bépo » : différence entre les versions

Version du 28 août 2009 à 15:36

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.

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 commentée bepo_DeleteTitles permet de spécifier certaines pages pour lesquelles le titre de niveau h1 ne doit pas apparaître. C'est notamment le cas de l'accueil et de la page principale d'installation.

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 le cas général, le trigger peut être n'importe de quel type, donc pas nécessairement un item de liste : il suffit qu'il ai 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.

@@ Ligne 21 : / Ligne 21 : @@
 === Ne pas afficher le titre d'une page ===
-La fonction commentée par ''delete some specific titles'' permet de déclarer certaines pages pour lesquelles le titre de niveau <code>h1</code> ne doit pas apparaître. C'est notamment le cas de l'accueil et de la page principale d'installation.
+La fonction commentée {{c|bepo_DeleteTitles}} permet de spécifier certaines pages pour lesquelles le titre de niveau <code>h1</code> ne doit pas apparaître. C'est notamment le cas de l'accueil et de la page principale d'installation.
 === ''Tooltips'' sur les liens du dock ===
-Le dock (barre supérieure) peut recevoir des liens pour lesquels sont affichés des ''tooltips'' (infobulles) avec la librairie [http://craigsworks.com/projects/qtip/ qTip]. La déclaration se fait dans <code>/skins/bepo.php</code>, en respectant une certaine structure munie d'identifiant et de classes génériques. Les ''tooltips'' étant des <code>div</code> standard, elles peuvent contenir tout type de contenu valide.
+Le dock (barre supérieure) peut recevoir des liens pour lesquels sont affichés des ''tooltips'' (infobulles) avec l'aide de la librairie [http://craigsworks.com/projects/qtip/ qTip]. La déclaration se fait dans {{c|/skins/bepo.php}}, en respectant une certaine structure munie d'identifiant et de classes génériques. Ces ''tooltips'' étant des {{c|div}} standard, elles peuvent contenir tout type de contenu valide.
-La structure type est la suivante :
+La structure type pour les tooltips du dock est la suivante :
 <source lang="html4strict">
@@ Ligne 38 : / Ligne 38 : @@
 </source>
-Le ''trigger'' peut en fait être n'importe de quel type, et pas forcément dans un item de liste : il suffit qu'il ai la classe <code>trigger</code> (on pourrait donc utiliser des icônes…). L'infobulle doit être déclarée ''à sa suite'' par un élément de classe <code>tooltipContent</code>. La portion de code jQuery associée à tout cela est à la section commentée par ''tooltips -- using the qTip library''.
+Dans le cas général, le ''trigger'' peut être n'importe de quel type, donc pas nécessairement un item de liste : il suffit qu'il ai la classe  {{c|trigger}} (on pourrait donc utiliser des icônes…). L'infobulle doit être déclarée ''à sa suite'' par un élément de classe {{c|tooltipContent}}. La portion de code jQuery associée à tout cela est à la fonction {{c|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.