Ajuda:Modèl

Modèl:BesonhRevirada Per Wikipedia, un modèl es un bloc d'information qui peut être inclus dins les autres paginas. Il peut servir à:

• insérer un message standard, exemple : le message indiquant qu'un article es proposé à la suppression Modèl:Suppression
• insérer un tableau commun à plusieurs paginas d'un même domaine. Exemple : le tableau biographique utilisé per les présidents des États-Unis Modèl:FichePresidentUS. Ce modèl es paramétrable, es à dire qu'i a un fond de tableau commun e des variables dont le contenu change dins chaque article.
• insérer una palette de navigation dins toutes les paginas d'un même domaine. Exemple : la palette utilisée per les articles du domaine aéronautique Modèl:Aéronautique.
• etc.

Dins tous les cas le modèl es inséré dins un article en y ajoutant, à l'emplacement adéquat, le libellé {{Nom du modèl}}

Note : la notion de modèl de Wikipedia es différente de celle utilisée dins les logiciels de traitement de texte.

Les modèls son gérés dins un espaci de noms. Una pagina spéciale en donne ainsi una liste alphabétique. Voyez la liste des modèls principaux utilisés dins Oquipedià.

Les modèls son des paginas comme les autres e donc accessibles à l'édition per tous les contributeurs. Il faut toutefois les modifier avec prudence car le résultat apparaît sus de nombreuses paginas. Lorsque la pagina correspondant au modèl es affichée, on peut cliquer sus l'hyperligam Paginas liées du menu de gauche per consulter les paginas utilisant le modèl e vérifier, avant modification, que ces paginas ne seront pas perturbées.

Création d'un modèl

La méthode es identique à celle de la création d'una pagina quelconque. Le mai simple es d'insérer un appel au modèl dins un article, puis de cliquer sul ligam (qui apparaîtra en rouge).

Trucs e astuces

Se le modèl contient un ligam inter-langue, alors ce ligam es inclus dins toutes les paginas utilisant le modèl, ce qui n'es généralement pas le résultat voulu. Se deux ligams inter-langue vers una même autre langue se trouvent dins una pagina, le résultat es imprévisible. On évitera ces conflits en utilisant les balises d'inclusion sélective.

Les noms de modèls utilisant des mots abrégés o collés son difficiles à retenir car aucune convention ne s'es imposée. Il n'y a pas de raison technique per ne pas s'inspirer des conventions suls titres aussi per les noms de modèl.

Se le modèl appartient à una catégorie, es à dire que la pagina du modèl contient un libellé de la forme [[Catégorie:Nom d'una catégorie]] tous les articles contenant le modèl appartiendront à aquesta catégorie. On peut utiliser aquesta astuce, per exemple, per obtenir la liste de tous les articles ébauche d'un domaine donné.

Modification

Dins notre exemple, rendez vous sus la pagina Modèl:En cours per le modifier, autrement, remplacer le « En cours » per le nom de la palette souhaitée.

Utilisation

Per inclure un modèl il faut utiliser la syntaxe Oquipedià suivante (la première lettre du nom du modèl es pas sensible à la casse) :

• {{Nom du modèl}} per que le modèl soit inclus à chaque chargement d'una pagina l'utilisant. Ainsi, dès que le modèl es modifié, la modification devient visible dins toutes les paginas utilisant le modèl.
• {{subst:Nom du modèl}} per que le modèl soit copié una fois per toute dins la pagina l'utilisant. Dins ce cas-ci, una modification du modèl n'a aucune incidence sus la pagina.

Ainsi, un modèl bref e temporaire destiné à être rapidement supprimé devrait être copié avec subst:, dont l'avantage es qu'il apparaît directement dins la source de l'article. Una notice normale destinée à rester sus una pagina per una longue durée o bien à jamais devrait être incluse au moyen de {{Nom du modèl}}, de manière à ce que les mises a jorn éventuelles soient mai aisées. Un modèl contenant un ligam temporaire o susceptible de changer ne devrait cependant pas être ajouté per {{Nom du modèl}}. Aquesta méthode, en effet, ne met pas a jorn le ligam Paginas liées à mens que chaque article contenant le {{Nom du modèl}} soit effectivement modifié après la modification du ligam dins le modèl en question.

• Es possible d'inclure du texte provenant d'autres espaces de nom ; comme per exemple {{Oquipedià:Modifications récentes}}.
• Tous les caractères son acceptés, y compris les espaces.
• Tout changement d'un modèl efface automatiquement le cache de toutes les paginas utilisant ce modèl.
• Les modèls peuvent prendre des arguments, référencés per position o per nom (voir l'exemple mai élaboré ci-dessous). La syntaxe es la suivante: {{chose|paramètre=valeur}} avec des balises {{{paramètre}}} dins le modèl, o bien {{brol|valeur1|valeur2}} avec {{{1}}}, {{{2}}}, etc. Notez que les balises de paramètres dins le modèl demandent trois accolades e non deux.
• Un modèl peut inclure un o plusieurs autres modèls,
• Un modèl ne peut pas être lui-même paramètre d'un autre modèl.
• Les redirections entre modèls fonctionnent.

Dins un modèl, per far un ligam vers una pagina qui dépend d'un paramètre d'un modèl, les ligams de type externe son souvent utilisés même per des ligams internes afin d'éviter qu'on aboutisse sus la pagina en mode d'édition même se aquesta pagina existe.

Modèls à paramètres

Un modèl peut être écrit afin d'accepter des paramètres. Cela permet de crear, per exemple, des tableaux pré-formatés dont seules certaines valeurs changent selon la pagina invoquant le modèl.

(per mai de détail voir Infobox

Per exemple, le modèl Modèl:Planète mineure se lit en partie :

{| align="right" rules="all" cellpadding="4" cellspacing="0" style="margin: 0 0 1em 1em; border: 1px solid #999; border-right-width: 2px; border-bottom-width: 2px; background-color: #CEDAF2"

...

| style="background: #003399" align="center" width="100%" |<font color=white size=4>'''{{{nom}}}'''

| padding=15px|

|}

|-

! bgcolor="#6295DA" colspan="2" align="center" | Découverte

|-

| Qui || {{{découvreur}}}

|-

| Quand || {{{date_découverte}}}

|-

| [[Désignation des astéroïdes|Désignation(s) provisoire(s)]] || {{{désignations}}}

|-

...

| [[Température]] de surface || {{{température}}}

|}

Le contenu de ce modèl es un tableau formaté, spécifiant couleurs, alignement, etc. Les parties apparaissant entre triple accolades son les paramètres qui seront utilisés per la pagina invoquant le modèl. On voit ci-dessus (en gras) les paramètres nom, découvreur, date_découverte, désignations e température.

Sus la pagina 14 Irène, on trouve, en partie :

{{Planète mineure | nom=14 Irène (14 Irene)

| découvreur=[[John Russell Hind]]

| date_découverte=[[19 mai]] [[1851]]

| désignations=A906 QC; A913 EA;<br />1952 TM

| catégorisation=[[ceinture d'astéroïdes]]

| orbite=386,730 [[gigamètre|Gm]] (2,585 [[unité astronomique|ua]])

...

| dimensions=181,8 km ^{[http://spiff.rit.edu/richmond/parallax/phot/LCSUMPUB.TXT 1]}

...

| température=~234 [[kelvin|K]]}}

Afin d'améliorer la lisibilité lors de l'édition, des retours à la ligne peuvent apparaître dins le modèl, à la façon des tableaux. Idéalement, comme on le constate ci-haut, il peut y avoir un retour à la ligne avant chaque "|" sauf le premier. Les valeurs des paramètres son spécifiées en écrivant paramètre=valeur. Il ne doit pas y avoir de retour à la ligne dins la valeur, mas <br /> es permis. La valeur peut inclure un ligam extérieur (per exemple, le paramètre dimensions) o intérieur (per exemple, orbite). On remarquera que la syntaxe habituelle des ligams wiki es possible (es-à-dire [[pagina visée|texte qui apparaîtra]]).

Valeur per défaut d'un paramètre

Les paramètres peuvent prendre una valeur per défaut, es à dire una valeur utilisée automatiquement en l'absence de spécification sus la pagina d'inclusion, comme ceci {{{3|123}}} (s'il n'y a pas de 3e paramètre, 123 sera utilisé à la place), o comme cela {{{paramètre|123}}}.

Des exemples son donnés sus la pagina Discussion Modèl:Qif.

Modèls spéciaux

Ces modèls son prédéfinis e ne doivent pas être utilisé comme nom de modèls.

{{NAMESPACE}}	le nom de l'espaci de noms dins lequel se trouve la pagina	"Ajuda"
{{PAGINANAME}}	le nom de la pagina sans le préfixe de l'espaci de noms	"Modèl:PAGINANAME"
{{PAGINANAMEE}}	le nom de la pagina sans le préfixe de l'espaci de noms dins le format utilisé dins les URL	"Modèl:PAGINANAMEE"
{{FULLPAGINANAME}}	le nom de la pagina avec le préfixe de l'espaci de noms	"Modèl:FULLPAGINANAME"
{{FULLPAGINANAMEE}}	le nom de la pagina avec le préfixe de l'espaci de noms dins le format utilisé dins les URL	"Modèl:FULLPAGINANAMEE"
{{SITENAME}}	le nom du site	"Wikipèdia"
{{SERVER}}	l'URL du site	"//oc.wikipedia.org"
{{localurl:nom d'una pagina}}	l'URL correspondant à una pagina	"/wiki/Nom_d%27una_pagina"
{{localurl:nom d'una pagina|paramètres}}	idem mas avec des paramètres	"/w/index.php?title=Nom_d%27una_pagina&paramètres"
{{CURRENTMONTH}}	le mois	"05"
{{CURRENTMONTHNAME}}	le nom du mois	"mai"
{{CURRENTMONTHNAMEGEN}}	le mois	"de mai"
{{CURRENTDAY}}	le jour du mois	"11"
{{CURRENTDAYNAME}}	le jour de la semaine	"dissabte"
{{CURRENTYEAR}}	l'année	"2024"
{{CURRENTTIME}}	l'heure courante	"02.53"
{{NUMBEROFARTICLES}}	le nombre d'articles	"89 702"
{{ns:7}}	le nom d'un espaci de nom d'après son numéro	"Discussion Fichièr"

Exemples d'utilisation de modèls spéciaux

{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGINANAME}}|action=edit}}	//oc.wikipedia.org{{localurl:Ajuda:Modèl:PAGINANAME|action=edit}}
{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGINANAME}}}}	//oc.wikipedia.org/w/index.php?title=Especial:Whatlinkshere&target=Ajuda:Modèl:PAGINANAME
{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGINANAME}}_1}}	//oc.wikipedia.org{{localurl:Ajuda:Modèl:PAGINANAME_1}}
''Voir : [[{{NAMESPACE}}:{{PAGINANAME}}_1|{{NAMESPACE}} {{PAGINANAME}} 1]].''	Voir : [[Ajuda:Modèl:PAGINANAME_1|Ajuda Modèl:PAGINANAME 1]].
[[{{NAMESPACE}}:{{PAGINANAME}}_1]]	[[Ajuda:Modèl:PAGINANAME_1]]
[[{{FULLPAGINANAME}}_1]]	[[Modèl:FULLPAGINANAME_1]]

Les balises d'inclusion sélective

Es parfois utile de placer certains éléments dins le còdi source du modèl (per exemple les ligams interlangues) sans que ces éléments n'apparaissent sus la pagina où le modèl es inséré. Per ce far, on place les éléments à exclure de l'insertion entre les balises <noinclude> e </noinclude>.

Inversement, les éléments qu'on veut voir apparaître en insertion, mas qu'on veut voir disparaître lors de la visualisation du modèl seul son placés entre les balises <includeonly> e </includeonly>.

Placer un titre en balisage "includeonly" peut désorganiser la numérotation du sommaire e des ligams "modifier" qui apparaissent à droite des titres.

Es recommandé de laisser au mens una espaci entre le dernier signe "=" d'un titre e una balise <includeonly>.

Es également recommandé, lorsqu'on place una séquence <noinclude>...</noinclude>, soit de la far précéder d'una espaci o, mieux encore, compte tenu des risques d'effacement accidentel de aquesta espaci, e donc d'effets secondaires indésirables (interwikis d'un modèl reproduits de manière non pertinente dins les paginas qui utilisent le modèl), sus una ligne séparée, précédée per una autre ligne contenant le commentaire invisible <!-- ne pas effacer aquesta ligne de commentaire -->.

Balise d'inclusion sélective e substitution

Lors d'una insertion per substitution ( {{subst:modèl}} ) les balises <noinclude> e </noinclude> ainsi que le texte qu'elles encadrent son reproduites, mas elles ne son pas actionnées, donc le texte ainsi encadré es inséré, contrairement à ce qu'on pourrait croire.

On ne pourra donc pas ajustar de ligams interlangues dins des modèls généralement utilisés avec una insertion per substitution. Voir Ajuda:Ligam_inter-langue#Ligam_inter-langues_per_les_modèls_:_attention_!.

Modèls utilisator

Afin de crear un modèl non encyclopédique (per ex. destiné à être appelé per una pagina utilisator) o per far des tests, nul n'es besoin de « polluer » l'espaci des modèls. Cela peut se far sus una sous-pagina utilisator.

Per exemple, se Utilisator:Quidam veut tester un modèl appelé « Article fastidieux », il procède comme suit :

• il crée una sous-pagina utilisator Utilisator:Quidam/Article fastidieux dins laquelle il écrit le modèl :

<div style="border:1px solid black;background:rgb(80%,100%,80%);text-align:center;padding=0.4ex;">
''Ceci es un article fastidieux. Le taux de fàstic es estimé à {{{fàstic}}}%.''
</div>

• il l'utilise ensuite dins ses paginas e sous-paginas personnelles en tapant :

{{Utilisator:Quidam/Article fastidieux|fàstic=55}}

ce qui donne :

Ceci es un article fastidieux. Le taux de fàstic es estimé à 55%.

D’una façon générale, la syntaxe (entre doubles accolades) d’appel d'un modèl :

{{espaci de nommage:nom d’article|paramètre1=valeur1}}

reconnait la présence de l’espaci de nommage:, qui ne prend la valeur per défaut Modèl: que quand l'espaci de nommage es pas indiqué explicitement. De même les paramètres peuvent être nommés explicitement, o implicitement per leur rang d'apparition dins l'appel du modèl.

Problèmes fréquents sus las paginas contenant des modèls

Rafraîchissement : Per rafraîchir una pagina qui es restée inchangée, alors que les modèls qu'elle contient son estat modifiés, crear un ligam du type :

[http://fr.wikipedia.org/w/index.php?title=nom de la pagina&action=purge rafraîchir la pagina] e cliquer dessus, o utiliser {{purger le cache}}.

Mesa a jorn des tables : Quand una pagina contient una autre pagina, e que aquesta dernière es modifiée, la pagina principale es mesa a jorn mas pas la table des ligams, ni les catégories. Même un &action=purge n'y change rien. I a deux moyens per forcer la mesa a jorn des ligams e des catégories :

1. Se es un problème ponctuel, far una modification vide sus la pagina (cliquer sus modifier puis sus sauvegarder sans rien changer : rien n'apparaît dins l'historique mas la table des ligams es mesa a jorn)
2. Se es un problème récurrent, o se de nombreuses paginas son concernées : demander à un robot de passer régulièrement sus la pagina concernée en utilisant le script touch.py. Déposez votre requèsta sus Oquipedià:Bot/Requèstas.

Les développeurs son estat mis au courant de tous ces problèmes sus la pagina Bugzilla N°939.

Voir aussi

• Palètas de navigacion
• Oquipedià:Modèls
• Oquipedià:Lista dels modèls
• Bac a sabla (per s'entrainar a l'utilisacion dels modèls)