Ajuda:Modèl : Diferéncia entre versions

revirada
(revirada)
{{BesonhRevirada}}
Per Wikipedia, un '''modèl''' es un bloc d'informationinformacion qui peutpòt êtreèstre inclus dins les autres paginas. Il peutpòt servir à:
*insérer un message standard, exempleexèmple : lelo message indiquant qu'un article es proposé à la suppression [[Modèl:Suppression]]
*insérer un tableautablèu commun à plusieurs paginas d'un même domaine. ExempleExèmple : lelo tableautablèu 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 tableautablèu'' commun e des ''variables'' dont lelo contenucontengut change dins chaque article.
*insérer una palettepaleta de navigationnavigacion dins toutestotas les paginas d'un même domaine. ExempleExèmple : la palettepaleta utilisée per les articles dudel domaine aéronautique [[Modèl:Aéronautique]].
*etc.
Dins toustotes les cas lelo modèl es inséré dins un article en y ajoutant, à l'emplacement adéquat, lelo libellé <nowiki>{{Nom dudel modèl}}</nowiki>
 
''Note'' : la notionnocion de ''modèl'' de Wikipedia es différente de celle utilisée dins les logiciels de traitement de textetèxt.
 
Les modèls son gérés dins un [[Ajuda:Espaci de noms|espaci de noms]]. Una pagina spéciale en donne ainsi una [http://fr.wikipedia.org/w/index.php?title=Special%3AAllpaginas&from=&namespacenamespaci=10 listelista alphabétique]. Voyez la listelista des [[:modèl:modèls principaux|modèls principaux]] utilisés dins Oquipedià.
 
Les modèls son des paginas commecoma les autres e donc accessibles à l'éditionédicion per toustotes les contributeurs. Il fautCal toutefois les modifier avecamb prudence car lelo résultat apparaît sus de nombreuses paginas. Lorsque la pagina correspondant aual modèl es affichée, on peutpòt cliquer sus l'hyperligam '''Paginas liées''' dudel menu de gauche per consulter les paginas utilisant lelo modèl e vérifier, avant modificationmodificacion, que ces paginas ne seront pas perturbéesperturbadas.
 
==CréationCreacion d'un modèl==
La méthode es identique à celle de la créationcreacion d'una pagina quelconque. LeLo mai simple es d'insérer un appel aual modèl dins un article, puis de cliquer sul ligam (qui apparaîtra en rouge).
 
===Trucs e astuces===
Se lelo modèl contient un [[ajuda:ligam inter-langue|ligam inter-langue]], alors ce ligam es inclus dins toutestotas les paginas utilisant lelo modèl, ce qui n'es généralement pas lelo résultat voulu. Se deux ligams inter-langue vers una même autre langue se trouvent dins una pagina, lelo résultat es 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èls utilisant des mots abrégés o collés son difficiles à retenir car aucune conventionconvencion ne s'es imposée. Il n'y a pas de raison technique per ne pas s'inspirer des [[Oquipedià:conventionsconvencions suls titrestítols|conventionsconvencions suls titrestítols]] aussitanben per les noms de modèl.
 
Se lelo modèl appartient à una catégorie, es à dire que la pagina dudel modèl contient un libellé de la forme <nowiki>[[Catégorie:Nom d'una catégorie]]</nowiki> toustotes les articles contenant lelo modèl appartiendront à aquesta catégorie. On peutpòt utiliser aquesta astuce, per exempleexèmple, per obtenir la listelista de toustotes les articles ''ébauche'' d'un domaine donné.
 
== ModificationModificacion ==
Dins notre exempleexèmple, rendez vous sus la pagina [[:Modèl:En cours]] per lelo modifier, autrement, remplacer lelo « En cours » per lepel nom de la palettepaleta souhaitée.
 
== UtilisationUtilisacion ==
Per inclure un modèl il fautcal utiliser la [[ajuda:syntaxe Oquipedià|syntaxe Oquipedià]] suivante (la première lettre dudel nom dudel modèl es pas sensible à la casse) :
*<tt><nowiki>{{Nom dudel modèl}}</nowiki></tt> per que lelo modèl soit inclus à chaque chargement d'una pagina l'utilisant. Ainsi, dès que lelo modèl es modifié, la modificationmodificacion devient visible dins toutestotas les paginas utilisant lelo modèl.
*<tt><nowiki>{{subst:Nom dudel modèl}}</nowiki></tt> per que lelo modèl soit copié una fois per toute dins la pagina l'utilisant. Dins ce cas-ci, una modificationmodificacion dudel modèl n'a aucune incidence sus la pagina.
 
Ainsi, un modèl bref e temporaire destiné à êtreèstre rapidement supprimé devrait êtreèstre copié avecamb <tt>subst:</tt>, 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èstre incluse aual moyen de <tt><nowiki>{{Nom dudel modèl}}</nowiki></tt>, 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èstre ajouté per <tt><nowiki>{{Nom dudel modèl}}</nowiki></tt>. Aquesta méthode, en effet, ne met pas a jorn lelo ligam ''Paginas liées'' à mens que chaque article contenant lelo <tt><nowiki>{{Nom dudel modèl}}</nowiki></tt> soit effectivement modifié après la modificationmodificacion dudel ligam dins lelo modèl en question.
 
* Es possible d'inclure dudel textetèxt provenant d'autres espacesespacis de nom ; commecoma per exempleexèmple <tt><nowiki>{{Oquipedià:ModificationsModificacions récentes}}</nowiki></tt>.
* TousTotes les caractères son acceptés, y compris les espacesespacis.
* ToutTot changement d'un modèl efface automatiquement lelo cache de toutestotas les paginas utilisant ce modèl.
* Les modèls peuvent prendre des arguments, référencés per positionposicion o per nom (voirveire l'exempleexèmple mai élaboré ci-dessous). La syntaxe es la suivante: <tt><nowiki>{{chose|paramètre=valeur}}</nowiki></tt> avecamb des ''balises'' <tt><nowiki>{{{paramètre}}}</nowiki></tt> dins lelo modèl, o bien <tt><nowiki>{{brol|valeur1|valeur2}}</nowiki></tt> avecamb <tt><nowiki>{{{1}}}</nowiki></tt>, <tt><nowiki>{{{2}}}</nowiki></tt>, etc. Notez que les balises de paramètres dins lelo modèl demandent trois accolades e non deux.
* Un modèl peutpòt inclure un o plusieurs autres modèls,
* Un modèl ne peutpòt pas êtreèstre lui-même paramètre d'un autre modèl.
* Les [[Ajuda:redirectionredireccion|redirectionredireccion]]s entre modèls fonctionnentfonccionnent.
 
<!---
Je ne suis vraiment pas sûr de comprendre ce que ce paragraphe es supposé vouloir dire
--->
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 typetipe externeextèrne son souvent utilisés même per des ligams internes afin d'éviter qu'on aboutisse sus la pagina en mode d'éditionédicion même se aquesta pagina existe.
 
== Modèls à paramètres==
 
Un modèl peutpòt êtreèstre écrit afin d'accepter des ''paramètres''. CelaAquò permet de crear, per exempleexèmple, des tableauxtablèus pré-formatés dont seules certaines valeurs changent selon la pagina invoquant lelo modèl.
 
(per mai de détail voirveire [[Oquipedià:Modèls/Infobox|Infobox]]
 
Per exempleexèmple, lelo modèl [[Modèl:Planète mineure]] se lit en partie :
 
:<tt><nowiki>{| 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"</nowiki></tt>
:<tt><nowiki>| Quand || {{{</nowiki>'''date_découverte'''<nowiki>}}}</nowiki></tt><br />
:<tt><nowiki>|-</nowiki></tt><br />
:<tt><nowiki>| [[DésignationDésignacion des astéroïdes|DésignationDésignacion(s) provisoire(s)]] || {{{</nowiki>'''désignationsdésignacions'''<nowiki>}}}</nowiki></tt><br />
:<tt><nowiki>|-</nowiki></tt><br />
 
:<tt><nowiki>|}</nowiki></tt>
 
LeLo contenucontengut de ce modèl es un tableautablèu formaté, spécifiant couleurs, alignementalinhament, etc. Les parties apparaissant entre triple accolades son les ''paramètres'' qui seront utilisés per la pagina invoquant lelo modèl. On voit ci-dessus (en gras) les paramètres '''nom''', '''découvreur''', '''date_découverte''', '''désignationsdésignacions''' e '''température'''.
 
Sus la pagina [[(14) Irène|14 Irène]], on trouve, en partie :
:<tt><nowiki>| </nowiki>'''découvreur'''<nowiki>=[[John Russell Hind]]</nowiki></tt><br />
:<tt><nowiki>| </nowiki>'''date_découverte'''<nowiki>=[[19 mai]] [[1851]]</nowiki></tt><br />
:<tt><nowiki>| </nowiki>'''désignationsdésignacions'''<nowiki>=A906 QC; A913 EA;<br />1952 TM</nowiki></tt><br />
:<tt><nowiki>| </nowiki>'''catégorisationcatégorisacion'''<nowiki>=[[ceinture d'astéroïdes]]</nowiki></tt><br />
:<tt><nowiki>| </nowiki>'''orbite'''<nowiki>=386,730 [[gigamètre|Gm]] (2,585 [[unité astronomique|ua]])</nowiki></tt>
 
:<tt><nowiki>| </nowiki>'''température'''<nowiki>=~234 [[kelvin|K]]}}</nowiki></tt>
 
Afin d'améliorer la lisibilité lors de l'éditionédicion, des retours à la lignelinha peuvent apparaître dins lelo modèl, à la façon des tableauxtablèus. Idéalement, commecoma on le constate ci-haut, il peutpòt y avoir un retour à la lignelinha avant chaque "|" sauf lelo premier. Les valeurs des paramètres son spécifiées en écrivant ''paramètre=valeur''. Il ne doit pas y avoir de retour à la lignelinha dins la valeur, mas <nowiki><br /></nowiki> es permis. La valeur peutpòt inclure un ligam extérieur (per exempleexèmple, lelo paramètre ''dimensions'') o intérieur (per exempleexèmple, ''orbite''). On remarquera que la syntaxe habituelle des ligams wiki es possible (es-à-dire <nowiki>[[pagina visée|textetèxt qui apparaîtra]]</nowiki>).
 
===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écificationspécificacion sus la pagina d'inclusion, commecoma ceciaquò <nowiki>{{{3|123}}}</nowiki> (s'il n'y a pas de 3e paramètre, 123 sera utilisé à la place), o commecoma celaaquò <nowiki>{{{paramètre|123}}}.</nowiki>
 
Des exemplesexèmples son donnés sus la pagina [[Discussion Modèl:Qif]].
 
== Modèls especials==
 
{|border
| <tt><nowiki>{{NAMESPACENAMESPACI}}</nowiki></tt>
| lo nom de l'[[Ajuda:Espaci de noms|espaci de noms]] dins loqual se troba la pagina
| "{{NAMESPACENAMESPACI}}"
|-
| <tt><nowiki>{{PAGENAME}}</nowiki></tt>
=== Exèmples d'utilisacion de modèls especials===
{|
|<nowiki>{{SERVER}}{{localurl:{{NAMESPACENAMESPACI}}:{{PAGENAME}}|actionaccion=edit}}</nowiki>
|{{SERVER}}{{localurl:{{NAMESPACENAMESPACI}}:{{PAGENAME}}|actionaccion=edit}}
|-
|<nowiki>{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACENAMESPACI}}:{{PAGENAME}}}}</nowiki>
|{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACENAMESPACI}}:{{PAGENAME}}}}
|-
|<nowiki>{{SERVER}}{{localurl:{{NAMESPACENAMESPACI}}:{{PAGENAME}}_1}}</nowiki>
|{{SERVER}}{{localurl:{{NAMESPACENAMESPACI}}:{{PAGENAME}}_1}}
|-
|<nowiki>''Veire : [[{{NAMESPACENAMESPACI}}:{{PAGENAME}}_1|{{NAMESPACENAMESPACI}} {{PAGENAME}} 1]].''</nowiki>
|''Veire : [[{{NAMESPACENAMESPACI}}:{{PAGENAME}}_1|{{NAMESPACENAMESPACI}} {{PAGENAME}} 1]].''
|-
|<nowiki>[[{{NAMESPACENAMESPACI}}:{{PAGENAME}}_1]]</nowiki>
|[[{{NAMESPACENAMESPACI}}:{{PAGENAME}}_1]]
|-
|<nowiki>[[{{FULLPAGENAME}}_1]]</nowiki>
 
== Les balises d'inclusion sélective ==
Es parfois utile de placer certains éléments dins lelo còdi source dudel modèl (per exempleexèmple les [[Ajuda:Ligam inter-langue|ligams interlangues]]) sanssens que ces éléments n'apparaissent sus la pagina où lelo modèl es inséré. Per ce far, on place les éléments à exclure de l'insertioninsercion entre les balises <nowiki><noinclude> e </noinclude></nowiki>.
 
Inversement, les éléments qu'on veut voirveire apparaître en insertioninsercion, mas qu'on veut voirveire disparaître lors de la visualisationvisualisacion dudel modèl seul son placés entre les balises <nowiki><includeonly> e </includeonly></nowiki>.
 
Placer un titretítol en balisage "includeonly" peutpòt désorganiser la numérotationnumérotacion dudel sommaire e des ligams "modifier" qui apparaissent à droite des titrestítols.
 
Es recommandé de laisser aual mens una espaci entre lelo dernier signe "=" d'un titretítol e una balise <nowiki><</nowiki>includeonly<nowiki>></nowiki>.
 
Es également recommandé, lorsqu'on place una séquence &lt;noinclude>...&lt;/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 lelo modèl), sus una lignelinha séparée, précédée per una autre lignelinha contenant lelo commentaire invisible <font face="monospace">&lt;!-- ne pas effacer aquesta lignelinha de commentaire --></font>.
 
===Balise d'inclusion sélective e substitutionsubstitucion===
Lors d'una insertioninsercion per substitutionsubstitucion ( <nowiki>{{subst:modèl}}</nowiki> ) les balises <nowiki><noinclude> e </noinclude></nowiki> ainsi que lelo textetèxt qu'elles encadrent son reproduites, mas elles ne son pas actionnéesaccionnadas, donc lelo textetèxt 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 avecamb una insertioninsercion per substitutionsubstitucion. VoirVeire [[Ajuda:Ligam_inter-langue#Ligam_inter-langues_per_les_modèls_:_attention__attencion_!]].
 
== Modèls utilisator ==
 
Afin de crear un modèl non encyclopédique (per ex. destiné à êtreèstre appelé per una pagina utilisator) o per far des tests, nul n'es besoin de « polluer » l'espaci des modèls. CelaAquò peutpòt se far sus una sous-pagina utilisator.
 
Per exempleexèmple, se <font style="text-decorationdecoracion:underline;color:blue;">Utilisator:Quidam</font> veut tester un modèl appelé « Article fastidieux », il procède commecoma suit :
 
* il crée una sous-pagina utilisator <font style="text-decorationdecoracion:underline;color:blue;">Utilisator:Quidam/Article&nbsp;fastidieux</font> dins laquelle il écrit lelo modèl :
<nowiki><div style="border:1px solid black;background:rgb(80%,100%,80%);text-align:center;padding=0.4ex;">
''CeciAquò es un article fastidieux. LeLo taux de fàstic es estimé à {{{fàstic}}}%.''
</div></nowiki>
 
 
<div style="border:1px solid black;background:rgb(80%,100%,80%);text-align:center;padding:0.4ex;">
''CeciAquò es un article fastidieux. LeLo taux de fàstic es estimé à 55%.''
</div>
 
<nowiki>{{</nowiki>''espaci 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;">''espaci de nommage'':</tt>, qui ne prend la valeur per défaut <tt style="margin:1px 1px 1px 1px;background:white;color:black;border:1px dotted blue;padding:1px 1px 1px 1px;">Modèl:</tt> que quand l'espaci de nommage es pas indiqué explicitement. De même les paramètres peuvent êtreèstre nommés explicitement, o implicitement per leur rang d'apparitionapparicion dins l'appel dudel 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 dudel typetipe :
 
<nowiki>[http://fr.wikipedia.org/w/index.php?title=nom de la pagina&actionaccion=purge rafraîchir la pagina]</nowiki> e cliquer dessus, o utiliser {{m|purger lelo 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 ''&actionaccion=purge'' n'y change rien. I a deux moyens per forcer la mesa a jorn des ligams e des catégories :
# Se es un problème ponctuel, far una modificationmodificacion vide sus la pagina (cliquer sus modifier puis sus sauvegarder sanssens rien changer : rien n'apparaît dins l'historique mas la table des ligams es mesa a jorn)
# 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 lelo script {{Còdi|touch.py}}. Déposez votre requèsta sus [[Oquipedià:Bot/Requèstas]].
 
Les développeurs son estat mis aual courant de toustotes ces problèmes sus la pagina [http://bugzilla.wikipedia.org/show_bug.cgi?id=939 Bugzilla N°939].
 
== Veire tanben ==
68 071

cambiaments