Module:IllustrationsEnDésordre/Documentation

Ceci est la page de documentation de Spécial:Badtitle/Message [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son spécial d'origine et elle n'est pas destinée à être visualisée directement.

Utilisation

Fonctions exportables :

Construire() : à partir des données passées en paramètres et dans le code, construit une galerie verticale d'illustrations. L'ordre des illustrations change à chaque fois que la page est rafraîchie via purge.

Usage

Par défaut, le module

affiche en désordre des images
insère une espace verticale avant et après chaque image
centre chaque image
supprime les liens « automatiques » des images vers les fichiers sur Wikimedia Commons
colore le texte de chaque légende en blanc pour la rendre invisible à la lecture (la sélectionner la fait apparaître)
encadre chaque légende avec ⇒ et ⇐.

Paramètres à passer au module

On peut passer au module (et non PAS au modèle) ces paramètres qui modifient les comportements par défaut :

|zoom=<NombreEntier> (optionnel) : module du même facteur la taille de chaque image (un pourcentage ; ne pas mettre %)
|numeros=oui (optionnel) : numérote les images
|images_css=<code CSS> (optionnel) : applique des commandes CSS à la présentation de chaque image
|legende_css=<code CSS> (optionnel) : applique des commandes CSS à la présentation de chaque légende
|legende_left=<caractères> (optionnel) : caractère qui « encadre » chaque image à gauche
|legende_right=<caractères> (optionnel) : caractère qui « encadre » chaque image à droite

En plus des paramètres plus haut, on peut passer :

triplet <nom fichier1>|<taille1>|<légende1> (optionnel)
triplet <nom fichier2>|<taille2>|<légende2> (optionnel)
triplet <nom fichier3>|<taille3>|<légende3> (optionnel)
...

Les noms de fichiers sont écrits sans File:, sans Fichier: et sans Image:.

Les tailles doivent être exprimées en px (le moteur de Wikipédia ne reconnaît aucune autre mesure :-(.

Exemples

Ce code dans un modèle ou une page

{{#invoke:IllustrationsEnDésordre|Construire ¶

|Doni aux Maldives cropped.jpg|200px|bateau}} ¶

donne

⇒bateau⇐

Ce code dans un modèle ou une page

{{#invoke:IllustrationsEnDésordre|Construire ¶

|zoom=25 ¶

|legendes_css=color:green; ¶

|Doni aux Maldives cropped.jpg|200px|bateau}} ¶

|Dried spicy red peppers (4888546786).jpg|500px|piments ¶

|Dalmatien.jpg|500px|chien dalmatien ¶

}}

donne

⇒piments⇐

⇒chien dalmatien⇐

⇒bateau⇐

Mise en garde

L'ordre des images est calculé à partir de nombres produits par un PRNG, entité mathématique qui génère une suite de nombres pseudo-aléatoires. Pour calculer cet ordre, il faut amorcer le PRNG avec un nombre aléatoire, qui amorce en quelque sorte le puits des nombres pseudo-aléatoires. Dans le jargon informatique, on parle de seed (graine, amorce).

Au moment où la page est chargée par MediaWiki, un seed amorce le PRNG. Néanmoins, recharger la même page ne rafraîchit pas le seed. Changer d'onglet ne change pas le seed. Pour que l'ordre change, il faut charger dans un autre navigateur ou exiger un purge [1].