Diferencia entre revisiones de «Ayuda:Plantillas»

Contenido eliminado Contenido añadido
cat.
Edgefield (discusión | contribs.)
Puesta al día general
Línea 1:
{{encabezado proyecto|izq=← [[Ayuda:Mapa de ayuda|Mapa de ayuda]]|tít=Ayuda de nivel intermedio|der=[[Wikcionario:Plantillas|Lista de plantillas]] →}}
Las '''plantillas''' son textos, bloques, cuadros de información que pueden ser utilizados desde muchos artículos distintos. No solamente con un contenido fijo, sino que pueden ser personalizados con la información adecuada a cada artículo. De estas plantillas se trata aquí.
Lo primero que encuentras en la [[Wikcionario:Cómo se edita una página#Caja de edición|caja de edición]] de una entrada (normal) de Wikcionario es una enigmática serie de líneas encerradas en llaves dobles (<code><nowiki>{{ }}</nowiki></code>). Estas llaves le indican al lenguaje [[wiki]] que emplee una de las dinámicas '''plantillas''', páginas diseñadas para sustituir automáticamente ciertos textos a partir de cierto código. Las plantillas se usan mucho en Wikcionario para dar '''[[Wikcionario:Estructura|estructura]]''' coherente a cada entrada y clasificarla automáticamente en '''[[Ayuda:Categorías|Categorías]]''' que permiten toda clase de útiles listados.
 
<div style="float:right; width:75%">
Anteriormente a la versión 1.3 de [[w:MediaWiki|MediaWiki]] algunos de estos mensajes estaban en el [[Wikinoticias:Espacio de nombres de MediaWiki|espacio de nombres de MediaWiki]], ahora están en el espacio ''Plantilla:''. [[meta:Help:Template|Aquí]] hallarás más información (en inglés) acerca del [[Wikinoticias:espacio de nombres|espacio de nombres]] de mensajes parametrizables (plantillas o ''templates'') de MediaWiki.
Por ejemplo, cada página del idioma español debe comenzar con la plantilla <nowiki>{{ES}}</nowiki>, que incluye la entrada en [[:Categoría:Español]] y crea este encabezado:
<div class="toccolours" style="background:#f9f9f9;padding-bottom:1em;">
<div style="color:black;background:none;font-weight:bold;margin:0;padding-top:.5em;padding-bottom:.17em;border-bottom:1px solid #aaa;width:auto;font-size:180%;">[[Wikcionario:Referencia/ES|Español]]</div></div>
 
El título del [[lema]], la pronunciación, la etimología, el tipo de palabra (sustantivo, prefijo, etc.), la [[flexión]] (femenino, plural, etc.), la [[conjugación]] verbal, y muchas otras secciones, siempre se crean con plantillas en Wikcionario. Modificar correctamente estas secciones parece algo complejo inicialmente, pero con un poco de experiencia descubrirás que las plantillas ayudan mucho a simplificar y agilizar la creación de entradas. Esta página contribuye a que te familiarices con ellas y puedas ubicar dónde se encuentran.
== Instrucciones ==
</div>
 
==Qué son==
Para crear un mensaje personalizado nuevo sólo tienes que crear una página en el espacio de nombres Plantilla llamándola "Plantilla:" y el nombre del mensaje. Por ejemplo, <nowiki>Plantilla:Argentina</nowiki>. Se pueden usar los mismos caracteres que para crear páginas normales, incluyendo espacios y caracteres con diacríticos. No hay unas convenciones de títulos por el momento, pero se suele primar la brevedad sobre la claridad.
 
Una '''plantilla''' es un tipo especial de página destinada a utilizarse dentro de otras para insertar determinada información. Su nombre siempre comienza con el prefijo '''Plantilla:''' (este tipo de prefijo se llama [[w:Ayuda:espacio de nombres|espacio de nombres]]), por ejemplo la [[Plantilla:pronunciación]].
Si creas un mensaje personalizado, añádelo a esta página, manteniendo el orden alfabético.
 
Las plantillas no solamente permiten repetir un contenido fijo en muchas páginas distintas, sino que además pueden adecuarse a la información pertinente a cada entrada por medio de [[w:Ayuda:Plantillas#Parámetros|parámetros o argumentos]]. Siguiendo con nuestro ejemplo, la plantilla {{Ep|pronunciación}}, se emplea para transcribir cómo se pronuncia cada entrada de Wikcionario. Así, cuando se hace click sobre la pestaña <span style="color: #0022BB;border: 1px solid #AAAAAA; background-color: #F9F9F9; padding-left: 10px;padding-right:10px;font-size:90%;text-weight: none; text-decoration: none; font-style:normal;">Editar</span> de la entrada ''[{{SERVER}}{{localurl:hoja|action=edit}} hoja]'' se puede ver:
Para usar el mensaje en una página hay que enlazarlo utilizando dos pares de llaves (''curly bracket'') entre el nombre.
 
<pre>{{pronunciación|[ ˈo.xa ]}}
Básicamente hay dos formas de usar los mensajes personalizados en un artículo: la [[Ayuda:sustitución|sustitución]] y [[Ayuda:transclusión|transclusión]].
↑ ↑
plantilla | raya vertical que introduce el uso de un parámetro
</pre>
 
que se visualiza como:
{{VT|Ayuda:Sustitución|Ayuda:Transclusión}}
{{pronunciación|[ˈ o.xa ]}}
 
==Cómo se incluyen==
{| class="wikitable" border=1 cellspacing=0 cellpadding=2
!Comando || Efecto
|-------
|<nowiki>{{subst:mensaje}}</nowiki>
|La '''sustitución''' copia el texto del mensaje donde escribiste el identificador, justo después de guardar el artículo.
|---------
|(<nowiki>{{mensaje}}</nowiki> o <nowiki>{{msg:mensaje}}</nowiki> (el uso de <tt>msg:</tt> está considerado obsoleto desde la versión 1.3)
|La '''transclusión''' carga el mensaje y lo pone en la página cada vez que ésta se carga.
|}
 
Para incluir<ref>Hay dos formas básicas de inclusión de plantillas: la [[w:Ayuda:Plantillas#Sustitución|sustitución]] y la [[w:Ayuda:Plantillas#Transclución|transclusión]]. Haz click sobre estas dos palabras para ver su explicación en la ayuda de Wikipedia.</ref> el contenido de una plantilla en una página (procedimiento también llamado transclusión), se escribe el nombre de la plantilla entre llaves dobles, de esta manera:
En otras palabras, si alguien actualiza el texto del mensaje y se ha utilizado transclusión, no habrá necesidad de actualizar la página en que se ha incluido. Los mensajes breves y temporales, que se eliminarán pronto, deberían copiarse utilizando subst (que tiene la ventaja de que muestra el texto del mensaje en el código fuente wiki), y los avisos estándares que puede que permanezcan en la página durante meses o para siempre, deberían ''transcluirse'' para facilitar su actualización (la transclusión no debería utilizarse si el mensaje contiene enlaces que pueden cambiar en el futuro. Este método no actualiza ''"Lo que enlaza aquí"'' a menos que ''todos'' los artículos que contengan el mensaje se cambien tras la modificación del enlace del mensaje).
:<code><nowiki>{{pronunciación}}</nowiki></code>
 
Cuando se grabe la página (o se muestre la previsualización), aparecerá el contenido de la plantilla {{Ep|pronunciación}}. Esta específicamente está diseñada para que, cuando no se le escribe ningún parámetro, automáticamente produzca un texto indicando que falta esa información:
=== Plantillas con parámetros ===
{{pronunciación}}
 
La introducción de cada parámetro se marca con la raya vertical ( | ), y en nuestro ejemplo se usa para ingresar luego la [[Wikcionario:Pronunciación|transcripción fonética]] entre corchetes:
El contenido de las plantillas acepta toda la sintaxis wiki (ver [[Wikcionario:Cómo se edita una página]]).
:<code><nowiki>{{pronunciación|[ ˈo.xa ]}}</nowiki></code>
 
En general, para insertar la plantilla con argumentos se emplea una de las sintaxis siguientes (dependiendo de la definición de la plantilla):
Desde la versión 1.3 de MediaWiki estos mensajes pueden tomar parámetros, por eso se llaman plantillas (''templates''). Con estos parámetros se puede conseguir que el mismo mensaje tenga textos variables en función de los valores que toman los parámetros al transcluirlos.
# <nowiki>{{nombre de plantilla|parámetro=texto|parámetro2=texto2}}</nowiki> si los parámetros se han definido con un nombre
# <nowiki>{{nombre de plantilla|texto|texto2}}</nowiki> si los parámetros se han definido con un número (sin nombre)<ref>Se puede ver otro ejemplo con números en [[Plantilla:Wikcionario]].</ref>
 
Por ejemplo, la [[Plantilla:pronunciación]] tiene un parámetro numerado como <nowiki>{{{1}}}</nowiki> que es reemplazado por lo que pongamos sin ningún nombre después de la raya vertical: <code><nowiki>{{pronunciación|[ˈo.xa]}}</nowiki></code>. Pero esa misma plantilla contiene otro parámetro con el nombre "s", de modo que si escribimos <nowiki>{{pronunciación|-|s=ˈka.sa}}</nowiki></code>, obtendremos:
Para definir los parámetros en una plantilla lo único que tienes que hacer es usar la etiqueta <nowiki>{{{n}}}</nowiki>, donde n es un número o un identificador de texto, allá donde quieras poner un texto variable. Recuerda que los parámetros en la plantilla llevan tres llaves en vez de dos.
{{pronunciación|-|s=ˈka.sa}} (la plantilla está programada para generar este texto cuando se incluye el parámetro "s=")
 
{| style="width:80%; margin-left:100px; font-size:90%; border:1px dotted turquoise"
Para usar la plantilla con argumentos se usa una de las sintaxis siguientes (dependiendo de la definición de la plantilla):
|'''Nota:''' Para incluir una página que no tenga el prefijo «Plantilla», por ejemplo para realizar pruebas, se escribe «<code>:</code>» antes del nombre del archivo, si este no tiene prefijo, o el nombre completo del archivo con su prefijo o espacio de nombres, así: <br /><code><nowiki>&#123;{:Artículo ejemplo}}</nowiki></code>&nbsp; → esto incluirá el contenido de «Artículo ejemplo» en la página donde se inserte.<br /><code><nowiki>&#123;{Usuario:Ejemplo/plantilla que creé}}</nowiki></code> &nbsp; → esto incluirá el contenido de la página "Usuario:Ejemplo/plantilla que creé".
|}
===Cómo enlazar a una===
Para mostrar el nombre de una plantilla y enlazar a ella se utiliza la plantilla '''{{Ep|Ep}}'''.
 
Por ejemplo, <code><nowiki>{{Ep|Pronunciación}}</nowiki></code>, se muestra como: {{Ep|Pronunciación}}
# <nowiki>{{nombre de plantilla|parámetro=texto|parámetro2=texto2}}</nowiki> si los parámetros se han definido con un nombre, es decir, ''n'' es un texto alfanumérico.
 
==Dónde encontrarlas==
# <nowiki>{{nombre de plantilla|texto|texto2}}</nowiki> si los parámetros se han definido con un número, es decir, ''n'' es un número en el ejemplo anterior.
Como se dijo arriba, las plantillas son muy usadas en Wikcionario para dar [[Wikcionario:Estructura|estructura]] coherente a cada entrada y [[Ayuda:Categorías|categorizarla]] automáticamente.
Puedes verlas en acción pulsando la pestaña <span style="color: #0022BB;border: 1px solid #AAAAAA; background-color: #F9F9F9; padding-left: 10px;padding-right:10px;font-size:90%;text-weight: none; text-decoration: none; font-style:normal;">Editar</span> de cualquier entrada.
 
* La mayor parte de las plantillas utilizadas normalmente están (y deben estar) categorizadas en '''[[:Categoría:Wikcionario:Plantillas]]'''
Se puede ver un ejemplo con números en [[Plantilla:Wikcionario]] y un ejemplo de uso. Además verás que las plantillas sirven para escribir otras plantillas. ¡Adiós al copiar-pegar!
* Las que se usan para estructurar cada página se indican en '''[[Wikcionario:Estructura]]''' (como etimología, pronunciación, sinónimos, campo semántico, etc)
* Las plantillas para los tipos de palabra se listan en '''[[:Categoría:Plantillas de sección]]''' (como sustantivo, locución, etc)
* Las que dan formato a diferentes partes de una entrada se listan en '''[[:Categoría:Wikcionario:Plantillas de formato de contenido]]''' (como la lista de sinónimos, de términos relacionados, de grafías alternativas, etc.)
* Las que crean los cuadros de conjugaciones y flexiones (femenino, plural, etc.), se listan en '''[[:Categoría:Plantillas de flexión]]'''
* Las que se usan para indicar el contexto de uso de una acepción (zona geográfica o ámbito, campo o área del saber en que se emplea, etc.), están en '''[[:Categoría:Wikcionario:Plantillas de registro lingüístico]]'''
* Las que indican el campo de una definición ("en Deportes", "en Matemáticas", etc.), que también categorizan automáticamente la entrada en esos campos, se listan en '''[[:Categoría:Wikcionario:Plantillas de categorización de categorías]]''' y/o en '''[[:Categoría:Plantillas de campo semántico]]'''
* Las que se emplean para dar formato a las citas se listan en '''[[:Categoría:Wikcionario:Plantillas de referencia]]'''
* Las que se emplean para indicar que una entrada necesita editarse, está incompleta o debe borrarse, se listan en '''[[:Categoría:Wikcionario:Plantillas de mantenimiento]]'''
* Las que se emplean para crear columnas se listan en '''[[:Categoría:Wikcionario:Plantillas de traducción]]''' y '''[[:Categoría:Plantillas de columna]]'''
* O puedes '''[{{fullurl:Especial:Allpages|from=&namespace=10}} verlas todas por orden alfabético]''' (aunque muchas no se usan o se emplean solamente como base para otras plantillas)
 
==Uso==
== Para buscar plantillas ==
Muchas de las plantillas tienen sus propias instrucciones de uso ("Documentación de plantilla"), listadas en '''[[:Categoría:Wikcionario:Indicaciones para el uso de plantillas]]'''.
Las más comunes en cualquier entrada son:
*{{Ep|etimología}}
*{{Ep|pronunciación}}
*{{Ep|sección}} (para los nombres de tipos de palabras)
*Plantillas de flexión: véase la documentación de cada una en [[:Categoría:Plantillas de flexión]] <!--(por crear: [[Ayuda:Plantillas de flexión]])-->
*{{Ep|ámbito}} (para indicar la zona geográfica donde se emplea una palabra o acepción)
*Plantillas de [[:Categoría:Plantillas de campo semántico|campo semántico]]: véase la documentación de '''[[Plantilla:Diseño]]''' (todas se usan igual)
 
==Creación==
* [{{fullurl:Especial:Allpages|from=&namespace=10 Por orden alfabético]
Te recomendamos que no intentes crear plantillas antes de tener bastante experiencia editando en Wikcionario, ya que podrías duplicar plantillas ya existentes o fallar con la sintaxis, produciendo fallos en un grupo grande de entradas, lo que llevaría mucho tiempo corregir. Salvo casos excepcionales, es mejor crear solamente plantillas que sepas que podrán usarse en muchas entradas y que no resulten redundantes.
* [[:Categoría:Wikcionario:Plantillas|Por orden temático]]:
** [[:Categoría:Wikcionario:Plantillas de navegación|De navegación]]
** [[:Categoría:Wikcionario:Plantillas de mantenimiento|De mantenimiento]]
** [[:Categoría:Wikcionario:Plantillas de licencias|De licencias, procedencias y autorizaciones]]
 
Para crear una página que funcione como plantilla, entra en el motor de búsqueda: "Plantilla:" más el nombre que deseas darle. Por ejemplo, <nowiki>Plantilla:Argentina</nowiki>. Se pueden usar los mismos caracteres que para crear páginas normales, incluyendo espacios y diacríticos. No hay convenciones de títulos por el momento, pero suele primar la brevedad sobre la claridad.
== Inclusión ==
El contenido de las plantillas acepta toda la '''[[Wikibooks:es:Manual wiki|sintaxis wiki]]''' (ver por ejemplo [[Wikcionario:Cómo se edita una página]]).
 
Para instrucciones sobre el uso y creación de plantillas, consulta la sección correspondiente nuestros proyectos hermanos:
Se llama plantilla a cualquier página que esté destinada a incluirse dentro de otra. Generalmente se trata de las que se encuentran en el espacio de nombres «Plantilla».
* '''[[w:Ayuda:Plantillas|Ayuda sobre plantillas de Wikipedia en español]]'''
* '''[[Wikibooks:es:Manual wiki/Edición/Plantillas|Manual de edición wiki: Plantillas]]''' (Wikibooks en español)
* '''[[m:Help:Template|Help on Templates (Ayuda sobre plantillas)]]''' (Meta-Wiki en inglés).
 
==Véase también==
Para incluir el contenido de una plantilla en una página (procedimiento también llamado transclusión) se debe escribir el nombre de la plantilla entre llaves dobles, de esta manera:
* '''[[Wikcionario:Plantillas|Lista de plantillas empleadas regularmente en Wikcionario]]'''
:<code>&#123;{Nombre de la plantilla}}
* '''[[Ayuda:Tipos de entrada]]''' <!--por crear-->
Cuando se grabe la página (o se muestre la previsualización) en lugar de ese texto aparecerá el contenido de la página «Plantilla:Nombre de la plantilla».
* '''[[Wikcionario:Creación de plantillas]]''' <!--por crear-->
* '''[[Wikibooks:es:Manual wiki/Edición/Palabras mágicas|Manual de edición wiki: Palabras mágicas]]''' (Wikibooks en español)
{{w|Ayuda:Guía rápida de plantillas|preposicion=de}}
{{w|Ayuda:Plantillas|preposicion=de}}
 
==Notas==
Si se desea incluir una página que no esté en el espacio de nombres «Plantilla», se deberá escribir el espacio de nombres explícitamente, usando «<code>:</code>» para el espacio de nombres principal.
<references />
:<code>&#123;{:Artículo ejemplo}}</code> &nbsp; → esto incluirá el contenido del artículo «Artículo ejemplo».
:<code>&#123;{Usuario:Ejemplo/plantilla}}</code> &nbsp; → esto incluirá el contenido de la página [[Usuario:Ejemplo/plantilla]].
 
[[Categoría:Wikcionario:Ayuda]]
 
[[en:Help:Template]]