Ajuda:Modèl : Diferéncia entre lei versions

PourPer Wikipedia, un '''modèlemodèl''' estes un bloc d'information qui peut être inclus dansdins les autres pagespaginas. 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 pagespaginas d'un même domaine. Exemple : le tableau biographique utilisé pourper les présidents des États-Unis [[ModèleModèl:FichePresidentUS]]. Ce modèlemodèl estes paramétrable, c'estes à dire qu'il yi a un ''fond de tableau'' commun ete des ''variables'' dont le contenu change dansdins chaque article.

*insérer uneuna palette de navigation dansdins toutes les pagespaginas d'un même domaine. Exemple : la palette utilisée pourper les articles du domaine aéronautique [[ModèleModèl:Aéronautique]].

DansDins tous les cas le modèlemodèl estes inséré dansdins un article en y ajoutant, à l'emplacement adéquat, le libellé <nowiki>{{Nom du modèlemodèl}}</nowiki>

''Note'' : la notion de ''modèlemodèl'' de Wikipedia estes différente de celle utilisée dansdins les logiciels de traitement de texte.

Les modèlesmodèls sontson gérés dansdins un [[Ajuda:EspaceEspaci de noms|espaceespaci de noms]]. UneUna pagepagina spéciale en donne ainsi uneuna [http://fr.wikipedia.org/w/index.php?title=Special%3AAllpages3AAllpaginas&from=&namespace=10 liste alphabétique]. Voyez la liste des [[:modèlemodèl:modèlesmodèls principaux|modèlesmodèls principaux]] utilisés dansdins Oquipedià.

Les modèlesmodèls sontson des pagespaginas comme les autres ete donc accessibles à l'édition parper tous les contributeurs. Il faut toutefois les modifier avec prudence car le résultat apparaît sursus de nombreuses pagespaginas. Lorsque la pagepagina correspondant au modèlemodèl estes affichée, on peut cliquer sursus l'hyperlienhyperligam '''PagesPaginas liées''' du menu de gauche pourper consulter les pagespaginas utilisant le modèlemodèl ete vérifier, avant modification, que ces pagespaginas ne seront pas perturbées.

==Création d'un modèlemodèl==

La méthode estes identique à celle de la création d'uneuna pagepagina quelconque. Le plusmai simple estes d'insérer un appel au modèlemodèl dansdins un article, puis de cliquer sursul le lienligam (qui apparaîtra en rouge).

===Trucs ete astuces===

SiSe le modèlemodèl contient un [[ajuda:lienligam inter-langue|lienligam inter-langue]], alors ce lienligam estes inclus dansdins toutes les pagespaginas utilisant le modèlemodèl, ce qui n'estes généralement pas le résultat voulu. SiSe deux liensligams inter-langue vers uneuna même autre langue se trouvent dansdins uneuna pagepagina, le résultat estes imprévisible. On évitera ces conflits en utilisant [[#Les_balises_d.27inclusion_s.C3.A9lective|les balises d'inclusion sélective]].

Les noms de modèlesmodèls utilisant des mots abrégés ouo collés sontson difficiles à retenir car aucune convention ne s'estes imposée. Il n'y a pas de raison technique pourper ne pas s'inspirer des [[Oquipedià:conventions sur lessuls titres|conventions sur lessuls titres]] aussi pourper les noms de modèlemodèl.

SiSe le modèlemodèl appartient à uneuna catégorie, c'estes à dire que la pagepagina du modèlemodèl contient un libellé de la forme <nowiki>[[Catégorie:Nom d'uneuna catégorie]]</nowiki> tous les articles contenant le modèlemodèl appartiendront à cetteaquesta catégorie. On peut utiliser cetteaquesta astuce, parper exemple, pourper obtenir la liste de tous les articles ''ébauche'' d'un domaine donné.

DansDins notre exemple, rendez vous sursus la pagepagina [[:ModèleModèl:En cours]] pourper le modifier, autrement, remplacer le « En cours » parper le nom de la palette souhaitée.

PourPer inclure un modèlemodèl il faut utiliser la [[ajuda:syntaxe Oquipedià|syntaxe Oquipedià]] suivante (la première lettre du nom du modèlemodèl n'estes pas sensible à la casse) :

*<tt><nowiki>{{Nom du modèlemodèl}}</nowiki></tt> pourper que le modèlemodèl soit inclus à chaque chargement d'uneuna pagepagina l'utilisant. Ainsi, dès que le modèlemodèl estes modifié, la modification devient visible dansdins toutes les pagespaginas utilisant le modèlemodèl.

*<tt><nowiki>{{subst:Nom du modèlemodèl}}</nowiki></tt> pourper que le modèlemodèl soit copié uneuna fois pourper toute dansdins la pagepagina l'utilisant. DansDins ce cas-ci, uneuna modification du modèlemodèl n'a aucune incidence sursus la pagepagina.

Ainsi, un modèlemodèl bref ete temporaire destiné à être rapidement supprimé devrait être copié avec <tt>subst:</tt>, dont l'avantage estes qu'il apparaît directement dansdins la source de l'article. UneUna notice normale destinée à rester sursus uneuna pagepagina pourper uneuna longue durée ouo bien à jamais devrait être incluse au moyen de <tt><nowiki>{{Nom du modèlemodèl}}</nowiki></tt>, de manière à ce que les mises àa jourjorn éventuelles soient plusmai aisées. Un modèlemodèl contenant un lienligam temporaire ouo susceptible de changer ne devrait cependant pas être ajouté parper <tt><nowiki>{{Nom du modèlemodèl}}</nowiki></tt>. CetteAquesta méthode, en effet, ne met pas àa jourjorn le lienligam ''PagesPaginas liées'' à moinsmens que chaque article contenant le <tt><nowiki>{{Nom du modèlemodèl}}</nowiki></tt> soit effectivement modifié après la modification du lienligam dansdins le modèlemodèl en question.

* Il estEs possible d'inclure du texte provenant d'autres espaces de nom ; comme parper exemple <tt><nowiki>{{Oquipedià:Modifications récentes}}</nowiki></tt>.

* Tous les caractères sontson acceptés, y compris les espaces.

* Tout changement d'un modèlemodèl efface automatiquement le cache de toutes les pagespaginas utilisant ce modèlemodèl.

* Les modèlesmodèls peuvent prendre des arguments, référencés parper position ouo parper nom (voir l'exemple plusmai élaboré ci-dessous). La syntaxe estes la suivante: <tt><nowiki>{{chose|paramètre=valeur}}</nowiki></tt> avec des ''balises'' <tt><nowiki>{{{paramètre}}}</nowiki></tt> dansdins le modèlemodèl, ouo bien <tt><nowiki>{{brol|valeur1|valeur2}}</nowiki></tt> avec <tt><nowiki>{{{1}}}</nowiki></tt>, <tt><nowiki>{{{2}}}</nowiki></tt>, etc. Notez que les balises de paramètres dansdins le modèlemodèl demandent trois accolades ete non deux.

* Un modèlemodèl peut inclure un ouo plusieurs autres modèlesmodèls,

* Un modèlemodèl ne peut pas être lui-même paramètre d'un autre modèlemodèl.

* Les [[Ajuda:redirection|redirection]]s entre modèlesmodèls fonctionnent.

Je ne suis vraiment pas sûr de comprendre ce que ce paragraphe estes supposé vouloir dire

DansDins un modèlemodèl, pourper fairefar un lienligam vers uneuna pagepagina qui dépend d'un paramètre d'un modèlemodèl, les liensligams de type externe sontson souvent utilisés même pourper des liensligams internes afin d'éviter qu'on aboutisse sursus la pagepagina en mode d'édition même sise cetteaquesta pagepagina existe.

== ModèlesModèls à paramètres==

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

(pourper plusmai de détail voir [[Oquipedià:ModèlesModèls/Infobox|Infobox]]

ParPer exemple, le modèlemodèl [[ModèleModèl:Planète mineure]] se lit en partie :

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

SurSus la pagepagina [[(14) Irène|14 Irène]], on trouve, en partie :

Afin d'améliorer la lisibilité lors de l'édition, des retours à la ligne peuvent apparaître dansdins le modèlemodè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 sontson spécifiées en écrivant ''paramètre=valeur''. Il ne doit pas y avoir de retour à la ligne dansdins la valeur, maismas <nowiki><br /></nowiki> estes permis. La valeur peut inclure un lienligam extérieur (parper exemple, le paramètre ''dimensions'') ouo intérieur (parper exemple, ''orbite''). On remarquera que la syntaxe habituelle des liensligams wiki estes possible (c'estes-à-dire <nowiki>[[pagepagina visée|texte qui apparaîtra]]</nowiki>).

===Valeur parper défaut d'un paramètre ===

Les paramètres peuvent prendre uneuna valeur parper défaut, c'estes à dire uneuna valeur utilisée automatiquement en l'absence de spécification sursus la pagepagina d'inclusion, comme ceci <nowiki>{{{3|123}}}</nowiki> (s'il n'y a pas de 3e paramètre, 123 sera utilisé à la place), ouo comme cela <nowiki>{{{paramètre|123}}}.</nowiki>

Des exemples sontson donnés sursus la pagepagina [[Discussion ModèleModèl:Qif]].

== ModèlesModèls spéciaux==

Ces modèlesmodèls sontson prédéfinis ete ne doivent pas être utilisé comme nom de modèlesmodèls.

| le nom de l'[[Ajuda:EspaceEspaci de noms|espaceespaci de noms]] dansdins lequel se trouve la pagepagina

| <tt><nowiki>{{PAGENAMEPAGINANAME}}</nowiki></tt>

| le nom de la pagepagina sans le préfixe de l'espaceespaci de noms

| "{{PAGENAMEPAGINANAME}}"

| <tt><nowiki>{{PAGENAMEEPAGINANAMEE}}</nowiki></tt>

| le nom de la pagepagina sans le préfixe de l'espaceespaci de noms dansdins le format utilisé dansdins les URL

| "{{PAGENAMEEPAGINANAMEE}}"

| <tt><nowiki>{{FULLPAGENAMEFULLPAGINANAME}}</nowiki></tt>

| le nom de la pagepagina avec le préfixe de l'espaceespaci de noms

| "{{FULLPAGENAMEFULLPAGINANAME}}"

| <tt><nowiki>{{FULLPAGENAMEEFULLPAGINANAMEE}}</nowiki></tt>

| le nom de la pagepagina avec le préfixe de l'espaceespaci de noms dansdins le format utilisé dansdins les URL

| "{{FULLPAGENAMEEFULLPAGINANAMEE}}"

| <tt><nowiki>{{localurl:</nowiki><var>nom d'uneuna pagepagina</var><nowiki>}}</nowiki></tt>

| l'[[URL]] correspondant à uneuna pagepagina

| "{{localurl:nom d'uneuna pagepagina}}"

| <tt><nowiki>{{localurl:</nowiki><var>nom d'uneuna pagepagina</var><nowiki>|</nowiki><var>paramètres</var><nowiki>}}</nowiki></tt>

| idem maismas avec des paramètres

| "{{localurl:nom d'uneuna pagepagina|paramètres}}"

| le nom d'un espaceespaci de nom d'après son numéro

=== Exemples d'utilisation de modèlesmodèls spéciaux===

|<nowiki>{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAMEPAGINANAME}}|action=edit}}</nowiki>

|{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAMEPAGINANAME}}|action=edit}}

|<nowiki>{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAMEPAGINANAME}}}}</nowiki>

|{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAMEPAGINANAME}}}}

|<nowiki>{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAMEPAGINANAME}}_1}}</nowiki>

|{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAMEPAGINANAME}}_1}}

|<nowiki>''Voir : [[{{NAMESPACE}}:{{PAGENAMEPAGINANAME}}_1|{{NAMESPACE}} {{PAGENAMEPAGINANAME}} 1]].''</nowiki>

|''Voir : [[{{NAMESPACE}}:{{PAGENAMEPAGINANAME}}_1|{{NAMESPACE}} {{PAGENAMEPAGINANAME}} 1]].''

|<nowiki>[[{{NAMESPACE}}:{{PAGENAMEPAGINANAME}}_1]]</nowiki>

|[[{{NAMESPACE}}:{{PAGENAMEPAGINANAME}}_1]]

|<nowiki>[[{{FULLPAGENAMEFULLPAGINANAME}}_1]]</nowiki>

|[[{{FULLPAGENAMEFULLPAGINANAME}}_1]]

Il estEs parfois utile de placer certains éléments dansdins le codecòdi source du modèlemodèl (parper exemple les [[Ajuda:LienLigam inter-langue|liensligams interlangues]]) sans que ces éléments n'apparaissent sursus la pagepagina où le modèlemodèl estes inséré. PourPer ce fairefar, on place les éléments à exclure de l'insertion entre les balises <nowiki><noinclude> ete </noinclude></nowiki>.

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

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

Il estEs recommandé de laisser au moinsmens uneuna espaceespaci entre le dernier signe "=" d'un titre ete uneuna balise <nowiki><</nowiki>includeonly<nowiki>></nowiki>.

Il estEs également recommandé, lorsqu'on place uneuna séquence &lt;noinclude>...&lt;/noinclude>, soit de la fairefar précéder d'uneuna espaceespaci ouo, mieux encore, compte tenu des risques d'effacement accidentel de cetteaquesta espaceespaci, ete donc d'effets secondaires indésirables (interwikis d'un modèlemodèl reproduits de manière non pertinente dansdins les pagespaginas qui utilisent le modèlemodèl), sursus uneuna ligne séparée, précédée parper uneuna autre ligne contenant le commentaire invisible <font face="monospace">&lt;!-- ne pas effacer cetteaquesta ligne de commentaire --></font>.

===Balise d'inclusion sélective ete substitution===

Lors d'uneuna insertion parper substitution ( <nowiki>{{subst:modèlemodèl}}</nowiki> ) les balises <nowiki><noinclude> ete </noinclude></nowiki> ainsi que le texte qu'elles encadrent sontson reproduites, maismas elles ne sontson pas actionnées, donc le texte ainsi encadré estes inséré, contrairement à ce qu'on pourrait croire.

On ne pourra donc pas ajouterajustar de liensligams interlangues dansdins des modèlesmodèls généralement utilisés avec uneuna insertion parper substitution. Voir [[Ajuda:Lien_interLigam_inter-langue#Lien_interLigam_inter-langues_pour_les_modèles_langues_per_les_modèls_:_attention_!]].

== ModèlesModèls utilisateurutilisator ==

Afin de créercrear un modèlemodèl non encyclopédique (parper ex. destiné à être appelé parper uneuna pagepagina utilisateurutilisator) ouo pourper fairefar des tests, nul n'estes besoin de « polluer » l'espaceespaci des modèlesmodèls. Cela peut se fairefar sursus uneuna sous-pagepagina utilisateurutilisator.

ParPer exemple, sise <font style="text-decoration:underline;color:blue;">UtilisateurUtilisator:Quidam</font> veut tester un modèlemodèl appelé « Article fastidieux », il procède comme suit :

* il crée uneuna sous-pagepagina utilisateurutilisator <font style="text-decoration:underline;color:blue;">UtilisateurUtilisator:Quidam/Article&nbsp;fastidieux</font> dansdins laquelle il écrit le modèlemodèl :

''Ceci estes un article fastidieux. Le taux d'ennuide estfàstic es estimé à {{{ennuifàstic}}}%.''

* il l'utilise ensuite dansdins ses pagespaginas ete sous-pagespaginas personnelles en tapant :

<nowiki>{{UtilisateurUtilisator:Quidam/Article fastidieux|ennuifàstic=55}}</nowiki>

''Ceci estes un article fastidieux. Le taux d'ennuide estfàstic es estimé à 55%.''

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

<nowiki>{{</nowiki>''espaceespaci de nommage''<nowiki>:</nowiki>''nom d’article''<nowiki>|</nowiki>''paramètre1''<nowiki>=</nowiki>''valeur1''<nowiki>}}</nowiki>

reconnait la présence de l’<tt style="margin:1px 1px 1px 1px;background:white;color:black;border:1px dotted blue;padding:1px 1px 1px 1px;">''espaceespaci de nommage'':</tt>, qui ne prend la valeur parper défaut <tt style="margin:1px 1px 1px 1px;background:white;color:black;border:1px dotted blue;padding:1px 1px 1px 1px;">ModèleModèl:</tt> que quand l'espaceespaci de nommage n'estes pas indiqué explicitement. De même les paramètres peuvent être nommés explicitement, ouo implicitement parper leur rang d'apparition dansdins l'appel du modèlemodèl.

==Problèmes fréquents sursus leslas pagespaginas contenant des modèlesmodèls==

'''Rafraîchissement''' : PourPer rafraîchir uneuna pagepagina qui estes restée inchangée, alors que les modèlesmodèls qu'elle contient ontson étéestat modifiés, créercrear un lienligam du type :

<nowiki>[http://fr.wikipedia.org/w/index.php?title=nom de la pagepagina&action=purge rafraîchir la pagepagina]</nowiki> ete cliquer dessus, ouo utiliser {{m|purger le cache}}.

'''MiseMesa àa jourjorn des tables''' : Quand uneuna pagepagina contient uneuna autre pagepagina, ete que cetteaquesta dernière estes modifiée, la pagepagina principale estes misemesa àa jourjorn maismas pas la table des liensligams, ni les catégories. Même un ''&action=purge'' n'y change rien. Il yI a deux moyens pourper forcer la misemesa àa jourjorn des liensligams ete des catégories :

# SiSe c'estes un problème ponctuel, fairefar uneuna modification vide sursus la pagepagina (cliquer sursus modifier puis sursus sauvegarder sans rien changer : rien n'apparaît dansdins l'historique maismas la table des liensligams estes misemesa àa jourjorn)

# SiSe c'estes un problème récurrent, ouo sise de nombreuses pagespaginas sontson concernées : demander à un robot de passer régulièrement sursus la pagepagina concernée en utilisant le script {{CodeCòdi|touch.py}}. Déposez votre requêterequèsta sursus [[Oquipedià:Bot/RequêtesRequèstas]].

Les développeurs ontson étéestat mis au courant de tous ces problèmes sursus la pagepagina [http://bugzilla.wikipedia.org/show_bug.cgi?id=939 Bugzilla N°939].

*[[Oquipedià:Bac_a_sabla#E_si_volètz_testar_los_modèlsE_se_volètz_testar_los_modèls|Bac a sabla]] (per s'entrainar a l'utilisacion dels modèls)