Ajuda:Modèl

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 messatge 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 càmbia 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 s'inserís lo modèl dins un article en i ajustant, a l'emplaçament 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 de paginas coma las autras e son donc accessibles a l'edicion a totes los contributors. Pasmens, los cal modificar prudentament car lo resultat apareis sus de paginas nombrosas. Quand la pagina correspondent al modèl s'aficha, se pòt clicar sus l'iperligam Paginas ligadas del menut d'esquèrra per consultar las paginas utilizant lo modèl e verificar, abans modificacion, qu'aquestas paginas seràn pas perturbadas.

Creacion d'un modèl

Lo metòde es identic a lo de la creacion d'una pagina quina que siá. Lo pus 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 inclús dins totas las paginas utilizant lo modèl, çò que generalament es 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 abreujats o empegats son de mal reténer perque cap de convencion s'es pas 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 nòstre 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 inclure 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á inclús 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 totes 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 suprimit lèu se deuriá copiar amb subst:, l'avantatge 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 definitivament se deuriá inclure 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}}. Aqueste 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á efectivament modificat aprèp la modificacion del ligam dins lo modèl en question.

Es possible d'inclure de tèxt provenent d'autres espacis de nom ; coma per exemple {{Wikipèdia:Darrièrs cambiaments}}.
Totes los caractèrs son acceptats, comprés los blancs.
Tot cambiament d'un modèl escafa automaticament lo cache de totas las paginas utilizant aqueste modèl.
Los modèls pòdon prendre d'arguments, referenciats per posicion o per nom (vejatz l'exemple pus elaborat çai jos). La sintaxi es la seguenta: {{causa|paramètre=valor}} amb de balisas {{{paramètre}}} dins lo modèl, o {{brol|valor1|valor2}} amb {{{1}}}, {{{2}}}, etc. Notatz que las balisas de paramètres dins lo modèl demandan tres acoladas e non pas doas.
Un modèl pòt inclure un o mantun autre modèl,
Un modèl pòt pas èsser el-meteis paramètre d'un autre modèl.
Las redireccions entre modèls foncionan.

Dins un modèl, per far un ligam vèrs una pagina que depend d'un paramètre d'un modèl, los ligams de tipe extèrne son sovent utilizats quitament per de ligams intèrnes per evitar qu'òm abotisca sus la pagina en mode d'edicion quitament se aquesta pagina existís.

Modèls amb paramètres

Un modèl pòt èsser escrich per acceptar de paramètres. Aquò permet de crear, per exemple, de tablèus preformatats que solas cèrtas valors ne càmbian segon la pagina invocant lo modèl.

(per mai de detalhs vejatz Infobox

Per exemple, lo modèl Modèl:Planeta menora se legís en partida :

{| 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%" |'''{{{nom}}}'''

| padding=15px|

|}

|-

! bgcolor="#6295DA" colspan="2" align="center" | Descobèrta

|-

| Qual || {{{descobreire}}}

|-

| Quora || {{{data_descobèrta}}}

|-

| [[Designacion dels asteroïdes|Designacion(s) provisòria(s)]] || {{{designacions}}}

|-

...

| [[Temperatura]] de superfícia || {{{temperatura}}}

|}

Lo contengut d'aqueste modèl es un tablèu formatat, especificant colors, alinhament, etc. Las partidas apareissent entre triplas acoladas son los paramètres que seràn utilizats per la pagina invocant lo modèl. Se vei çai sus (en gras) los paramètres nom, descobreire, data_descobèrta, designacions e temperatura.

Sus la pagina 14 Irena, se tròba, en partida :

{{Planeta menora | nom=14 Irena (14 Irena)

| descobreire=[[John Russell Hind]]

| data_descobèrta=[[19 de mai]] de [[1851]]

| designacions=A906 QC; A913 EA; 1952 TM

| categorizacion=[[cintura d'asteroïdes]]

| orbita=386,730 [[gigamètre|Gm]] (2,585 [[unitat astronomica|ua]])

...

| dimensions=181,8 km [http://spiff.rit.edu/richmond/parallax/phot/LCSUMPUB.TXT 1]

...

| temperatura=~234 [[kelvin|K]]}}

Per melhorar la legibilitat al moment de l'edicion, de retorns a la linha pòdon aparéisser dins lo modèl, coma dins los tablèus. Idealament, coma se constata çai sus, i pòt aver un retorn a la linha abans cada "|" exceptat lo primièr. Las valors dels paramètres son especificadas en escrivent paramètre=valor. Deu pas i aver de retorn a la linha dins la valor, mas es permés. La valor pòt inclure un ligam exterior (per exemple, lo paramètre dimensions) o interior (per exemple, orbita). Se remarcarà que la sintaxi abituala dels ligams wiki es possibla (es a dire [[pagina visada|tèxt qu'apareisserà]]).

Valor per defaut d'un paramètre

Los paramètres pòdon prendre una valor per defaut, es a dire una valor utilizada automaticament en l'absence d'especificacion sus la pagina d'inclusion, coma aquò {{{3|123}}} (se i a pas de 3en paramètre, 123 serà utilizat en plaça), o coma aquò {{{paramètre|123}}}.

D'exemples son donats sus la pagina Discussion Modèl:Qif.

Modèls especials

Aquestes modèls son predefinits e se devon pas utilizar coma noms de modèls.

`{{NAMESPACE}}`	lo nom de l'espaci de noms ont se tròba la pagina	"Ajuda"
`{{PAGENAME}}`	lo nom de la pagina sens lo prefixe de l'espaci de noms	"Modèl"
`{{PAGENAMEE}}`	lo nom de la pagina sens lo prefixe de l'espaci de noms dins lo format utilizat dins las URL	"Mod%C3%A8l"
`{{FULLPAGENAME}}`	lo nom de la pagina amb lo prefixe de l'espaci de noms	"Ajuda:Modèl"
`{{FULLPAGENAMEE}}`	lo nom de la pagina amb lo prefixe de l'espaci de noms dins lo format utilizat dins las URL	"Ajuda:Mod%C3%A8l"
`{{SITENAME}}`	lo nom del site	"Wikipèdia"
`{{SERVER}}`	l'URL del site	"//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	"11"
`{{CURRENTMONTHNAME}}`	lo nom del mes	"novembre"
`{{CURRENTMONTHNAMEGEN}}`	lo mes	"de novembre"
`{{CURRENTDAY}}`	lo jorn del mes	"22"
`{{CURRENTDAYNAME}}`	lo jorn de la setmana	"divendres"
`{{CURRENTYEAR}}`	l'annada	"2024"
`{{CURRENTTIME}}`	l'ora correnta	"07.55"
`{{NUMBEROFARTICLES}}`	lo nombre d'articles	"90 248"
`{{ns:7}}`	lo nom d'un espaci de nom d'aprèp son numèro	"Discussion Fichièr"

Exemples d'utilizacion 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
''Vejatz : [[{{NAMESPACE}}:{{PAGENAME}}_1\|{{NAMESPACE}} {{PAGENAME}} 1]].''	Vejatz : Ajuda Modèl 1.
[[{{NAMESPACE}}:{{PAGENAME}}_1]]	Ajuda:Modèl_1
[[{{FULLPAGENAME}}_1]]	Ajuda:Modèl_1

Las balisas d'inclusion selectiva

De còps que i a, es util de plaçar cèrts elements dins lo còdi font del modèl (per exemple los ligams interlengas) sens qu'aquestes elements aparescan sus la pagina ont lo modèl es inserit. Per aquò far, se plaça los elements d'exclure de l'insercion entre las balisas <noinclude> e </noinclude>.

Invèrsament, los elements qu'òm vòl veire aparéisser en insercion, mas qu'òm vòl veire disparéisser al moment de la visualizacion del modèl sol son plaçats entre las balisas <includeonly> e </includeonly>.

Plaçar un títol en balisatge "includeonly" pòt desorganizar la numerotacion del somari e dels ligams "modificar" qu'apareisson a drecha dels títols.

Se recomanda de laissar almens un blanc entre lo darrièr signe "=" d'un títol e una balisa <includeonly>.

Se recomanda tanben, quand se plaça una sequéncia <noinclude>...</noinclude>, siá de la far precedir d'un blanc o, encara melhor, compte tengut dels risques d'escafament accidental d'aqueste blanc, e donc d'efièits segondaris indesirables (interwikis d'un modèl reproduchs d'un biais non pertinent dins las paginas qu'utilizan lo modèl), sus una linha separada, precedida per una autra linha contenent lo comentari invisible .

Balisa d'inclusion selectiva e substitucion

Al moment d'una insercion per substitucion ( {{subst:modèl}} ) las balisas <noinclude> e </noinclude> e mai que lo tèxt qu'enquadran son reproduchas, mas ne son pas accionadas, donc lo tèxt atal enquadrat es inserit, contràriament a çò que poiriam creire.

Se poirà donc pas ajustar de ligams interlengas dins de modèls generalament utilizats amb una insercion per substitucion. Vejatz Ajuda:Ligam_interlenga#Ligam_interlenga_per_los_modèls_:_atencion_!.

Modèls utilizaire

Per crear un modèl non enciclopedic (per ex. destinat a èsser apelat per una pagina d'utilizaire) o per far de tèstes, es pas de besonh de « polluir » l'espaci dels modèls. Aquò se pòt far sus una sospagina d'utilizaire.

Per exemple, se Utilizaire:Quidam vòl testar un modèl apelat « Article fastigós », procedís coma seguís :

Crea una sospagina d'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 estimat a {{{fàstic}}}%.''
</div>

utiliza alavetz laguens sas paginas e jos-paginas personalas en tapant :

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

çò da :

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

De manièra generala, la sintaxi (entre claus) mèrca lo modèl :

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

reconeis la preséncia de l’espaci de nomenatge:, que pren la valor per défaut Modèl: que quand l'espaci non es pas indicat explicitament. De la meteissa faiçon, los paramètres pòdon èsser nomenats explicitament, o implicitament per lor rang d'aparicion durant l'appèl del modèl.

Problèmas frequents sus las paginas contenant de modèls

Refrescament : Per refrescar una pagina qu'es restada incambiada, mentre que los modèls que conten son estat modificats, crear un ligam del tipe :

[http://fr.wikipedia.org/w/index.php?title=nom de la pagina&accion=purga refrescar la pagina] e clicar dessus, o utilisar {{purgar lo cache}}.

Mesa a jorn de las taulas : Quand una pagina conten una autre pagina, e que aquesta darrièra es modificada, la pagina principala es mesa a jorn mas pas la taula dels ligams, ni las categorias. Meme un &accion=purga non i cambia ren. I a dos possibiliats per forçar la mesa a jorn dels ligams e de las categorias :

S'es un problèma ponctual, far una modificacion voida sus la pagina (clicar sus modificar puèi sus salvagardar sens rien cambiar : pareis ren dins l'istoric mas la taula des ligams es mesa a jorn)
S'es un problèma recurent, o se de paginas nombrosas son concernidas : demandar a un robòt de passar regulierament sus la pagina concernidae en utilizant lo script touch.py. Depausatz vòstra requèsta sus Wikipèdia:Bòt/Requèstas.

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

Vejatz tanben

Paletas de navigacion
Wikipèdia:Modèls
Wikipèdia:Lista dels modèls
Nauc de sabla (per s'entraïnar a l'utilizacion dels modèls)