Ajuda:Modèl

Modèl:BesonhRevirada Per Wikipèdia, un modèl es un blòt d'informacion que pòt èsser inclús dins las autras paginas. Pòt servir a:

• inserir un messatge estandard, exemple : lo message indicant qu'un article es prepausat a la supression Modèl:Supression
• inserir un tablèu comun a mantuna pagina d'un meteis domeni. Exemple : lo tablèu biografic utilizat pels presidents dels Estats Units Modèl:FichaPresidentUS. Aqueste modèl es parametrable, es a dire qu'i a un fons de tablèu comun e de variablas que lo contengut ne cambia dins cada article.
• inserir una paleta de navigacion dins totas las paginas d'un meteis domeni. Exemple : la paleta utilizada pels articles del domeni aeronautic Modèl:Aeronautic.
• etc.

Dins totes los cases lo modèl es inserit dins un article en i ajustant, a l'emplaçant adeqüat, lo libellat {{Nom del modèl}}

Nòta : la nocion de modèl de Wikipèdia es diferenta de la utilizada dins los logicials de tractament de tèxt.

Los modèls son gerits dins un espaci de noms. Atal, una pagina especiala ne balha una lista alfabetica. Vejatz la lista dels modèls principals utilizats dins Wikipèdia.

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

Creacion d'un modèl

Lo metòde es identic a lo de la creacion d'una pagina quina que siá. Lo mai simple es d'inserir un apèl dins lo modèl d'un article, puèi de clicar sul ligam (qu'apareisserà en roge).

Trucs e astúcias

Se lo modèl conten un ligam interlenga, alara aqueste ligam es inclus dins totas las paginas utilizant lo modèl, çò qu'es generalament pas lo resultat volgut. Se dos ligams interlenga vèrs una meteissa autra lenga se tròban dins una pagina, lo resultat es imprevisible. S'evitarà aquestes conflictes en utilizant las balisas d'inclusion selectiva.

Los noms de modèls utilizant de mots abrejats o empegats son dificils de reténer perque cap convencion s'es impausada. I a pas de rason tecnica per s'inspirar pas de las convencions suls títols tanben pels noms de modèl.

Se lo modèl aparten a una categoria, es a dire que la pagina del modèl conten un libellat de la forma [[Categoria:Nom d'una categoria]] totes los articles contenent lo modèl apartendràn a aquesta categoria. Se pòt utilizar aquesta astúcia, per exemple, per obténer la lista de totes los articles esbòs d'un domeni donat.

Modificacion

Dins notre exemple, rendètz-vos sus la pagina Modèl:En cors per lo modificar, autrament, remplaçar lo « En cors » pel nom de la paleta desirada.

Utilizacion

Per inclòure un modèl cal utilizar la sintaxi Wikipèdia seguenta (la primièra letra del nom del modèl es pas sensibla a la cassa) :

• {{Nom del modèl}} per que lo modèl siá inclus a cada cargament d'una pagina l'utilizant. Atal, tre que lo modèl es modificat, la modificacion se fa visibla dins totas las paginas utilizant lo modèl.
• {{subst:Nom del modèl}} per que lo modèl siá copiat un còp per totas dins la pagina l'utilizant. Dins aqueste cas, una modificacion del modèl a pas cap d'incidéncia sus la pagina.

Atal, un modèl brèu e temporari destinat a èsser rapidament suprimit deurià èsser copiat amb subst:, l'avantage es qu'apareisserà dirèctament dins la font de l'article. Una notícia normala destinada a demorar sus una pagina per una durada longa o a jamai deurià èsser inclusa amb l'ajuda de {{Nom del modèl}}, de biais que las mesas a jorn eventualas sián mai aisidas. Un modèl contenent un ligam temporari o susceptible de cambiar deuriá çaquelà pas èsser ajustat per {{Nom del modèl}}. Aquesta metòde, en efièch, met pas a jorn lo ligam Paginas ligadas a mens que cada article contenent lo {{Nom del modèl}} siá efiechivament modificat aprèp 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 {{Wikipèdia:Modificacions récentes}}.
• Totes los caractères son acceptés, y compris los espacis.
• Tot changement d'un modèl efface automatiquement lo cache de totas las paginas utilisant ce modèl.
• Los modèls pòdon prendre des arguments, référencés per posicion o per nom (veire l'exèmple mai élaboré ci-dejos). La sintaxi es la suivante: {{chose|paramètre=valor}} amb des balisas {{{paramètre}}} dins lo modèl, o bien {{brol|valor1|valor2}} amb {{{1}}}, {{{2}}}, etc. Notez que las balisas 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.
• Las redireccions entre modèls fonccionnent.

Dins un modèl, per far un ligam vèrs una pagina qui dépend d'un paramètre d'un modèl, los 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'edicion 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 valors changent selon la pagina invoquant lo modèl.

(per mai de detail 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" | Descobèrta

|-

| Qui || {{{descobreire}}}

|-

| Quand || {{{date_descobèrta}}}

|-

| [[Designacion des asteroïdes|Designacion(s) provisoire(s)]] || {{{designacions}}}

|-

...

| [[Temperature]] de surface || {{{temperature}}}

|}

Lo contengut de ce modèl es un tablèu formaté, spécifiant couleurs, alinhament, etc. Las parties apparaissant entre triple accolades son los paramètres qui seront utilisés per la pagina invoquant lo modèl. On voit ci-dessus (en gras) los paramètres nom, descobreire, date_descobèrta, désignacions e température.

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

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

| descobreire=[[John Russell Hind]]

| date_descobèrta=[[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 ^{[http://spiff.rit.edu/richmond/parallax/phot/LCSUMPUB.TXT 1]}

...

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

Afin d'améliorer la lisibilité lors de l'édicion, des retours a la linha pò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. Las valors des paramètres son spécifiées en écrivant paramètre=valor. Il ne doit pas y avoir de retour a la linha dins la valor, mas <br /> es permis. La valor 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 sintaxi habituelle des ligams wiki es possible (es-a-dire [[pagina visée|tèxt qui apparaîtra]]).

Valor per défaut d'un paramètre

Los paramètres pòdon prendre una valor per défaut, es a dire una valor 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é a 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	"04"
{{CURRENTMONTHNAME}}	lo nom del mes	"abril"
{{CURRENTMONTHNAMEGEN}}	lo mes	"d'abril"
{{CURRENTDAY}}	lo jorn del mes	"19"
{{CURRENTDAYNAME}}	lo jorn de la setmana	"divendres"
{{CURRENTYEAR}}	l'annada	"2024"
{{CURRENTTIME}}	l'ora correnta	"09.50"
{{NUMBEROFARTICLES}}	lo nombre d'articles	"89 629"
{{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

Las balisas d'inclusion sélective

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

Inversement, los elements 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 las balisas <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 a droite des títols.

Es recommandé de laisser al mens un espaci entre lo dernier signe "=" d'un títol e una balisa <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 las 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 esfaçar aquesta linha de commentaire -->.

Balisa d'inclusion sélective e substitucion

Lors d'una insercion per substitucion ( {{subst:modèl}} ) las balisas <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 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_los_modèls_:_attencion_!.

Modèls utilizaire

Afin de crear un modèl non encyclopédique (per ex. destiné a èstre appelé per una pagina utilizaire) o per far des tests, nul n'es besoin de « polluer » l'espaci des modèls. Aquò pòt se far sus una jos-pagina utilizaire.

Per exèmple, se Utilizaire:Quidam veut tester un modèl appelé « Article fastigós », il procède coma suit :

• il crée una jos-pagina utilizaire Utilizaire:Quidam/Article fastigós 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 fastigós. Lo taus de fàstic es estimé a {{{fàstic}}}%.''
</div>

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

{{Utilizaire:Quidam/Article fastigós|fàstic=55}}

ce qui donne :

Aquò es un article fastigós. Lo taus de fàstic es estimé a 55%.

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

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

reconnait la présence de l’espaci de nommage:, qui ne prend la valor per défaut Modèl: que quand l'espaci de nommage es pas indiqué explicitement. De même los paramètres pòdon èstre nomenats explicitement, o implicitement per leur rang d'apparicion dins l'appel del modèl.

Problè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 los 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 clicar dessus, o utiliser {{purger lo cache}}.

Mesa a jorn des taulas : Quand una pagina contient una autre pagina, e que aquesta darrièra es modifiée, la pagina principale es mesa a jorn mas pas la taula des ligams, ni las categorias. Même un &accion=purge n'y change rien. I a deux moyens per forcer la mesa a jorn des ligams e des categorias :

1. Se es un problèma ponctuel, far una modificacion vide sus la pagina (clicar sus modifier puis sus sauvegarder sens rien cambiar : rien n'apparaît dins l'istoric mas la taula des ligams es mesa a jorn)
2. Se es un problèma récurrent, o se de nombreuses paginas son concernées : demander a un robòt de passer régulièrement sus la pagina concernée en utilisant lo script touch.py. Déposez vòstra requèsta sus Wikipèdia:Bòt/Requèstas.

Los développeurs son estat meses al corrent de totes aquestes problèmas sus la pagina Bugzilla N°939.

Veire tanben

• Paletas de navigacion
• Wikipèdia:Modèls
• Wikipèdia:Lista dels modèls
• Nauc de sabla (per s'entrainar a l'utilisacion dels modèls)