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

Un article de Wikipèdia, l'enciclopèdia liura.
Contengut suprimit Contengut apondut
Cedric31 (discussion | contribucions)
revirada
Cedric31 (discussion | contribucions)
Cap resum de modificació
Linha 9 : Linha 9 :
''Note'' : la nocion de ''modèl'' de Wikipedia es différente de celle utilisée dins les logiciels de traitement de tèxt.
''Note'' : la nocion de ''modèl'' de Wikipedia es différente de celle utilisée dins les logiciels de traitement de tè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=&namespaci=10 lista alphabétique]. Voyez la lista des [[:modèl:modèls principaux|modèls principaux]] utilisés dins Oquipedià.
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=&namespace=10 lista alphabétique]. Voyez la lista des [[:modèl:modèls principaux|modèls principaux]] utilisés dins Oquipedià.


Les modèls son des paginas coma les autres e donc accessibles à l'édicion per totes les contributeurs. Cal toutefois les 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 cliquer sus l'hyperligam '''Paginas liées''' del menu de gauche per consulter les paginas utilisant lo modèl e vérifier, avant modificacion, que ces paginas ne seront pas perturbadas.
Les modèls son des paginas coma les autres e donc accessibles à l'édicion per totes les contributeurs. Cal toutefois les 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 cliquer sus l'hyperligam '''Paginas liées''' del menu de gauche per consulter les paginas utilisant lo modèl e vérifier, avant modificacion, que ces paginas ne seront pas perturbadas.
Linha 107 : Linha 107 :


{|border
{|border
| <tt><nowiki>{{NAMESPACI}}</nowiki></tt>
| <tt><nowiki>{{NAMESPACE}}</nowiki></tt>
| lo nom de l'[[Ajuda:Espaci de noms|espaci de noms]] dins loqual se troba la pagina
| lo nom de l'[[Ajuda:Espaci de noms|espaci de noms]] dins loqual se troba la pagina
| "{{NAMESPACI}}"
| "{{NAMESPACE}}"
|-
|-
| <tt><nowiki>{{PAGENAME}}</nowiki></tt>
| <tt><nowiki>{{PAGENAME}}</nowiki></tt>
Linha 182 : Linha 182 :
=== Exèmples d'utilisacion de modèls especials===
=== Exèmples d'utilisacion de modèls especials===
{|
{|
|<nowiki>{{SERVER}}{{localurl:{{NAMESPACI}}:{{PAGENAME}}|accion=edit}}</nowiki>
|<nowiki>{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|accion=edit}}</nowiki>
|{{SERVER}}{{localurl:{{NAMESPACI}}:{{PAGENAME}}|accion=edit}}
|{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|accion=edit}}
|-
|-
|<nowiki>{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACI}}:{{PAGENAME}}}}</nowiki>
|<nowiki>{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAME}}}}</nowiki>
|{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACI}}:{{PAGENAME}}}}
|{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAME}}}}
|-
|-
|<nowiki>{{SERVER}}{{localurl:{{NAMESPACI}}:{{PAGENAME}}_1}}</nowiki>
|<nowiki>{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}_1}}</nowiki>
|{{SERVER}}{{localurl:{{NAMESPACI}}:{{PAGENAME}}_1}}
|{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}_1}}
|-
|-
|<nowiki>''Veire : [[{{NAMESPACI}}:{{PAGENAME}}_1|{{NAMESPACI}} {{PAGENAME}} 1]].''</nowiki>
|<nowiki>''Veire : [[{{NAMESPACE}}:{{PAGENAME}}_1|{{NAMESPACE}} {{PAGENAME}} 1]].''</nowiki>
|''Veire : [[{{NAMESPACI}}:{{PAGENAME}}_1|{{NAMESPACI}} {{PAGENAME}} 1]].''
|''Veire : [[{{NAMESPACE}}:{{PAGENAME}}_1|{{NAMESPACE}} {{PAGENAME}} 1]].''
|-
|-
|<nowiki>[[{{NAMESPACI}}:{{PAGENAME}}_1]]</nowiki>
|<nowiki>[[{{NAMESPACE}}:{{PAGENAME}}_1]]</nowiki>
|[[{{NAMESPACI}}:{{PAGENAME}}_1]]
|[[{{NAMESPACE}}:{{PAGENAME}}_1]]
|-
|-
|<nowiki>[[{{FULLPAGENAME}}_1]]</nowiki>
|<nowiki>[[{{FULLPAGENAME}}_1]]</nowiki>
Linha 208 : Linha 208 :
Placer un títol en balisage "includeonly" pòt désorganiser la numérotacion del sommaire e des ligams "modifier" qui apparaissent à droite des títols.
Placer un títol en balisage "includeonly" pòt désorganiser la numérotacion del sommaire e des ligams "modifier" qui apparaissent à droite des títols.


Es recommandé de laisser al mens una espaci entre lo dernier signe "=" d'un títol e una balise <nowiki><</nowiki>includeonly<nowiki>></nowiki>.
Es recommandé de laisser al mens un espaci entre lo dernier signe "=" d'un tí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 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 effacer aquesta linha de commentaire --></font>.
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 les 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 effacer aquesta linha de commentaire --></font>.


===Balise d'inclusion sélective e substitucion===
===Balise d'inclusion sélective e substitucion===

Version del 8 febrièr de 2006 a 22.29

Modèl:BesonhRevirada Per Wikipedia, un modèl es un bloc d'informacion qui pòt èstre inclus dins les autres paginas. Il pòt servir à:

  • insérer un message standard, exèmple : lo message indiquant qu'un article es proposé à la suppression Modèl:Suppression
  • insérer un tablèu commun à plusieurs paginas d'un même domaine. Exèmple : lo tablè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 tablèu commun e des variables dont lo contengut change dins chaque article.
  • insérer una paleta de navigacion dins totas les paginas d'un même domaine. Exèmple : la paleta utilisée per les articles del domaine aéronautique Modèl:Aéronautique.
  • etc.

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

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

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

Les modèls son des paginas coma les autres e donc accessibles à l'édicion per totes les contributeurs. Cal toutefois les 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 cliquer sus l'hyperligam Paginas liées del menu de gauche per consulter les paginas utilisant lo modèl e vérifier, avant modificacion, que ces paginas ne seront pas perturbadas.

Creacion d'un modèl

La méthode es identique à 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 cliquer sul ligam (qui apparaîtra en rouge).

Trucs e astuces

Se lo modèl contient un ligam inter-langue, alors ce ligam es inclus dins totas les paginas utilisant lo modèl, ce qui n'es généralement pas lo résultat voulu. Se deux ligams inter-langue vers una même autre langue se trouvent dins una pagina, lo 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 convencion ne s'es imposée. Il n'y a pas de raison technique per ne pas s'inspirer des convencions suls títols tanben per les noms de modèl.

Se lo modèl appartient à una catégorie, es à dire que la pagina del modèl contient un libellé de la forme [[Catégorie:Nom d'una catégorie]] totes les articles contenant lo modèl appartiendront à aquesta catégorie. On pòt utiliser aquesta astuce, per exèmple, per obtenir la lista de totes les articles ébauche d'un domaine donné.

Modificacion

Dins notre exèmple, rendez vous sus la pagina Modèl:En cours per lo modifier, autrement, remplacer lo « En cours » pel nom de la paleta souhaitée.

Utilisacion

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

  • {{Nom del modèl}} per que lo modèl soit inclus à chaque chargement d'una pagina l'utilisant. Ainsi, dès que lo modèl es modifié, la modificacion devient visible dins totas les paginas utilisant lo modèl.
  • {{subst:Nom del modèl}} 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é à èstre rapidement supprimé devrait èstre copié amb 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 èstre incluse al moyen de {{Nom del 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 èstre ajouté per {{Nom del modèl}}. Aquesta méthode, en effet, ne met pas a jorn lo ligam Paginas liées à mens que chaque article contenant lo {{Nom del modèl}} 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 {{Oquipedià:Modificacions récentes}}.
  • Totes les caractères son acceptés, y compris les espacis.
  • Tot changement d'un modèl efface automatiquement lo cache de totas les paginas utilisant ce modèl.
  • Les modèls peuvent prendre des arguments, référencés per posicion o per nom (veire l'exèmple mai élaboré ci-dessous). La syntaxe es la suivante: {{chose|paramètre=valeur}} amb des balises {{{paramètre}}} dins lo modèl, o bien {{brol|valeur1|valeur2}} amb {{{1}}}, {{{2}}}, etc. Notez que les balises 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.
  • Les redireccions entre modèls fonccionnent.

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 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'édicion même se aquesta pagina existe.

Modèls à 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 valeurs changent selon la pagina invoquant lo modèl.

(per mai de détail veire Infobox

Per exèmple, lo 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ésignacion des astéroïdes|Désignacion(s) provisoire(s)]] || {{{désignacions}}}
|-
...
| [[Température]] de surface || {{{température}}}
|}

Lo contengut de ce modèl es un tablèu formaté, spécifiant couleurs, alinhament, etc. Les parties apparaissant entre triple accolades son les paramètres qui seront utilisés per la pagina invoquant lo modèl. On voit ci-dessus (en gras) les paramètres nom, découvreur, date_découverte, désignacions 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ésignacions=A906 QC; A913 EA;<br />1952 TM
| catégorisacion=[[ceinture d'astéroïdes]]
| orbite=386,730 [[gigamètre|Gm]] (2,585 [[unité astronomique|ua]])
...
| dimensions=181,8 km <sup>[http://spiff.rit.edu/richmond/parallax/phot/LCSUMPUB.TXT 1]</sup>
...
| température=~234 [[kelvin|K]]}}

Afin d'améliorer la lisibilité lors de l'édicion, des retours à la linha peuvent apparaître dins lo modèl, à la façon des tablèus. Idéalement, coma on le constate ci-haut, il pòt y avoir un retour à la linha avant chaque "|" sauf lo premier. Les valeurs des paramètres son spécifiées en écrivant paramètre=valeur. Il ne doit pas y avoir de retour à la linha dins la valeur, mas <br /> es permis. La valeur 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 syntaxe habituelle des ligams wiki es possible (es-à-dire [[pagina visée|tèxt 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écificacion sus la pagina d'inclusion, coma aquò {{{3|123}}} (s'il n'y a pas de 3e paramètre, 123 sera utilisé à la place), o coma aquò {{{paramètre|123}}}.

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

Modèls especials

Aquestes modèls son predefinits e devon pas èstre utilisat coma nom de modèls.

{{NAMESPACE}} lo nom de l'espaci de noms dins loqual se troba la pagina "Ajuda"
{{PAGENAME}} lo nom de la pagina sens lo prefix de l'espaci de noms "Modèl"
{{PAGENAMEE}} lo nom de la pagina sens lo prefix de l'espaci de noms dins lo format utilisat dins las URL "Mod%C3%A8l"
{{FULLPAGENAME}} lo nom de la pagina amb lo prefix de l'espaci de noms "Ajuda:Modèl"
{{FULLPAGENAMEE}} lo nom de la pagina amb lo prefix de l'espaci de noms dins lo format utilisat dins las URL "Ajuda:Mod%C3%A8l"
{{SITENAME}} lo nom del siti "Wikipèdia"
{{SERVER}} l'URL del siti "//oc.wikipedia.org"
{{localurl:nom d'una pagina}} l'URL correspondent a una pagina "/wiki/Nom_d%27una_pagina"
{{localurl:nom d'una pagina|paramètres}} idem mas amb de paramètres "/w/index.php?title=Nom_d%27una_pagina&paramètres"
{{CURRENTMONTH}} lo mes "03"
{{CURRENTMONTHNAME}} lo nom del mes "març"
{{CURRENTMONTHNAMEGEN}} lo mes "de març"
{{CURRENTDAY}} lo jorn del mes "28"
{{CURRENTDAYNAME}} lo jorn de la setmana "dijòus"
{{CURRENTYEAR}} l'annada "2024"
{{CURRENTTIME}} l'ora correnta "15.19"
{{NUMBEROFARTICLES}} lo nombre d'articles "89 541"
{{ns:7}} lo nom d'un espaci de nom d'aprèp son numero "Discussion Fichièr"

Exèmples d'utilisacion de modèls especials

{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}|accion=edit}} //oc.wikipedia.org/w/index.php?title=Ajuda:Mod%C3%A8l&accion=edit
{{SERVER}}{{localurl:Special:Whatlinkshere|target={{NAMESPACE}}:{{PAGENAME}}}} //oc.wikipedia.org/w/index.php?title=Especial:Whatlinkshere&target=Ajuda:Modèl
{{SERVER}}{{localurl:{{NAMESPACE}}:{{PAGENAME}}_1}} //oc.wikipedia.org/wiki/Ajuda:Mod%C3%A8l_1
''Veire : [[{{NAMESPACE}}:{{PAGENAME}}_1|{{NAMESPACE}} {{PAGENAME}} 1]].'' Veire : Ajuda Modèl 1.
[[{{NAMESPACE}}:{{PAGENAME}}_1]] Ajuda:Modèl_1
[[{{FULLPAGENAME}}_1]] Ajuda:Modèl_1

Les balises d'inclusion sélective

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

Inversement, les éléments 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 les balises <includeonly> e </includeonly>.

Placer un títol en balisage "includeonly" pòt désorganiser la numérotacion del sommaire e des ligams "modifier" qui apparaissent à droite des títols.

Es recommandé de laisser al mens un espaci entre lo dernier signe "=" d'un títol e una balise <includeonly>.

Es également recommandé, lorsqu'on place una séquence <noinclude>...</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 les paginas qui utilisent lo modèl), sus una linha séparée, précédée per una autre linha contenant lo commentaire invisible <!-- ne pas effacer aquesta linha de commentaire -->.

Balise d'inclusion sélective e substitucion

Lors d'una insercion per substitucion ( {{subst:modèl}} ) les balises <noinclude> e </noinclude> 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 à 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_:_attencion_!.

Modèls utilisator

Afin de crear un modèl non encyclopédique (per ex. destiné à è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 sous-pagina utilisator.

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

  • il crée una sous-pagina utilisator Utilisator:Quidam/Article fastidieux dins laquelle il écrit lo modèl :
<div style="border:1px solid black;background:rgb(80%,100%,80%);text-align:center;padding=0.4ex;">
''Aquò es un article fastidieux. Lo 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 :

Aquò es un article fastidieux. Lo 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 èstre nommés explicitement, o implicitement per leur rang d'apparicion dins l'appel del 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 del tipe :

[http://fr.wikipedia.org/w/index.php?title=nom de la pagina&accion=purge rafraîchir la pagina] e cliquer dessus, o utiliser {{purger lo 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 &accion=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 modificacion vide sus la pagina (cliquer sus modifier puis sus sauvegarder sens 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 lo script touch.py. Déposez votre requèsta sus Oquipedià:Bot/Requèstas.

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

Veire tanben