Modifications

Aller à : navigation, rechercher

Module:Bandeau/Ébauche/doc

11 832 octets ajoutés, 24 août 2017 à 11:46
Page créée avec « Ce module sert à définir les données des paramètres du modèle {{m|ébauche}}, et remplace l'ensemble des modèles « Ébauche/paramètres xxx ». Il est destiné à... »
Ce module sert à définir les données des paramètres du modèle {{m|é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.

→ [[Discussion Module:Bandeau/Ébauche/Documentation|Tableau récapitulatif]] des type d'ébauche existants.

== Structure du module ==
Le module est composé d'une table '''p''' avec les différents thèmes, et une table '''a''' contenant les adjectifs de nationalité pouvant compléter certaines entrées (qui seront intégré dans p de façon légèrement différente).

Plus précisément il y 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 ==
=== Paramètres des tables des thèmes de p ===
Un thème de la table ''p'' se présente sous la forme :
<syntaxhighlight lang=lua>
p["thème"] = {
sujet = "un [[thème]]",
icone = "Circle-icons-pencil.svg",
categ = "thème",
}</syntaxhighlight>
{{attention|Chaque ligne de la 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}}
Liste des paramètres possibles :
; feminin <span style="font-weight:normal;">(attention, pas d'accent sur le e)</span>
: 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 [[projet:accueil|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 ('''[[Aide:Comment modifier une page|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 :
* <code><adjectif></code> sera remplacé par le sujet de l'adjectif (exemple : <nowiki>[[France|français]]</nowiki>) ;
* <code><adj></code> sera remplacé par l'adjectif au masculin (exemple : français) ;
* <code><adjF></code> 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 ===
Un adjectif de la table ''a'' se présente sous la forme :
<syntaxhighlight lang=lua>
a["adjectif"] = {
sujet = "[[Pays|adjectif]]",
icone = "Nuvola United Nations flag.svg",
}</syntaxhighlight>
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 » (italien'''ne'''), et un « e » est ajouté si l'adjectif ne fini pas déjà par un « e » (français'''e''', 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 ===
Les alias se présentent sous la forme :
<syntaxhighlight lang=lua>
p["alias"] = p["thème"]
</syntaxhighlight>

== Exemples ==
=== Thèmes ===
==== Au plus simple ====
<syntaxhighlight lang=lua>
p["tennis"] = {
sujet = "le [[tennis|tennis]]",
icone = "Tennis ball.svg",
}</syntaxhighlight>

==== Avec féminin ====
<syntaxhighlight lang=lua>
p["avocat"] = {
feminin = "avocate",
sujet = "un [[Avocat (métier)|avocat]]",
icone = "Advokat, Fransk advokatdräkt, Nordisk familjebok.png",
}</syntaxhighlight>

==== Avec sujet féminin ====
<syntaxhighlight lang=lua>
p["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",
}</syntaxhighlight>
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 ====
<syntaxhighlight lang=lua>
p["Valais"] = {
sujet = "le [[Canton du Valais|canton suisse du Valais]]",
icone = "Valais-coat of arms.svg",
categ = "Canton du Valais",
}</syntaxhighlight>
La catégorie est nécessaire car elle n'est pas identique au thème.

==== Avec categ2 ====
<syntaxhighlight lang=lua>
p["ville de Colombie"] = {
sujet = "une [[Municipalités de Colombie|municipalité]] de [[Colombie]]",
icone = "COL-city icon (2).png",
categ2 = "Colombie/Liste complète",
}</syntaxhighlight>
''categ'' n'est pas présent car elle est définie automatiquement avec le nom (implicitement, categ = "ville de Colombie")

==== Avec estFeminin ====
<syntaxhighlight lang=lua>
p["chanson"] = {
sujet = "une [[chanson]]",
icone = "Vinyl record.svg",
categ = "chanson <adjF>",
estFeminin = true,
}</syntaxhighlight>

==== Avec selon ====
<syntaxhighlight lang=lua>
p["film musical"] = {
sujet = "un [[film musical]]",
icone = "Musicfilm2.png",
selon = "selon les [[Wikipédia:Conventions filmographiques/Présentation des films|conventions filmographiques]]",
}</syntaxhighlight>

==== Avec type ====
<syntaxhighlight lang=lua>
p["liste"] = {
icone = "List icon.svg",
type = "Cette [[:Catégorie:Wikipédia:ébauche liste|liste]]",
}</syntaxhighlight>

==== Avec message ====
<syntaxhighlight lang=lua>
p["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 [[Projet:Modèle|projet Modèle]].",
}</syntaxhighlight>

==== Avec <adjectif> ====
<syntaxhighlight lang=lua>
p["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",
}</syntaxhighlight>
l'adjectif est nécessaire pour qu'il soit au milieu du sujet et non à la fin.

==== Avec <adj> ====
<syntaxhighlight lang=lua>
p["parti politique"] = {
sujet = "un [[partis politiques <adj>s|parti politique <adj>]]",
icone = "A coloured voting box.svg",
}</syntaxhighlight>

==== Avec <adjF> ====
<syntaxhighlight lang=lua>
p["université"] = {
sujet = "une [[université <adjF>]]",
icone = "Graduation hat.svg",
categ = "université <adjF>",
estFeminin = true,
}</syntaxhighlight>

=== Adjectifs ===
==== Au plus simple ====
<syntaxhighlight lang=lua>
a["islandais"] = {
sujet = "[[Islande|islandais]]",
icone = "Nuvola Icelandic flag.svg",
}</syntaxhighlight>

==== Avec féminin ====
<syntaxhighlight lang=lua>
a["burkinabé"] = {
feminin = "burkinabé",
sujet = "[[Burkina Faso|burkinabé]]",
icone = "Nuvola Burkina Faso flag.svg",
}</syntaxhighlight>

==== Avec sujet féminin ====
<syntaxhighlight lang=lua>
a["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",
}</syntaxhighlight>

=== Alias ===
Pour les thèmes :
<syntaxhighlight lang=lua>
p["Ecosse"] = p["Écosse"]
</syntaxhighlight>

Pour les adjectifs, il faut préciser le masculin et le féminin :
<syntaxhighlight lang=lua>
p["hollandais"] = p["néerlandais"]
p["hollandaise"] = p["néerlandaise"]
</syntaxhighlight>

== Fonctionnement ==
Lors de l'exécution du module, les tables sont complétées avec les valeurs qui peuvent être déduite automatiquement. Une nouvelle table est crée pour chaque féminin si elle n'existe pas déjà. Ainsi la table
<syntaxhighlight lang=lua>
p["avocat"] = {
feminin = "avocate",
sujet = "un [[Avocat (métier)|avocat]]",
icone = "Advokat, Fransk advokatdräkt, Nordisk familjebok.png",
}
</syntaxhighlight>
devient
<syntaxhighlight lang=lua>
p["avocat"] = {
nom = "avocat",
feminin = "avocate",
sujet = "un [[Avocat (métier)|avocat]]",
icone = "Advokat, Fransk advokatdräkt, Nordisk familjebok.png",
categ = "avocat",
}
p["avocate"] = {
nom = "avocate",
feminin = "avocate",
sujet = "une [[Avocat (métier)|avocate]]",
icone = "Advokat, Fransk advokatdräkt, Nordisk familjebok.png",
categ = "avocat",
estFeminin = true,
</syntaxhighlight>
L'intérêt du paramètre <var>feminin</var> plutôt que des tables séparées dès la saisie est d'éviter d'avoir trop de dupliquer trop d'information dans le module, et de pouvoir mettre au féminin tout 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 « ♀ » suivit du nom masculin, par exemple
<syntaxhighlight lang=lua>
p["journaliste"] = {
feminin = "journaliste",
sujet = "un [[journaliste]]",
icone = "Circle-icons-microphone.svg",
}
</syntaxhighlight>
devient
<syntaxhighlight lang=lua>
p["journaliste"] = {
nom = "journaliste",
feminin = "♀journaliste",
sujet = "un [[journaliste]]",
icone = "Circle-icons-microphone.svg",
categ = "journaliste",
}
p["♀journaliste"] = {
nom = "♀journaliste",
feminin = "♀journaliste",
sujet = "une [[journaliste]]",
icone = "Circle-icons-microphone.svg",
categ = "journaliste",
estFeminin = true,
}
</syntaxhighlight>

Les adjectifs sont intégrés dans la table principale, avec un paramètre indiquant que ce sont des adjectifs. Ainsi
<syntaxhighlight lang=lua>
a["français"] = {
sujet = "[[France|français]]",
icone = "Nuvola France flag.svg",
}
</syntaxhighlight>
devient
<syntaxhighlight lang=lua>
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"]
</syntaxhighlight>
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é).


<includeonly>
{{Projet Scribunto}}
</includeonly><noinclude>
[[Catégorie:Documentation de module]]
[[Catégorie:Ébauche]]
</noinclude>

Menu de navigation