Modelo:Wikipedia:Jargon/Modelo
Los modelos son accesibles a la edición por todos los contributeurs. Falla modificarlos sin embargo con prudencia porque el resultado aparece sobre numerosas páginas y provoca actualizadas de esconde en cascada. Pueden ser utilizados para insertar :
Para insertar un modelo, hace falta efectuar una llamada por dobles accolades que siguen la syntaxe : {{Nombre del modelo}}.
Por ejemplo, cogiendo {{Gracias}}, el contenido del Modelo:Gracias es anunciado sobre una página : «
Gracias ». Las modificaciones de Modelo:Gracias se aplican sobre las diversas páginas donde es insertado el modelo.
Los modelos, como todos los artículos de Wikipedia, son indiferentes a la rompe únicamente para su carta inicial : {{Nombre del modelo}} es equivalente a nombre {{del modelo}} pero no a NOMBRE {{DEL MODELO}} .
Los modelos son reagrupados en un espacio de nombres « Modelo: » (en aquí está una lista alfabética).
Ciertos modelos (como por ejemplo {{Artículo detallado}}) tienen necesidad de parámetros para adaptar su comportamiento. Estos parámetros, obligatorios o facultativos, son separados por barras verticales (| : combinación Alt Gr + 6) y son renseignés las unos como consecuencia de los demás : {{Nombre del modelo | <Parámetro 1> | <Parámetro 2>…}}.
Los parámetros pueden estar parámetros nombrados ; son entonces renseignés por una pareja parámetro=valor de este modo : {{Caja| título = <título querido> | color = <color escogido> }}.
Para más detalles sobre los parámetros, postponerse en el capítulo Modelos en parámetros.
La sustitución permite reemplazar la llamada en el modelo {{Nombre del modelo}} por el código del modelo (es decir el patrón del modelo). Se efectúa por la syntaxe {{subst:Nombre del modelo}}. No es generalmente pas necesario de sustituir un modelo porque, si el modelo de origen es modificado, las sustituciones no lo son . La sustitución no ha vocación a ser utilizada en los artículos. A anotar que no hay ninguna norma sobre el uso del subst: y que su utilización debe pues ser reflexionada.
Un modelo que contiene un vínculo temporal o susceptible de cambiar debería ser añadido por {{subst:Nombre del modelo}}. Un ejemplo de utilización de la sustitución es durante la ajout de Bienvenida {{nuevo}} sobre la página de discusión de un nuevo usuario ; este último podrá entonces, que modifica su página, tomar plenamente conciencia de la syntaxe utilizada sobre el sitio.
Las paletas de navegaciones son de las tableaux que desarrollan que se ubican abajo de un artículo.
Los infobox están de los tableaux que se ubican arriba en derecha de un artículo.
Ciertos modelos permiten tener la fecha, la hora, etc.
Para encontrar rápidamente un modelo existente, por ejemplo : {{clr}}, dactylographiez « Modelo:nombre del modelo » sin las balizas {{ }} (ejemplo : « Modelo:clr ») en la cabaña de investigación, en columna de izquierda.
Antes de crear un nuevo modelo, hace falta asegurarse que un modelo equivalen no existe bajo un título diferente. El método de creación de un modelo es similar a aquella de la creación de una página.
El nombre de la nueva página tiene que comenzar por « Modelo: » (Modelo:<Nombre del modelo>) y puede contener espacios.
El plus mero es de insertar una llamada en el modelo en una página, después de cliquer sobre el vínculo que aparecerá rojo ; la llamada se efectúa pegando el código {{Nombre del modelo}}. El código del modelo puede ser creado por modificación de uno copiar-pegar de un modelo existente.
Los modelos pueden tomar argumentos (o parámetros ; postponerse en el capítulo Modelos en parámetros).
Un modelo puede inclure uno o varios demás modelos, pero no puede ser le-mismo parámetro de otro modelo. Los redirections entre modelos funcionan.
NB : Todo cambio de un modelo borra automáticamente lo esconde todas las páginas que utilizan este modelo.
Un modelo es una herramienta comunitaria destinado a todos los que desean utilizarlo (no es reservado en su autor). Es pues imperativo de hacer una documentación que explica : a qué necesidad el modelo responde, en qué casos es adaptado/inadapté, este que hace y cómo tiene que ser utilizado.
Postponerse en el capítulo Cómo documentar un modelo ? Que explica cómo proceder.
Devolverse sobre el Proyecto:Modelo
Si tenéis necesidad de la ayuda de usuarios expérimentés para fabricar un nuevo modelo, podéis depositar un encargo sobre la página Proyecto:Modelo/Demandas.
Un modelo puede ser escrito con el fin de aceptar parámetros (o argumentos ). Eso permite crear textos estandarizados, de los tableaux prado-formateado cuyo solas ciertos valores cambian. Son escritas en la manda hecha en la página que invoca el modelo.
En su llamada, los parámetros siguen el nombre del modelo y son aislados por de los séparateurs « | » (el último es seguido en su derecha de « }} ») : {{Nombre del modelo|<parámetro1>|<parámetro2>…}}. En la página del Modelo:, son designados por una triple accolade : {{{parámetro 1}}}.
Tomemos por ejemplo la página ficticia [[Modelo:Modelo de cosa]] que contendría :
El {{{objeto}}}''' es {{{un tipo}}}.
Si efectuáis la llamada :
{{Modelo de cosa
| objeto = manzana
| caracteriza = fruta
}}
Entonces los parámetros serán « reemplazados por su valor (el valor manzana será atribuida en el parámetro objeto) y el modelo anunciará :
La manzana es una fruta.
No tiene que tener de regreso a la línea en un valor, pero <br /> es permitido. Un valor tal vez un vínculo externo o interno. Se remarcará que la syntaxe habitual de los vínculos wiki es posible (es decir [[página apuntada|texto que aparecerá]]).
Con el fin de mejorar la lisibilité durante la edición, de los regresos en la línea pueden aparecer en el modelo, al modo de los tableaux. Idéalement, Como se lo constata aquí-elevado, puede tener un regreso en la línea antes cada salvo el premier.
Por defecto, los parámetros son designados en el código del modelo por su número ordinal, son numérotés a marchar de 1 en el orden de aparición en la secuencia de llamada que comporta todos los parámetros. (Esta continuación no es obligatoriamente completa al uso del modelo que puede comportar parámetros facultativos). Cada elemento parámetro en el código del modelo corresponde en el rango (posición) del valor esperado durante el trabajo del modelo : el parámetro 3, expresado por el código {{{3}}}, hace referencia a la tercer valor en parámetro utilizado por el modelo.
Por ejemplo, el modelo {{Anuncio}} utiliza un parámetro 1 y un parámetro 6 de este modo : [[Imagen:{{{1}}}|20px|{{{6}}}]] que se interpreta « anunciar la imagen de nombre "valor del 1er parámetro", en un tamaño de 20 pixels, con como nombre de affichage "el valor del 6e parámetro" ».
Sin nombre explícito para el parámetro, una ayuda es seguramente necesaria para facilitar la utilización del modelo por otros usuarios.
En la syntaxe de las modelos, un canal del tipo {{MonModèle|aaa=bbb}} es interpretada como una llamada al modelo « MonModèle » dando al parámetro explícito « aaa » el valor « bbb ».
Ahora bien puede llegar que el usuario haya de hecho la intención de pasar de los valores género « aaa=bbb » a parámetros del modelo. Es sobre todo el caso cuando el valor es una URL que ella-misma comporta parámetros.
Los parámetros implicites lo permiten designándolos en la llamada (para todos los parámetros transmitido) por su nombre-número de orden seguido de « = » . (Conviene de constituir una secuencia de llamada donde están en las primeras posiciones porque todos los que los preceden en el orden de llamada tienen que ser designados explicitement por su nombre-número, en detrimento de la activación de su valor por defecto » de parámetro codifiable en el modelo).
Ejemplo : {{MonModèle|1=aaa=bbb}}. En esta syntaxe, el valor « aaa=bbb » será atribuida en el primer parámetro del modelo.
El uso de modelos complejos puede ser facilitado por parámetros nombrados ; esta práctica es recomendada también para facilitar el control por robots.
Para nombrar un parámetro, basta de utilizar un nombre representativo de su rol en lugar de los nombres por defecto (1, 2, 3 …) precisando una pareja parámetro=valor. Por ejemplo, renommant {{{3}}} por {{{Avancement}}} en el código [[Imagen:{{#switch:{{{Avancement}}}|0=00|1=25|2=50|3=75|4=100}}%.svg]] (Si los valores 0 a 100 expresen las gradas de avancement de una operación). Lo que daría la llamada : {{Nombre del modelo|Avancement=25}}.
Una discordance entre el nombre del parámetro dado y el nombre dado en el modelo genera un error. Se puede anotar que se puede llamar los parámetros nombrados en cualquier orden.
Si un parámetro definido en el código del modelo no es transmitido en la llamada, el valor restituido es « le-mismo » (el código {{{1}}} será « reemplazado » por el texto {{{1}}}).
El concepteur puede definir un valor por defecto que será utilizada en este caso, que sigue la syntaxe : {{{<parámetro>|123}}} en el modelo (es decir, « se no hay de parámetro transmitido en la llamada, se utiliza el valor "123" al lugar »). Un tal parámetro es dicho entonces facultativo.
Es posible de no escribir nada para el valor por defecto (valor vacío / NULL) en no que escribe nada ( incluso un espacio) después de la barra vertical : {{{<parámetro>|}}}.
Es posible de evitar la respuesta del valor por defecto durante la llamada al modelo : en no que escribe nada ( incluso un espacio) después de la barra vertical de posición se se trata de un parámetro implicite (positionnel), o bien nada después de que lo sigue el nombre se él sagit de un parámetro explícito nombrado. Ejemplo ( modelos con un parámetro) : {{Monmodèle|}} o Monmodèle|monparamètre= {{}}.
imbriquant los parámetros {{{parámetro1|{{{parámetro2|...}}} }}}, Un modelo puede establecer una secuencia de selección mera de prioridad mera de los valores por su codage de los parámetros. Estos valores son proporcionadas desde la página la llamada.
Por ejemplo , el modelo ficticio Monmenu comporta la imbricación
{{{queso|{{{postre|ni queso ni postre}}} }}} :
{{monmenu|queso=camembert}} tendrá para texto restituido « camembert », (al igual que {{monmenu|queso=camembert|fruta=manzana}}).
{{monmenu|fruta=manzana}} tendrá}} para texto restituido « manzana ».
{{monmenu}} tendrá para texto restituido « ni queso ni postre ».
{{}} al lugar de « | » en los valores de parámetros Si un parámetro contiene en su propio texto, es posible a veces de utilizar el modelo {{!}} Para reemplazarlo, con el fin de evitar la confusión con el séparateur de parámetro. (Ver para el ejemplo su uso durante la llamada al modelo {{nobr}} puesto en el código de esta documentación al capítulo Modelos en parámetros ).
Esto están balizas XML que permiten seleccionar una parte del código fuente de una página.
<noinclude>...</noinclude> Es útil de poder ubicar ciertos elementos del código fuente del modelo, como los vínculos interlangues, la catégorisation o la documentación del modelo, sin que estos elementos no aparecen sobre la página donde el modelo es insertado. Para eso, se ubica los elementos a excluir entre las balizas <noinclude> y /noinclude <>.
Es recomendado, cuando se ubica una secuencia <noinclude>…</noinclude>, de no hacer preceder o seguir la secuencia de NINGÚN salto de línea o espacio adicional porque serían conservados en la inclusión del modelo y podrían perjudicar en la presentación de su contenido. En cambio, se puede poner blancos y saltos de líneas a voluntad adentro para mejorar la lisibilité. Por ejemplo, un Modelo:Ejemplo que contiene :
''(Contenido ''{{{1|}}}'' a completar…)''
Y que anuncia esto en el artículo que el inclut :
(Contenido a completar…)
Puede ser completado de una categoría y de un vínculo interwiki destinados a su propia clasificación, pero no destinados a los artículos que incluent este modelo :
''(Contenido ''{{{1|}}}'' a completar…)''<noinclude>
[[Categoría:Espacio Modelo]]
[[Categoría:Ejemplo]]
[[:Template:Sample]]
</noinclude>
Anotad aquí-encima la ausencia de todo salto de línea entre el contenido y el comienzo de la sección <noinclude>.
Así :
<noinclude> y /noinclude <> no trataban .
{{Ejemplo}}, solo la línea « ''(contenido ''{{{1|}}}'' a completar…)'' » será utilizada (lo que está fuera de los <noinclude>…</noinclude>) sin los interwikis, ni las categorías.
<includeonly>...</includeonly> Los elementos que se quiere ver aparecer en inserción, pero que se quiere ver desaparecer durante la visualización del modelo solo son ubicados entre las balizas <includeonly> y /includeonly <>.
Es recomendado de dejar al menos un salto de línea o espacio entre el último signo « = » de una línea de título y una baliza <includeonly>.
Por ejemplo, él puede ser a veces necesario de mostrar varios ejemplos de un modelo le-mismo, proporcionando de los parámetros diferentes. En este caso, el código del modelo será ubicado preferiblemente en cabeza pero escondido en la página de descripción :
<includeonly>''(Contenido ''{{{1|}}'' a completar…)''</includeonly><noinclude>
{{Documentación modelo}}
;Utilización: Este modelo no es que un ejemplo a completar. Ningún parámetro obligatorio no es aquí necesario en un artículo.
;Syntaxe : <Código>{{Ejemplo|1}}</código>
:* <código>1</código> : permite añadir del texto en medio del contenido anunciado por este modelo (facultativo, virgen por defecto).
;Ejemplo : « <código>{{Ejemplo|de esta sección}}</código> » da <!--
-->« ''(Contenido ''de esta sección'' a completar…)'' »
;Ver también :
:* [[Ayuda:Modelo]]
[[Categoría:Ejemplo]]
[[:Template:Sample]]
</noinclude>
Anotad aquí-encima la récursion del modelo : es posible, durante la edición de un modelo ya existente, que haga falta publicarlo dos vez para que la auto-inclusión en su página de descripción sea tomado en cuenta.
Anotad igualmente cómo son dispuestos las balizas </includeonly><noinclude>, sin ningún salto de línea intermediaria que caería surplus y que arriesgaría de interrumpir una lista a numérotation automática o provocaría una ruptura de párrafo indeseable o de los saltos blancos verticales.
La utilización del balizaje <includeonly>…</includeonly> debe pues quedar excepcional y tiene que ser utilizado con precaución. La colocación de un título en una sección <includeonly> puede desorganizar la numérotation del sumario y de los vínculos « modificar » que aparecen en derecha de los títulos de sección.
Durante una inserción por sustitución (con la syntaxe especial {{subst:<modelo>}}) las balizas <noinclude>…</noinclude> y su contenido no son reproducidas.
Los parser functions están modelos « analyseurs » ( ingleses : parser) que permiten efectuar ciertas funciones paramétrables. Los más corrientes son los branchements conditionnels #if y #switch .
Un ejemplo donde los valores posibles de un parámetro son enumera limitadas y conocidas : si el usuario da el valor 4 al 3e parámetro del modelo que contiene el código siguiente [[Imagen:{{#switch:{{{3}}}|0=00|1=25|2=50|3=75|4=100}}%.svg]], La imagen anunciada será el icono Imagen:100%.svg, Sea Fichero:100%.svg.
Para más de detalles, ver sobre el sitio de MediaWiki : Parser Functions
Para crear un modelo no encyclopédique (destinado a ser llamado por una página usuario o para hacer tests), ninguna necesidad de « polluer » el espacio de los modelos. Eso puede hacerse sobre una bajo-página usuario de manera todo a hecho similar.
Por ejemplo, si Usuario:Quidam quiere testar un modelo llamado « Artículo fastidieux », procede como sigue :
<div Estilo="bordear:1px solid black; background:rgb(80%,100%,80%); text-align:center; padding=0.4ex;">
''Esto es un artículo fastidieux. La tasa de aburrimiento es estimado en {{{aburrimiento}}} %.''</div>
{{Usuario:Quidam/Artículo fastidieux|aburrimiento=55}}
Lo que da :
De un modo general, la syntaxe de llamada de un modelo
{{<espacio de nombres>:<nombre de página>|<parámetro1>=valor1 …}}
reconoce la presencia del espacio de nombres que, aquí, no toma el valor por defecto Modelo:. Los parámetros pueden también ser nombrados explicitement, o implicitement.
subst: imbriqué « Publicar ») una sustitución en la página que llama el modelo usuario,( y sólo en esta página), hace falta « romper » el mecanismo clásico de sustitución del código puesto en el espacio propio al modelo usuario con un <includeonly> </includeonly>. Por ejemplo, para que la operación sea la ajout una vez para todas del mes en curso escrito en todas cartas en la página que llama con {{subst:MonModèle}}, hace falta poner en el modelo uno : {{<includeonly>subst:</includeonly>CURRENTMONTHNAME}} que no modificará el código propio del modelo al valor del corriente a su salvaguarda, pero pondrá el mes en la página de llamada.
La documentación de una modelo puede ser hecha :
<noinclude>…</noinclude>. Postponerse en el capítulo Cómo documentar debajo del modelo ?.
/Documentación : falla entonces ubicar {{Documentación modelo bajo-página}}, u otro, en la bajo-página, entre los hitos <noinclude>…</noinclude>. Postponerse en el capítulo Cómo documentar en la bajo-página del modelo ?.
Fijando {{Doc modelo}} en un modelo a documentar, seréis asistidos en la creación de su bajo-página de documentación.
Hace falta documentar bajo-página en los casos siguientes :
<noinclude>…</noinclude> y sobre todo, no inclure la documentación).
Para documentar un modelo ya existente, copiáis-pegad y adaptáis el uno de los códigos aquí-debajo al finalizar la fuente de un modelo (es decir justo antes su último salto de línea que existe, y sin ningún otro salto de línea inútil añadida después de).
Para un pequeño modelo, sin parámetros nombrados, « sobre una línea » :
<noinclude>{{Documentación modelo}}
== Utilización ==
<!--Indicad cuándo utilizar este modelo-->.
== Syntaxe ==
<Código><nowiki>{{</nowiki>{{PAGENAME}}|1|2|etc.}}</Código>
* <código>1</código> : descripción1 (obligatoria).
* <Código>2</código> : descripción2 (facultativo, ''defecto2'' por defecto).
* Etc.
== Ejemplo ==
« <código><nowiki>{{</nowiki>{{PAGENAME}}|<!-- a completar -->}}</código> » da <!--
-->« {{{{PAGENAME}}|<!-- a completar al idéntico -->}} »<!--Para un modelo mero (sobre una línea) -->
== Variante ==
* {{M|<!--Nombre de modelo connexe-->}}
== Ver también ==
* [[<!--Nombre de página a ver-->]]
[[Categoría:Nombre de la categoría del modelo|{{PAGENAME}}]]
[[de:Template:Nombre del modelo germanophone equivalente]]
</noinclude>
Para un modelo más complejo, con parámetros nombrados :
<noinclude>{{Documentación modelo}}
== Utilización ==
<!--Indicad cuándo utilizar este modelo-->.
== Syntaxe ==
<nowiki>{{</nowiki>{{PAGENAME}}
|Parámetro1=valor1
|parámetro2=valor2
|parámetro3=valor3
|etc.
}}
== Parámetros ==
* <código>parámetro1</código> : descripción1 (obligatoria).
* <Código>parámetro2</código> : descripción2 (facultativo, ''defecto2'' por defecto).
* <Código>parámetro3</código> : descripción3 (opcional, cuando <código>parámetro2</código> es proporcionado, ''defecto3'' por defecto).
* Etc.
== Ejemplo ==
{{Entête cuadro "Código Devuelto"}}
|-
|<pre><!-- El mismo código --></pre>
|<!-- El mismo código -->
|}
== Variante ==
* {{M|<!--Nombre de modelo connexe-->}}
== Ver también ==
* [[<!--Nombre de página a ver-->]]
[[Categoría:Nombre de la categoría del modelo|{{PAGENAME}}]]
[[:Template:Nombre del modelo anglophone equivalente]]
</noinclude>
Para disponer de un formulario de documentación préchargé durante la creación de un nuevo modelo, ponéis el nombre de modelo de vuestra elección en la caja siguiente y cliquez sobre el botón « Crear el modelo » :
Copiar-pegar y adaptáis el código aquí-debajo directamente bajo la fuente del modelo :
<noinclude>
{{/Documentación}}<!-- Métadonnées (Categorías, interwikis, …) bajo-página de documentación -->
</noinclude>
Después cliquez sobre el vínculo rojo para editar la página. La documentación permanece globalmente parecida.
{{Documentación modelo bajo-página}}
== Utilización ==
<!--Indicad cuándo utilizar este modelo-->.
== Syntaxe ==
<Código><nowiki>{{</nowiki>{{PAGENAME}}|1|2|etc.}}</Código>
* <código>1</código> : descripción1 (obligatoria).
* <Código>2</código> : descripción2 (facultativo, ''defecto2'' por defecto).
* Etc.
== Ejemplo ==
« <código><nowiki>{{</nowiki>{{PAGENAME}}|<!-- a completar -->}}</código> » da <!--
-->« {{ {{PAGENAME}}|<!-- a completar al idéntico -->}} »<!--Para un modelo mero (sobre una línea) -->
== Variante ==
* {{M|<!--Nombre de modelo connexe-->}}
== Ver también ==
* [[<!--Nombre de página a ver-->]]
<includeonly>
<!-- Categorías e interwikis del modelo -->
[[Categoría:Nombre de la categoría del modelo|{{PAGENAME}}]]
[[it:Template:Nombre del modelo italophone equivalente]]
</includeonly>
{{Documentación modelo complicado bajo-página}}
== Utilización ==
<!--Indicad cuándo utilizar este modelo-->.
== Syntaxe ==
<nowiki>{{</nowiki><!-- Nombre del modelo -->
|parámetro1={{Param|valor1}}
|parámetro2={{Param|valor2}}
|parámetro3={{Param|valor3}}
|etc.
}}
== Parámetros ==
* <código>parámetro1</código> : descripción1 (obligatoria).
* <Código>parámetro2</código> : descripción2 (facultativo, ''defecto2'' por defecto).
* <Código>parámetro3</código> : descripción3 (opcional, cuando <código>parámetro2</código> es proporcionado, ''defecto3'' por defecto).
* Etc.
== Ejemplo ==
{{Entête cuadro "Código Devuelto"}}
|-
|<pre><!-- El mismo código --></pre>
|<!-- El mismo código -->
|}
== Variante ==
* {{M|<!--Nombre de modelo connexe-->}}
== Ver también ==
* [[<!--Nombre de página a ver-->]]
<includeonly>
<!-- Categorías e interwikis del modelo -->
[[Categoría:Nombre de la categoría del modelo|{{PAGENAME}}]]
[[estás:Template:Nombre del modelo hispanophone equivalente]]
</includeonly>
Sobre la página del modelo, antes modificación, se puede cliquer sobre el hyperlien « Páginas relacionadas » del menú de izquierda para consultar las páginas que utilizan el modelo y verificar que no serán perturbadas.
Los nombres de modelos que utilizan palabras abreviadas o pegadas son difíciles a retener porque ninguna convención no se ha impuesto. No hay de razón técnica para no inspirarse de las convenciones sobre los títulos también en los nombres de modelo.
En un modelo, de los vínculos de tipo externo que lleva a páginas internas son utilizados a veces con el fin de evitar que se desemboque sobre la página en moda de edición aunque esta página existe.
Si el modelo contiene un vínculo interlangue, entonces este vínculo es inclusive en todas las páginas que utilizan el modelo, lo que no es generalmente no el resultado querido. Si dos vínculos interlangue hacia una misma otra lengua se encuentran en una página, el resultado es imprevisible. Se evitará estos conflictos utilizando las balizas de inclusión selectiva.
Si el modelo pertenece en una categoría (es decir que la página del modelo contiene un redactado de la forma [[Categoría:Nombre de una categoría]]) y si se no hace simultáneamente uso de la baliza de inclusión selectiva <noinclude>, todos los artículos que contienen el modelo pertenecerán en esta categoría. Se puede utilizar esta astucia, por ejemplo, para obtener la lista de todos los artículos ébauche de una propiedad dada. Falla sin embargo una actualizada del esconde de cada página.
Para rafraîchir (« forzar la actualizada ») una página quedada inchangée mientras que las modelos que contiene han sido modificados, falla :
'acción=edit' por 'acción=purge'.