Module:Bandeau/Ébauche/Documentation
Ce module sert à définir les données des paramètres du modèle {{ébauche}}, et remplace l'ensemble des modèles « Ébauche/paramètres xxx ».
Il est destiné à être chargé via mw.loadData et n'exporte aucune fonction, uniquement une table de données.
→ Tableau récapitulatif des types d'ébauches existants (obsolète car page blanchie par les Sysops, voir la dernière version.)
Structure du module
modifierLe module est composé d'une table p avec les différents thèmes, et d'une table a contenant les adjectifs de nationalité pouvant compléter certaines entrées (qui seront intégrées dans p de façon légèrement différente).
Plus précisément, il y a dans l'ordre :
- une table pour chaque thème principal de p
- une table pour chaque adjectif principal de a
- une petite section de code pour compléter automatiquement tous les paramètres qui peuvent être facilement déduits des données existantes
- une liste d'alias de p
- une liste d'alias des adjectifs (qui sont alors déjà intégrés dans p)
Paramètres
modifierParamètres des tables des thèmes de p
modifierUn thème de la table p se présente sous la forme :
["thème"] = {
sujet = "un [[thème]]",
icone = "Circle-icons-pencil.svg",
categ = "thème",
},
Liste des paramètres possibles :
- feminin (attention, pas d'accent sur le e)
- Version féminine du thème si nécessaire, qui sera utilisé sur les pages concernant des femmes. Il est nécessaire de préciser ce féminin même si la forme est identique au masculin, pour que le sujet et l'adjectif soient accordés.
- sujet
- Texte affiché dans le bandeau.
- sujetF
- Texte affiché dans le bandeau pour les femmes. Par défaut c'est le sujet avec "un" remplacé par "une" et le nom du thème remplacé par le contenu du paramètre feminin.
- icone
- Nom du fichier illustrant le bandeau (attention, pas d'accent sur le o).
- categ
- Fin du nom de la catégorie:Wikipédia ébauche xxx, par défaut le nom du thème.
- categ2
- Deuxième catégorie:Wikipédia ébauche yyy éventuelle.
- estFeminin
- Valeur « true » (sans guillemets) pour que les adjectifs de nationalité accolés à cette entrée soient accordés au féminin.
- selon
- Texte affiché à la fin de la deuxième ligne du bandeau, par défaut « selon les recommandations des projets correspondants ».
- type
- Premiers mots du bandeau, par défaut « Cet article ». Ne doit être précisé que pour les thèmes utilisés en premier paramètre du modèle ébauche (comme portail, modèle...).
- message
- Début de la deuxième ligne du bandeau, par défaut « Vous pouvez partager vos connaissances en l’améliorant (comment ?) ».
Ces différents paramètres peuvent prendre en compte les adjectifs de nationalité précisant le thème. Par défaut le sujet de l'adjectif sera ajouté au sujet du thème, et le nom de l'adjectif sera ajouté à la catégorie. Pour certains cas il peut être utile d'avoir une présentation différente ; il est donc possible de forcer une position différente avec les chaines suivantes :
<adjectif>
sera remplacé par le sujet de l'adjectif (exemple : [[France|français]]) ;<adj>
sera remplacé par l'adjectif au masculin (exemple : français) ;<adjF>
sera remplacé par l'adjectif au féminin (exemple : française) ;
S'il n'y a pas d'adjectif, ces chaines seront simplement supprimées, avec l'espace les précédant.
Paramètres des tables d'adjectifs
modifierUn adjectif de la table a se présente sous la forme :
["adjectif"] = {
sujet = "[[Pays|adjectif]]",
icone = "Nuvola United Nations flag.svg",
},
Liste des paramètres possible :
- feminin
- Version féminine de l'adjectif ; par défaut « ne » est ajouté à l'adjectif s'il se termine par « en » (italienne), et un « e » est ajouté si l'adjectif ne fini pas déjà par un « e » (française, belge) ;
- sujet
- texte affiché dans le bandeau ;
- sujetF
- texte affiché dans le bandeau pour la version féminine, par défaut c'est le sujet dans lequel l'adjectif est remplacé par feminin ;
- categ
- catégorie:Wikipédia ébauche xxx additionnelle (exemple : Colombie/Liste complète). Les catégories des thèmes précédents seront déjà modifiées avec ajout de l'adjectif si ces dernières existent.
Alias
modifierLes alias se présentent sous la forme :
p["alias"] = p["thème"]
Exemples
modifierThèmes
modifierAu plus simple
modifier["tennis"] = {
sujet = "le [[tennis|tennis]]",
icone = "Tennis ball.svg",
},
Avec féminin
modifier["avocat"] = {
feminin = "avocate",
sujet = "un [[Avocat (métier)|avocat]]",
icone = "Advokat, Fransk advokatdräkt, Nordisk familjebok.png",
},
Avec sujet féminin
modifier["compositeur de musique de film"] = {
feminin = "compositrice de musique de film",
sujet = "un [[compositeur]] de [[musique de film]]",
sujetF = "une [[compositrice]] de [[musique de film]]",
icone = "P treble clef.svg",
},
Le sujet féminin est nécessaire car le thème n'est pas exactement identique dans le sujet à cause des liens.
Avec catégorie
modifier["Valais"] = {
sujet = "le [[Canton du Valais|canton suisse du Valais]]",
icone = "Valais-coat of arms.svg",
categ = "Canton du Valais",
},
La catégorie est nécessaire car elle n'est pas identique au thème.
Avec categ2
modifier["ville de Colombie"] = {
sujet = "une [[Municipalités de Colombie|municipalité]] de [[Colombie]]",
icone = "COL-city icon (2).png",
categ2 = "Colombie/Liste complète",
},
categ n'est pas présent car elle est définie automatiquement avec le nom (implicitement, categ = "ville de Colombie").
Avec estFeminin
modifier["chanson"] = {
sujet = "une [[chanson]]",
icone = "Vinyl record.svg",
categ = "chanson <adjF>",
estFeminin = true,
},
Avec selon
modifier["film musical"] = {
sujet = "un [[film musical]]",
icone = "Musicfilm2.png",
selon = "selon les [[Wikipédia:Conventions filmographiques/Présentation des films|conventions filmographiques]]",
},
Avec type
modifier["liste"] = {
icone = "List icon.svg",
type = "Cette [[:Catégorie:Wikipédia:ébauche liste|liste]]",
},
Avec message
modifier["modèle"] = {
icone = "Curly Brackets.svg",
categ = "Modèle:",
type = "Ce [[Aide:Modèle|modèle]]",
message = "Vous pouvez partager votre maîtrise de la syntaxe en le modifiant ou solliciter l’aide sur le [[Projet:Modèle|projet Modèle]].",
},
Avec <adjectif>
modifier["joueur de rugby à XV"] = {
sujet = "un joueur <adjectif> de [[Portail:Rugby à XV|rugby à XV]]",
icone = "Rugby union pictogram.svg",
categ = "joueur <adj> de rugby à XV",
},
L'adjectif est nécessaire pour qu'il soit au milieu du sujet et non à la fin.
Avec <adj>
modifier["parti politique"] = {
sujet = "un [[partis politiques <adj>s|parti politique <adj>]]",
icone = "A coloured voting box.svg",
},
Avec <adjF>
modifier["université"] = {
sujet = "une [[université <adjF>]]",
icone = "Graduation hat.svg",
categ = "université <adjF>",
estFeminin = true,
},
Adjectifs
modifierAu plus simple
modifier["islandais"] = {
sujet = "[[Islande|islandais]]",
icone = "Nuvola Icelandic flag.svg",
},
Avec féminin
modifier["burkinabé"] = {
feminin = "burkinabé",
sujet = "[[Burkina Faso|burkinabé]]",
icone = "Nuvola Burkina Faso flag.svg",
},
Avec sujet féminin
modifier["congolais (RC)"] = {
feminin = "congolaise (RC)",
sujet = "[[République du Congo|brazza-congolais]]",
sujetF = "[[République du Congo|brazza-congolaise]]",
icone = "Nuvola Republic of the Congo flag.svg",
},
Alias
modifierPour les thèmes :
p["Ecosse"] = p["Écosse"]
Pour les adjectifs, il faut préciser le masculin et le féminin :
p["hollandais"] = p["néerlandais"]
p["hollandaise"] = p["néerlandaise"]
Fonctionnement
modifierLors de l'exécution du module, les tables sont complétées avec les valeurs qui peuvent être déduites automatiquement. Une nouvelle table est créée pour chaque féminin si elle n'existe pas déjà. Ainsi la table
["avocat"] = {
feminin = "avocate",
sujet = "un [[Avocat (métier)|avocat]]",
icone = "Advokat, Fransk advokatdräkt, Nordisk familjebok.png",
},
devient
["avocat"] = {
nom = "avocat",
feminin = "avocate",
sujet = "un [[Avocat (métier)|avocat]]",
icone = "Advokat, Fransk advokatdräkt, Nordisk familjebok.png",
categ = "avocat",
},
["avocate"] = {
nom = "avocate",
feminin = "avocate",
sujet = "une [[Avocat (métier)|avocate]]",
icone = "Advokat, Fransk advokatdräkt, Nordisk familjebok.png",
categ = "avocat",
estFeminin = true,
},
L'intérêt du paramètre feminin plutôt que des tables séparées dès la saisie est d'éviter d'avoir à dupliquer trop d'information dans le module et de pouvoir mettre au féminin tous les thèmes présents sur les pages de femmes avant la création du module gérant le féminin.
Lorsque le féminin est identique au masculin, le nom de la table féminin commence par « ♀ » suivi du nom masculin, par exemple
["journaliste"] = {
feminin = "journaliste",
sujet = "un [[journaliste]]",
icone = "Circle-icons-microphone.svg",
},
devient
["journaliste"] = {
nom = "journaliste",
feminin = "♀journaliste",
sujet = "un [[journaliste]]",
icone = "Circle-icons-microphone.svg",
categ = "journaliste",
},
["♀journaliste"] = {
nom = "♀journaliste",
feminin = "♀journaliste",
sujet = "une [[journaliste]]",
icone = "Circle-icons-microphone.svg",
categ = "journaliste",
estFeminin = true,
},
Les adjectifs sont intégrés dans la table principale, avec un paramètre indiquant que ce sont des adjectifs. Ainsi
-- dans la table "a"
["français"] = {
sujet = "[[France|français]]",
icone = "Nuvola France flag.svg",
},
devient
-- dans la table "p"
["français"] = {
adjectif = true,
nom = "français",
feminin = "française",
sujet = "[[France|français]]",
icone = "Nuvola France flag.svg",
},
p["française"] = p["français"]
Note : pour le moment la gestion du féminin est légèrement différente, et les tables masculin / féminin des adjectifs sont identiques (il est possible qu'à l'avenir les tables deviennent différentes pour les adjectifs, ou identiques pour les autres, pour plus d’homogénéité).