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 modifier

Le 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 modifier

Paramètres des tables des thèmes de p modifier

Un 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",	
},
Chaque ligne d'une table doit finir par une virgule. C'est facultatif pour la dernière ligne, mais la mettre systématiquement évite les erreurs lors d'ajouts.
Ne pas utiliser de modèles, ils sont affichés comme du texte brut au lieu d'être transclus. Utiliser directement le code résultant de l'utilisation du modèle (peut être obtenu avec Spécial:ExpansionDesModèles).

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 modifier

Un 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 modifier

Les alias se présentent sous la forme :

p["alias"] = p["thème"]

Exemples modifier

Thèmes modifier

Au 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 modifier

Au 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 modifier

Pour 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 modifier

Lors 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é).