Modèle:Date rapide/Documentation

Ceci est la page de documentation de Modèle:Date rapide [modifier] [purger].

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

Ce modèle est une alternative au modèle {{Date}}, qui est moins dispendieuse en ressources serveurs.

Son utilisation peut être envisagée lorsque l'article effectue plusieurs centaines d'inclusions du modèle de date, par exemple si l'article sert à lister les épisodes d'une longue série de feuilletons télévisés.

En contrepartie, ce modèle comporte certaines limitations :

• L'existence de la page n'est pas vérifiée pour les liens internes générés. Si la page n'existe pas, il y aura un lien rouge.

• Cela peut se produire sur la partie [[mois année|mois]] (telle que : décembre). Ce problème ne devrait pas être rencontré avec les dates à partir de 1995. En revanche, les dates avant 1995 risqueront d'avoir un lien rouge. Quant aux dates dans le futur, elles auront très probablement un lien rouge.
• Le problème peut également se produire sur la partie [[année qualification|année]] (telle que : 2199).

• Le 4^e paramètre (la qualification optionnelle : « au cinéma », « en musique », etc.) n'est appliqué que sur la partie « année » de la date.

Remarque : Depuis la création de ce modèle en 2010, les performances du modèle {{Date}} ont significativement été améliorées (via un codage en Lua et une base de données locale). L'utilisation de {{date rapide}} n'est justifiée qu'en cas de centaines, voire milliers d'inclusions. Dans la plupart des cas, préférez {{date}}, qui est plus court et offre davantage de possibilités.

{{Date rapide|quantième|mois|année|qualification}}

quantième

Le quantième (autrement dit, le jour du mois), en chiffres. Si le quantième est « 1 », vous pouvez au choix entrer « 1 » ou « 1er » : il s’affichera toujours « 1^er ».
Ce paramètre est facultatif : vous pouvez le laisser vide.

mois

Le nom du mois, en toutes lettres et en minuscules. Mettre une majuscule à la première lettre du mois uniquement en début de phrase lorsque le numéro d’ordre du jour n’est pas spécifié.

année

L’année, en chiffres.

qualification

Le domaine de l'éphéméride : « au cinéma », « en musique », etc.
Ce paramètre est facultatif : vous pouvez le laisser vide.

Le principe de ce modèle est de n'effectuer aucun appel à la fonction #ifexist de MediaWiki. Cette fonction sert à tester l'existence d'une page, mais elle affecte les performances lorsqu'elle est appelée des centaines de fois pour générer la page.

• Catégorie:Page avec trop d'appels dispendieux de fonctions parseurs