Le modèlePalette Années permet de créer facilement une palette pour naviguer entre des dates : années, décennies, siècles et millénaires. Les liens générés sont complètement configurables, ce qui permet d'utiliser cette palette :
dans les articles généraux ;
dans les catégories ;
dans les cas où on veut présenter une seule ligne avec soit des années, des décennies, des siècles ou des millénaires ;
et même dans des pages personnelles.
Tous les paramètres sont optionnels. Le plus facile est de ne spécifier aucun paramètre comme ci-contre :
{{Palette Années}}
Ici nous n'avons pas spécifié de paramètres. Le modèle va chercher la date dans le titre de la page. S'il n'en trouve pas, il utilise l'année courante comme ici.
Paramètres
Paramètres généraux
Quelques paramètres permettent de modifier l'aspect général de la palette :
titre : modifie le titre de la palette (défaut:Chronologies) ;
années[1] : si ce paramètre a la valeurnon, les années ne seront pas affichées (défaut :oui) ;
décennies : si ce paramètre a la valeurnon, les décennies ne seront pas affichées (défaut :oui) ;
siècles : si ce paramètre a la valeurnon, les siècles ne seront pas affichés (défaut :oui) ;
millénaires : si ce paramètre a la valeurnon, les millénaires ne seront pas affichés (défaut :oui) ;
mois : si ce paramètre a la valeuroui, la chronologie mensuelle sera affichée dans la même section que les années, décennies, siècles et millénaires (défaut :non) ;
spécial : ce paramètre permet d'indiquer une chronologie spéciale pour certains domaines (défaut :vide). Valeurs permises :
préfixe : ajoute un préfixe donné à tous les liens. Ici, pour transformer notre palette en une palette pour naviguer entre les catégories, nous avons utilisé :
{{Palette Années | titre = Catégories | préfixe = :Catégorie: | géographiques = non | thématiques = non | calendriers = non}}
Date
Le modèle cherche la date :
dans le paramètredate ou le paramètreannée, c'est le plus lisible ;
sinon, dans lepremier argument, juste pour éviter de taperdate = ;
sinon, dans letitre de la page, pratique quand on fait un copier-coller d'une page à l'autre ;
sinon, il utilise l'année courante, probablement sans grand intérêt.
Le modèle reconnaît les formats de date suivants (même si la date ou le titre de la page estHabillement féminin au XVIIe siècle en Europe comme dans la palette ci-contre) :
Si vraiment cela ne suffit pas, il est possible de spécifier individuellement le lien pour une ou plusieurs années avec le paramètreannée nn oùnn est le numéro de l'année[8], par exemple avec le paramètreannée 1964 = Cent Mille Dollars au soleil. L'exemple ci-contre constitue un abus flagrant du procédé, où on a spécifié le lien pour chaque année.
Décennies
Le modèle affiche une liste des décennies, sauf dans les cas suivants :
Le lien pour les décennies peut être ajusté grâce aux paramètres suivants, tous optionnels :
titre décennies change le titre de la ligne ; un paramètre vide supprime le titre de la ligne ;
avant décennie ajoute un texte[7] avant le numéro de la décennie ;
suite décennie ajoute un texte[7] après le numéro de la décennie et avant un éventuelav. J.-C. ;
après décennie ajoute un texte[7] après le numéro de la décennie et un éventuelav. J.-C.
La plupart du temps, il suffira du paramètreavant décennie. Dans la palette ci-dessus, les décennies mènent vers les catégories correspondantes.
Si vraiment cela ne suffit pas, il est possible de spécifier individuellement le lien pour une ou plusieurs décennies avec le paramètredécennie nn oùnn est le numéro de la décennie[8], par exemple avec le paramètredécennie 1780 = Révolution française.
Siècles
Le modèle affiche une liste des siècles, sauf dans les cas suivants :
Le lien pour les siècles peut être ajusté grâce aux paramètres suivants, tous optionnels :
titre siècles change le titre de la ligne ; un paramètre vide supprime le titre de la ligne ;
avant siècle ajoute un texte[7] avant le numéro du siècle ;
suite siècle ajoute un texte[7] après le numéro du siècle et avant un éventuelav. J.-C. ;
après siècle ajoute un texte[7] après le numéro du siècle et un éventuelav. J.-C.
La plupart du temps, il suffira du paramètreavant siècle. Dans la palette ci-dessus, nous avons spécifié le paramètresuite siècle = e siècle bien que cela soit complètement inutile puisque le modèle le fait déjà.
Si vraiment cela ne suffit pas, il est possible de spécifier individuellement le lien pour un ou plusieurs siècles avec le paramètresiècle nn oùnn est le numéro du siècle écrit en chiffres romains[8], par exemple avec le paramètresiècle IV = Sac de Rome (390 av. J.-C.).
Millénaires
Le modèle affiche une liste des millénaires, sauf dans le cas suivant :
Le lien pour les millénaires peut être ajusté grâce aux paramètres suivants, tous optionnels :
titre millénaires change le titre de la ligne ; un paramètre vide supprime le titre de la ligne ;
avant millénaire ajoute un texte[7] avant le numéro du millénaire ;
suite millénaire ajoute un texte[7] après le numéro du millénaire et avant un éventuelav. J.-C. ;
après millénaire ajoute un texte[7] après le numéro du millénaire et un éventuelav. J.-C.
La plupart du temps, il suffira du paramètreavant millénaire. Dans la palette ci-dessus, nous avons juste supprimé le titre de la ligne, et nous avons laissé faire le modèle.
Si vraiment cela ne suffit pas, il est possible de spécifier individuellement le lien pour un ou plusieurs millénaires avec le paramètremillénaire nn oùnn est le numéro du millénaire écrit en chiffres romains[8], par exemple avec le paramètremillénaire I = Ère commune.
Mois
Le modèle peut afficher une liste des mois de l'année, uniquement si :
le paramètremois = oui a été spécifié ;
et la date représente une année supérieure ou égale à 1000.
La plupart du temps, il suffira du paramètreavant mois ouaprès mois.
Si vraiment cela ne suffit pas, il est possible de spécifier individuellement le lien pour un ou plusieurs mois avec le paramètremm aa, où mm est le nom d'un mois, p. ex. Janvier, et aa est le numéro d'une année.
TemplateData
Cette section a été ajoutée ici pour aider l'outilwstat de statistiques d'usage des paramètres des modèles (et accessoirement de détection des paramètres inconnus). La description des paramètres est un résumé, la description complète doit être lue dans la section#Paramètres
TemplateData : paramètres exhaustifs
Palette de navigation entre dates : années, décennies, siècles et millénaires.
↑a etbLe paramètreannées accepte une valeur spécialeQuébec. Avec cette valeur, les liens pour les années sont spécifiques au Québec.
↑Le modèle reconnaît une année s'il trouve un nombre dans un mot isolé. Il ne reconnaîtra donc pastest1 nitest-1. Par contre, il n'a aucun moyen de faire la différence entretest 3 etconsuls de l'an 3. La seule solution dans ce cas est de mentionner le paramètreannée explicitement.
↑abc etdLe modèle n'est pas très pointilleux sur les espaces, les points et les tirets dans le paramètre date. Il reconnaîtra54 av. J.-C. mais il reconnaîtra aussi54 av. J-C ou encore54 avant Jésus-Christ.
↑a etbQuand la date est une décennie, le modèle affichera les années de la décennie sur deux lignes.
↑a etbQuand la date est un siècle, le modèle n'affichera pas les années ni les décennies.
↑a etbQuand la date est un millénaire, le modèle n'affichera pas les années, ni les décennies, ni les siècles.
↑abcdefghijklm etnLes espaces au début et à la fin de la valeur sont supprimées par mediawiki. Pour y pallier, vous pouvez remplacer ces espaces par un souligné_comme ceci_ ou enclore la valeur entre apostrophes doubles" comme ceci ".
↑abc etdDans les cas rares où on veut spécifier individuellement un lien pour une année, une décennie, un siècle ou un millénaire av. J.-C., lenom du paramètre s'écrit avec un signe « - ». On écrira donc dans le wikicode :