Le modèle Palette 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 valeur non, les années ne seront pas affichées (défaut : oui) ;
décennies : si ce paramètre a la valeur non, les décennies ne seront pas affichées (défaut : oui) ;
siècles : si ce paramètre a la valeur non, les siècles ne seront pas affichés (défaut : oui) ;
millénaires : si ce paramètre a la valeur non, les millénaires ne seront pas affichés (défaut : oui) ;
mois : si ce paramètre a la valeur oui, 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ètre date ou le paramètre année, c'est le plus lisible ;
sinon, dans le premier argument, juste pour éviter de taper date = ;
sinon, dans le titre 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 est Habillement 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ètre année nn où nn est le numéro de l'année[8], par exemple avec le paramètre anné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 éventuel av. J.-C. ;
après décennie ajoute un texte[7] après le numéro de la décennie et un éventuel av. J.-C.
La plupart du temps, il suffira du paramètre avant 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ètre décennie nn où nn est le numéro de la décennie[8], par exemple avec le paramètre dé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 éventuel av. J.-C. ;
après siècle ajoute un texte[7] après le numéro du siècle et un éventuel av. J.-C.
La plupart du temps, il suffira du paramètre avant siècle. Dans la palette ci-dessus, nous avons spécifié le paramètre suite 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ètre siècle nn où nn est le numéro du siècle écrit en chiffres romains[8], par exemple avec le paramètre siè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 éventuel av. J.-C. ;
après millénaire ajoute un texte[7] après le numéro du millénaire et un éventuel av. J.-C.
La plupart du temps, il suffira du paramètre avant 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ètre millénaire nn où nn est le numéro du millénaire écrit en chiffres romains[8], par exemple avec le paramètre millénaire I = Ère commune.
Mois
Le modèle peut afficher une liste des mois de l'année, uniquement si :
le paramètre mois = 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ètre avant mois ou aprè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ètre mm 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'outil wstat 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 et bLe paramètre années accepte une valeur spéciale Qué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 pas test1 ni test-1. Par contre, il n'a aucun moyen de faire la différence entre test 3 et consuls de l'an 3. La seule solution dans ce cas est de mentionner le paramètre année explicitement.
↑ abc et dLe modèle n'est pas très pointilleux sur les espaces, les points et les tirets dans le paramètre date. Il reconnaîtra 54 av. J.-C. mais il reconnaîtra aussi 54 av. J-C ou encore 54 avant Jésus-Christ.
↑ a et bQuand la date est une décennie, le modèle affichera les années de la décennie sur deux lignes.
↑ a et bQuand la date est un siècle, le modèle n'affichera pas les années ni les décennies.
↑ a et bQuand la date est un millénaire, le modèle n'affichera pas les années, ni les décennies, ni les siècles.
↑ abcdefghijklm et nLes 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 et dDans 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., le nom du paramètre s'écrit avec un signe « - ». On écrira donc dans le wikicode :
