Module:IllustrationsEnDésordre/Documentation

Ceci est la page de documentation de Module:IllustrationsEnDésordre [modifier] [purger].

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

Utilisation[modifier le code]

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[modifier le code]

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[modifier le code]

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[modifier le code]

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[modifier le code]

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].