Ajuda:Modèl : Diferéncia entre versions

revirada
(revirada)
{{BesonhRevirada}}
Per Wikipedia, un '''modèl''' es un bloc d'informacion qui pòt èstre inclus dins leslas autres paginas. Il pòt servir àa:
*insérer un message standard, exèmple : lo message indiquant qu'un article es proposé àa la suppression [[Modèl:Suppression]]
*insérer un tablèu commun àa plusieurs paginas d'un même domaine. Exèmple : lo tablèu biographique utilisé per leslos présidents des États-Unis [[Modèl:FichePresidentUS]]. Ce modèl es paramétrable, es àa dire qu'i a un ''fond de tablèu'' commun e des ''variables'' dont lo contengut change dins chaque article.
*insérer una paleta de navigacion dins totas leslas paginas d'un même domaine. Exèmple : la paleta utilisée per leslos articles del domaine aéronautique [[Modèl:Aéronautique]].
*etc.
Dins totes leslos cas lo modèl es inséré dins un article en y ajoutant, àa l'emplacement adéquat, lo libellé <nowiki>{{Nom del modèl}}</nowiki>
 
''Note'' : la nocion de ''modèl'' de Wikipedia es différente de celle utilisée dins leslos logiciels de traitement de tèxt.
 
LesLos 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=&namespace=10 lista alphabétique]. Voyez la lista des [[:modèl:modèls principaux|modèls principaux]] utilisés dins Oquipedià.
 
LesLos modèls son des paginas coma leslos autres e donc accessibles àa l'édicion per totes leslos contributeurs. Cal toutefois leslos modifier amb prudence car lo résultat apparaît sus de nombreuses paginas. Lorsque la pagina correspondant al modèl es affichée, on pòt cliquerclicar sus l'hyperligam '''Paginas liées''' del menu de gauche per consulter leslas paginas utilisant lo modèl e vérifier, avant modificacion, que cesaquestas paginas ne seront pas perturbadas.
 
==Creacion d'un modèl==
La méthode es identique àa celle de la creacion d'una pagina quelconque. Lo mai simple es d'insérer un appel al modèl dins un article, puis de cliquerclicar sul ligam (qui apparaîtra en rouge).
 
===Trucs e astuces===
Se lo modèl contient un [[ajuda:ligam inter-langue|ligam inter-langue]], alors ce ligam es inclus dins totas leslas paginas utilisant lo modèl, ce qui n'es généralement pas lo résultat voulu. Se deux ligams inter-langue versvèrs una même autre langue se trouvent dins una pagina, lo résultat es imprévisible. On évitera cesaquestes conflits en utilisant [[#Les_balises_dLas_balisas_d.27inclusion_s.C3.A9lective|leslas balisesbalisas d'inclusion sélective]].
 
LesLos noms de modèls utilisant des mots abrégés o collés son difficiles àa retenir car aucune convencion ne s'es imposée. Il n'y a pas de raison technique per ne pas s'inspirer des [[Oquipedià:convencions suls títols|convencions suls títols]] tanben per leslos noms de modèl.
 
Se lo modèl appartient àa una catégoriecategoria, es àa dire que la pagina del modèl contient un libellé de la forme <nowiki>[[CatégorieCategoria:Nom d'una catégoriecategoria]]</nowiki> totes leslos articles contenant lo modèl appartiendront àa aquesta catégoriecategoria. On pòt utiliser aquesta astuce, per exèmple, per obtenir la lista de totes leslos articles ''ébauche'' d'un domaine donné.
 
== Modificacion ==
 
== Utilisacion ==
Per inclure un modèl cal utiliser la [[ajuda:syntaxesintaxi Oquipedià|syntaxesintaxi Oquipedià]] suivante (la première lettre del nom del modèl es pas sensible àa la casse) :
*<tt><nowiki>{{Nom del modèl}}</nowiki></tt> per que lo modèl soit inclus àa chaque chargement d'una pagina l'utilisant. Ainsi, dès que lo modèl es modifié, la modificacion devient visible dins totas leslas paginas utilisant lo modèl.
*<tt><nowiki>{{subst:Nom del modèl}}</nowiki></tt> per que lo modèl soit copié una fois per toute dins la pagina l'utilisant. Dins ce cas-ci, una modificacion del modèl n'a aucune incidence sus la pagina.
 
Ainsi, un modèl bref e temporaire destiné àa èstre rapidement supprimé devrait èstre copié amb <tt>subst:</tt>, dont l'avantage es qu'il apparaît directement dins la source de l'article. Una notice normale destinée àa rester sus una pagina per una longue durée o bien àa jamais devrait èstre incluse al moyen de <tt><nowiki>{{Nom del modèl}}</nowiki></tt>, de manière àa ce que leslas mises a jorn éventuelles soient mai aisées. Un modèl contenant un ligam temporaire o susceptible de changercambiar ne devrait cependant pas èstre ajouté per <tt><nowiki>{{Nom del modèl}}</nowiki></tt>. Aquesta méthode, en effet, ne met pas a jorn lo ligam ''Paginas liées'' àa mens que chaque article contenant lo <tt><nowiki>{{Nom del modèl}}</nowiki></tt> soit effectivement modifié après la modificacion del ligam dins lo modèl en question.
 
* Es possible d'inclure del tèxt provenant d'autres espacis de nom ; coma per exèmple <tt><nowiki>{{Oquipedià:Modificacions récentes}}</nowiki></tt>.
* Totes leslos caractères son acceptés, y compris leslos espacis.
* Tot changement d'un modèl efface automatiquement lo cache de totas leslas paginas utilisant ce modèl.
* LesLos modèls peuventpòdon prendre des arguments, référencés per posicion o per nom (veire l'exèmple mai élaboré ci-dessousdejos). La syntaxesintaxi es la suivante: <tt><nowiki>{{chose|paramètre=valeurvalor}}</nowiki></tt> amb des ''balisesbalisas'' <tt><nowiki>{{{paramètre}}}</nowiki></tt> dins lo modèl, o bien <tt><nowiki>{{brol|valeur1valor1|valeur2valor2}}</nowiki></tt> amb <tt><nowiki>{{{1}}}</nowiki></tt>, <tt><nowiki>{{{2}}}</nowiki></tt>, etc. Notez que leslas balisesbalisas de paramètres dins lo modèl demandent trois accolades e non deux.
* Un modèl pòt inclure un o plusieurs autres modèls,
* Un modèl ne pòt pas èstre lui-même paramètre d'un autre modèl.
* LesLas [[Ajuda:redireccion|redireccion]]s entre modèls fonccionnent.
 
<!---
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 versvèrs una pagina qui dépend d'un paramètre d'un modèl, leslos ligams de tipe extèrne son souvent utilisés même per des ligams internes afin d'éviter qu'on aboutisse sus la pagina en mode d'édicionedicion même se aquesta pagina existe.
 
== Modèls àa paramètres==
 
Un modèl pòt èstre écrit afin d'accepter des ''paramètres''. Aquò permet de crear, per exèmple, des tablèus pré-formatés dont seules certaines valeursvalors changent selon la pagina invoquant lo modèl.
 
(per mai de détaildetail veire [[Oquipedià:Modèls/Infobox|Infobox]]
 
Per exèmple, lo modèl [[Modèl:Planète mineure]] se lit en partie :
:<tt><nowiki>|}</nowiki></tt><br />
:<tt><nowiki>|-</nowiki></tt><br />
:<tt><nowiki>! bgcolor="#6295DA" colspan="2" align="center" | DécouverteDescobèrta</nowiki></tt><br />
:<tt><nowiki>|-</nowiki></tt><br />
:<tt><nowiki>| Qui || {{{</nowiki>'''découvreurdescobreire'''<nowiki>}}}</nowiki></tt><br />
:<tt><nowiki>|-</nowiki></tt><br />
:<tt><nowiki>| Quand || {{{</nowiki>'''date_découvertedate_descobèrta'''<nowiki>}}}</nowiki></tt><br />
:<tt><nowiki>|-</nowiki></tt><br />
:<tt><nowiki>| [[DésignacionDesignacion des astéroïdesasteroïdes|DésignacionDesignacion(s) provisoire(s)]] || {{{</nowiki>'''désignacionsdesignacions'''<nowiki>}}}</nowiki></tt><br />
:<tt><nowiki>|-</nowiki></tt><br />
 
:<tt>...</tt>
 
:<tt><nowiki>| [[TempératureTemperature]] de surface || {{{</nowiki>'''températuretemperature'''<nowiki>}}}</nowiki></tt><br />
:<tt><nowiki>|}</nowiki></tt>
 
Lo contengut de ce modèl es un tablèu formaté, spécifiant couleurs, alinhament, etc. LesLas parties apparaissant entre triple accolades son leslos ''paramètres'' qui seront utilisés per la pagina invoquant lo modèl. On voit ci-dessus (en gras) leslos paramètres '''nom''', '''découvreurdescobreire''', '''date_découvertedate_descobèrta''', '''désignacions''' e '''température'''.
 
Sus la pagina [[(14) Irène|14 Irène]], on trouve, en partie :
 
:<tt><nowiki>{{Planète mineure | </nowiki>'''nom'''<nowiki>=14 Irène (14 Irene)</nowiki></tt><br />
:<tt><nowiki>| </nowiki>'''découvreurdescobreire'''<nowiki>=[[John Russell Hind]]</nowiki></tt><br />
:<tt><nowiki>| </nowiki>'''date_découvertedate_descobèrta'''<nowiki>=[[19 mai]] [[1851]]</nowiki></tt><br />
:<tt><nowiki>| </nowiki>'''désignacions'''<nowiki>=A906 QC; A913 EA;<br />1952 TM</nowiki></tt><br />
:<tt><nowiki>| </nowiki>'''catégorisacion'''<nowiki>=[[ceinture d'astéroïdes]]</nowiki></tt><br />
:<tt><nowiki>| </nowiki>'''température'''<nowiki>=~234 [[kelvin|K]]}}</nowiki></tt>
 
Afin d'améliorer la lisibilité lors de l'édicion, des retours àa la linha peuventpòdon apparaître dins lo modèl, àa la façon des tablèus. Idéalement, coma on le constate ci-haut, il pòt y avoir un retour àa la linha avant chaque "|" sauf lo premier. LesLas valeursvalors des paramètres son spécifiées en écrivant ''paramètre=valeurvalor''. Il ne doit pas y avoir de retour àa la linha dins la valeurvalor, mas <nowiki><br /></nowiki> es permis. La valeurvalor pòt inclure un ligam extérieur (per exèmple, lo paramètre ''dimensions'') o intérieur (per exèmple, ''orbite''). On remarquera que la syntaxesintaxi habituelle des ligams wiki es possible (es-àa-dire <nowiki>[[pagina visée|tèxt qui apparaîtra]]</nowiki>).
 
===ValeurValor per défaut d'un paramètre ===
LesLos paramètres peuventpòdon prendre una valeurvalor per défaut, es àa dire una valeurvalor utilisée automatiquement en l'absence de spécificacion sus la pagina d'inclusion, coma aquò <nowiki>{{{3|123}}}</nowiki> (s'il n'y a pas de 3e paramètre, 123 sera utilisé àa la place), o coma aquò <nowiki>{{{paramètre|123}}}.</nowiki>
 
Des exèmples son donnés sus la pagina [[Discussion Modèl:Qif]].
|}
 
== LesLas balisesbalisas d'inclusion sélective ==
Es parfois utile de placer certains élémentselements dins lo còdi source del modèl (per exèmple leslos [[Ajuda:Ligam inter-langue|ligams interlangues]]) sens que cesaquestes élémentselements n'apparaissent sus la pagina où lo modèl es inséré. Per ce far, on place leslos élémentselements àa exclure de l'insercion entre leslas balisesbalisas <nowiki><noinclude> e </noinclude></nowiki>.
 
Inversement, leslos élémentselements qu'on veut veire apparaître en insercion, mas qu'on veut veire disparaître lors de la visualisacion del modèl seul son placés entre leslas balisesbalisas <nowiki><includeonly> e </includeonly></nowiki>.
 
Placer un títol en balisage "includeonly" pòt désorganiser la numérotacion del sommaire e des ligams "modifier" qui apparaissent àa droite des títols.
 
Es recommandé de laisser al mens un espaci entre lo dernier signe "=" d'un títol e una balisebalisa <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'un espaci o, mieux encore, compte tenu des risques d'effacement accidentel de aqueste espaci, e donc d'effets secondaires indésirables (interwikis d'un modèl reproduits de manière non pertinente dins leslas paginas qui utilisent lo modèl), sus una linha séparée, précédée per una autre linha contenant lo commentaire invisible <font face="monospace">&lt;!-- ne pas effaceresfaçar aquesta linha de commentaire --></font>.
 
===BaliseBalisa d'inclusion sélective e substitucion===
Lors d'una insercion per substitucion ( <nowiki>{{subst:modèl}}</nowiki> ) leslas balisesbalisas <nowiki><noinclude> e </noinclude></nowiki> ainsi que lo tèxt qu'elles encadrent son reproduites, mas elles ne son pas accionnadas, donc lo tèxt ainsi encadré es inséré, contrairement àa ce qu'on pourrait croire.
 
On ne pourra donc pas ajustar de ligams interlangues dins des modèls généralement utilisés amb una insercion per substitucion. Veire [[Ajuda:Ligam_inter-langue#Ligam_inter-langues_per_les_modèls_langues_per_los_modèls_:_attencion_!]].
 
== Modèls utilisator ==
 
Afin de crear un modèl non encyclopédique (per ex. destiné àa èstre appelé per una pagina utilisator) o per far des tests, nul n'es besoin de « polluer » l'espaci des modèls. Aquò pòt se far sus una sousjos-pagina utilisator.
 
Per exèmple, se <font style="text-decoracion:underline;color:blue;">Utilisator:Quidam</font> veut tester un modèl appelé « Article fastidieuxfastigós », il procède coma suit :
 
* il crée una sousjos-pagina utilisator <font style="text-decoracion:underline;color:blue;">Utilisator:Quidam/Article&nbsp;fastidieuxfastigós</font> dins laquelle il écrit lo modèl :
<nowiki><div style="border:1px solid black;background:rgb(80%,100%,80%);text-align:center;padding=0.4ex;">
''Aquò es un article fastidieuxfastigós. Lo tauxtaus de fàstic es estimé àa {{{fàstic}}}%.''
</div></nowiki>
 
* il l'utilise ensuite dins ses paginas e sousjos-paginas personnelles en tapant :
 
<nowiki>{{Utilisator:Quidam/Article fastidieuxfastigós|fàstic=55}}</nowiki>
 
ce qui donne :
 
<div style="border:1px solid black;background:rgb(80%,100%,80%);text-align:center;padding:0.4ex;">
''Aquò es un article fastidieuxfastigós. Lo tauxtaus de fàstic es estimé àa 55%.''
</div>
 
D’una façon générale, la syntaxesintaxi (entre doubles accolades) d’appel d'un modèl :
 
<nowiki>{{</nowiki>''espaci de nommage''<nowiki>:</nowiki>''nom d’article''<nowiki>|</nowiki>''paramètre1''<nowiki>=</nowiki>''valeur1valor1''<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 valeurvalor 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 leslos paramètres peuventpòdon èstre nommésnomenats explicitement, o implicitement per leur rang d'apparicion dins l'appel del modèl.
 
==ProblèmesProblèmas fréquents sus las paginas contenant des modèls==
'''Rafraîchissement''' : Per rafraîchir una pagina qui es restée inchangée, alors que leslos modèls qu'elle contient son estat modifiés, crear un ligam del tipe :
 
<nowiki>[http://fr.wikipedia.org/w/index.php?title=nom de la pagina&accion=purge rafraîchir la pagina]</nowiki> e cliquerclicar dessus, o utiliser {{m|purger lo cache}}.
 
'''Mesa a jorn des tablestaulas''' : Quand una pagina contient una autre pagina, e que aquesta dernièredarrièra es modifiée, la pagina principale es mesa a jorn mas pas la tabletaula des ligams, ni leslas catégoriescategorias. Même un ''&accion=purge'' n'y change rien. I a deux moyens per forcer la mesa a jorn des ligams e des catégoriescategorias :
# Se es un problèmeproblèma ponctuel, far una modificacion vide sus la pagina (cliquerclicar sus modifier puis sus sauvegarder sens rien changercambiar : rien n'apparaît dins l'historiqueistoric mas la tabletaula des ligams es mesa a jorn)
# Se es un problèmeproblèma récurrent, o se de nombreuses paginas son concernées : demander àa un robot de passer régulièrement sus la pagina concernée en utilisant lo script {{Còdi|touch.py}}. Déposez votrevòstra requèsta sus [[Oquipedià:Bot/Requèstas]].
 
LesLos développeurs son estat mismeses al courantcorrent de totes cesaquestes problèmesproblèmas sus la pagina [http://bugzilla.wikipedia.org/show_bug.cgi?id=939 Bugzilla N°939].
 
== Veire tanben ==
68 071

cambiaments