Cambios: Minecraft Wiki:Guía de plantillas

Revisión del 17:39 5 abr 2021

Guía de plantillas de la Minecraft Wiki

Esta es una guía simple para una introducción ordenada al uso de las plantillas.

En esta guía uno aprenderá sobre el uso adecuado de cada una de estas plantillas.

Las plantillas son una característica de las Wikis que permiten que un formateo complejo sea repetido en varias páginas.
Muchas de estas fueron proveídas por el software de MediaWiki o sus plugins, pero los editores de Minecraft Wiki han añadido varias más, especializadas para los propósitos de redacción y edición.

Descripción

En su forma más básica, las plantillas son básicamente páginas cuyo contenido se puede usar en otras páginas. Siguen la convención de que su nombre tiene el prefijo Plantilla:, asignándolo a ese espacio de nombres. Su contenido está diseñado para ser transcluido (incrustado) dentro de otras páginas.

Al editar, uno puede encontrarse con:

{{Plantilla|Parámetro}}

Esto es un ejemplo de cómo usar las plantillas que se utilizan en las páginas de la wiki. Las llaves dobles, {{ y }} generalmente significan que se está usando una plantilla allí, pero igualmente también tienen otros usos en wikitexto, lo que puede causar cierta confusión.

Para darse cuenta de que algo es una plantilla o no, en este caso, tenemos una pista definida porque lo primero que sigue al nombre, además del espacio, es un carácter de tubería: (|). Definitivamente esta es una plantilla. Si tuviera dos puntos, (:), entonces no sería una plantilla, sino una especie de palabra mágica. Si tiene problemas identificando una plantilla, siga los siguientes consejos:

Una pista es que es una plantilla es que no se encuentra en letras mayúsculas. Prácticamente todas las palabras mágicas que no requieren dos puntos se escriben en mayúsculas.
Para estar seguro, al editar una página, debería ver el apartado "Plantillas usadas en esta página" en la parte inferior de la pantalla debajo de "Guardar página" y otros botones. Si aparece en la lista, definitivamente es una plantilla.
Si no es una palabra mágica documentada, es casi seguro que sea una plantilla.

Uso

Simple

La principal manera de usar una plantilla es transcluyéndola:

{{Plantilla|Parámetro}} - como el ejemplo de arriba.

De hecho, una página wiki normal también se puede utilizar como plantilla, simplemente especificando el espacio de nombres en el que reside, así:

{{Plantilla:Nombre de una página}} incluye [[Plantilla:Nombre de una página]]
{{Algo:Nombre de una página}} incluye [[Algo:Nombre de una página]]
{{:Nombre de una página}} incluye [[Nombre de una página]]
- {{SUBST::Pagename}} se reemplaza por el contenido de [[Nombre de una página]]

Si no existe tal espacio de nombres, se asume que el título completo es una plantilla:

{{Algo:Plantilla}} incluye [[Plantilla:Algo:Plantilla]]

Avanzado

Hay otras formas de usar plantillas, útiles en la edición de fuente. Además de la transclusión estándar, otras formas avanzadas de usar plantillas son:

{{subst:Nombre}}: Cuando se utilice este enlace de plantilla, se reemplazará de una vez por todas con el contenido de [[Plantilla:Nombre]] a partir del momento en el que una página es guardada; una copia del contenido de [[Plantilla:Nombre]] sustituirá el código de la plantilla. Los contenidos formarán parte de la página y se pueden editar normalmente, por separado de la plantilla original. Los cambios en la página de la plantilla de origen no se propagarán a la página con el enlace de la plantilla.
{{safesubst:Nombre}}: Para casos especiales en los que se puede diseñar una plantilla para que funcione tanto a través de la transclusión como de la sustitución. Por ejemplo, supongamos que utilizó una plantilla {{Primer nombre}} dentro de [[Plantilla:Nombre]]. Si usa {{subst:Nombre}}, el {{Primer nombre}} se guardará en la página. Si intenta cambiarlo a {{subst:Primer nombre}} dentro de [[Plantilla:Nombre]], entonces se sustituirá dentro de la plantilla. safesubst: no sustituye hasta que la plantilla que lo contiene se utiliza con subst:.
{{msgnw:Nombre}} incluye la plantilla en una forma que la muestra como sintaxis wiki sin formato (de la misma manera que como hace & lt; nowiki & gt; ) cuando se recupera la página que lo contiene.

Parámetros

Las plantillas pueden tener parámetros que la página puede incorporar dinámicamente en la página transcluida. En lugar de solo el nombre de la plantilla, como {{algo}}, una etiqueta de plantilla incrustada tendría valores adicionales separados por barras verticales (|).

Por ejemplo, en {{algo|Julio|lc=yes}}, Julio es el valor del primer parámetro sin nombre; yes es el valor del parámetro nombrado lc. La sintaxis de esto es {{Plantilla|parámetro|parámetro}} donde Plantilla es el nombre de la plantilla, y cada parámetro puede contener solo un valor (estos se denominan parámetros sin nombre) o tener el formato nombre=valor (parámetros con nombre). El primer, segundo, tercer, etc. parámetro sin nombre recibirá los nombres 1, 2, 3, etc.

Los caracteres de espacio en blanco (espacios, tabulaciones, retornos) se eliminan desde el principio y el final de los nombres y valores de los parámetros con nombre, pero no desde el medio: así {{...| parámetro = esto es una prueba }} tiene el mismo efecto que {{...|parámetro=esto es una prueba}}. Esto no se aplica a los parámetros sin nombre, donde se conservan todos los espacios en blanco.

El valor de un parámetro puede ser la cadena vacía, como cuando la tubería o el signo igual es seguido inmediatamente por la siguiente tubería o las llaves de cierre. Esto es diferente de omitir el parámetro por completo, lo que lo deja indefinido, aunque las plantillas a menudo se codifican para que se comporten de la misma manera en ambos casos.

Documentación

La documentación de una plantilla es la descripción de su uso, explicando cada detalle y parámetro utilizado. Se encuentra en la página de la plantilla. Una forma en la que normalmente puede llegar rápidamente a la página de la plantilla es utilizando la sección "Plantillas usadas en esta página" en la parte inferior de la página de edición.

Desafortunadamente, muchas plantillas no están documentadas. En este caso, puede intentar buscar ejemplos de la plantilla que se utiliza en otras páginas. Desde la página de la plantilla, intente hacer clic en "Lo que enlaza aquí" en el menú "Herramientas" en la barra lateral para buscar otras páginas donde se utiliza la plantilla. Si no está documentada, considere escribir su propia documentación para la plantilla.

Para enlazar a una plantilla, también puede utilizar la Plantilla:Template link. Un ejemplo es {{tl|ampliar}}, que genera Plantilla:Tl.

Colocación

Las plantillas deben colocarse en un orden específico:

Hatnotes. Siempre al inicio del artículo o sección.
Message boxes. Siempre colocado después de las hatnotes.
Infoboxes. Después de los dos primeros, si es necesario utilizarlas.
Navboxes. Se colocan al final del artículo, justo antes de las categorías e interwikis.

Listados

Los siguientes enlaces dirigen a listados generales de plantillas con una descripción breve de su propósito.

Lista de plantillas de mantenimiento
Lista de plantillas de información
Lista de plantillas de contenido
Lista de plantillas de descripción
Lista de plantillas de elementos
Lista de plantillas de sprites
Lista de plantillas de formato

Enlaces detallados

Español:

Inglés:

@@ Línea 1: / Línea 1: @@
+{{:Minecraft Wiki/style|header=Guía de plantillas de la Minecraft Wiki|content=
-{{Message box
+<big>'''Esta es una guía simple para una introducción ordenada al uso de las plantillas.'''</big><br/>
-|title=¿Notó los cuadros de texto especiales en los artículos y desea saber cómo usarlos?
+{{:Minecraft Wiki/style|content=
-|text=En esta guía uno aprenderá sobre el uso adecuado de cada una de estas plantillas.
+'''En esta guía uno aprenderá sobre el uso adecuado de cada una de estas plantillas.'''
-|image=Crafting Table.png
-|imagesize=40px
-|}
+Las plantillas son una característica de las Wikis que permiten que un formateo complejo sea repetido en varias páginas.<br/>
-{| style="cellspacing:6px"
+Muchas de estas fueron proveídas por el software de MediaWiki o sus plugins, pero los editores de Minecraft Wiki han añadido varias más, especializadas para los propósitos de redacción y edición.
-| style="width:65%; border:1px solid #68a; background-color:#f0fff1; padding:0.5em;" valign="middle" |
+}}
-Las plantillas son una característica de las Wikis que permiten que un formateo complejo sea repetido en varias páginas. Muchas de estas fueron proveídas por el software de MediaWiki o sus plugins, pero los editores de Minecraft Wiki han añadido varias más, especializadas para los propósitos de redacción y edición.
+== Descripción ==
-Para utilizar una plantilla, uno debe utilizar {{cd|<nowiki>{{(Nombre de la plantilla)}}</nowiki>}} y se generará una en el texto. Las plantillas tienen la propiedad de ser configurables con parámetros si los poseen.
+En su forma más básica, las plantillas son básicamente páginas cuyo contenido se puede usar en otras páginas. Siguen la convención de que su nombre tiene el prefijo <code>Plantilla:</code>, asignándolo a ese espacio de nombres. Su contenido está diseñado para ser [[wikipedia:Transclusión|transcluido]] (incrustado) dentro de otras páginas.
+Al editar, uno puede encontrarse con:
-Los parámetros se utilizan de la manera {{cd|<nowiki>{{(Nombre de la plantilla)|(Párametro)|(PárametroN)}}</nowiki>}}. Cabe resaltar que no todos trabajan igual, por lo que se debe ir a la página específica de la plantilla para ver usos específicos y detallados.
+<pre style="display: table;">{{Plantilla|Parámetro}}</pre>
+Esto es un ejemplo de cómo usar las plantillas que se utilizan en las páginas de la wiki. Las llaves dobles, <code><nowiki>{{</nowiki></code> y <code><nowiki>}}</nowiki></code> generalmente significan que se está usando una plantilla allí, pero igualmente también tienen otros usos en wikitexto, lo que puede causar cierta confusión.
-Para ir a la página de una plantilla, solo haga clic sobre un texto azul entre llaves. Por ejemplo, para ir a la plantilla "En construcción", solo haga clic en la parte azul de {{tl|En construcción}}. Así podrá ver la información detallada sobre el uso de cada una.
+Para darse cuenta de que algo es una plantilla o no, en este caso, tenemos una pista definida porque lo primero que sigue al nombre, además del espacio, es un carácter de tubería: (<code><nowiki>|</nowiki></code>). Definitivamente esta es una plantilla. Si tuviera dos puntos, (<code><nowiki>:</nowiki></code>), entonces no sería una plantilla, sino una especie de palabra mágica. Si tiene problemas identificando una plantilla, siga los siguientes consejos:
-== Plantillas de mantenimiento ==
-Las plantillas de mantenimiento sirven para indicar el estado de mantenimiento de una página (plantilla, artículo o categoría). Su uso es requerido en situaciones específicas, las cuales pueden ser:
+* Una pista es que es una plantilla es que ''no se encuentra'' en letras mayúsculas. Prácticamente todas las palabras mágicas que no requieren dos puntos se escriben en mayúsculas.
-# Mejorar el contenido de una página si es corto o inadecuado.
+* Para estar seguro, al editar una página, debería ver el apartado "Plantillas usadas en esta página" en la parte inferior de la pantalla debajo de "Guardar página" y otros botones. Si aparece en la lista, definitivamente es una plantilla.
-# Indicar que algo requiere corrección o tradución.
+* Si no es una palabra mágica documentada, es casi seguro que sea una plantilla.
-# Solicitar un borrado si no cumple con los requisitos mínimos.
-# Solicitar una fusión, división o traslado.
-# En ciertos casos, indicar el estado de una página.
+== Uso ==
-* [[Minecraft Wiki:Guía de plantillas/Plantillas de mantenimiento|Guía de plantillas de mantenimiento]]
+=== Simple  ===
+La principal manera de usar una plantilla es transcluyéndola:
+* <code><nowiki>{{Plantilla|Parámetro}}</nowiki></code> - como el ejemplo de arriba.
-== Plantillas de información ==
-Las plantillas de información sirven para especificar información extra sobre algo específico. Son de tamaño pequeño y suelen ir unidas a palabras, aunque también a párrafos. Sus usos son simples:
+De hecho, una página wiki normal también se puede utilizar como plantilla, simplemente especificando el espacio de nombres en el que reside, así:
-# Marcar un texto o párrafo como dudoso.
+* <code><nowiki>{{Plantilla:Nombre de una página}}</nowiki></code> incluye <code><nowiki>[[Plantilla:Nombre de una página]]</nowiki></code>
-# Solicitar que se verifique una información.
+* <code><nowiki>{{Algo:Nombre de una página}}</nowiki></code> incluye <code><nowiki>[[Algo:Nombre de una página]]</nowiki></code>
-# Denotar la exclusividad de algo.
+* <code><nowiki>{{:Nombre de una página}}</nowiki></code> incluye <code><nowiki>[[Nombre de una página]]</nowiki></code>
-# Marcar algo como futura característica.
+** <code><nowiki>{{SUBST::Pagename}}</nowiki></code> se reemplaza por el contenido de <code><nowiki>[[Nombre de una página]]</nowiki></code>
+Si no existe tal espacio de nombres, se asume que el título completo es una plantilla:
-* [[Minecraft Wiki:Guía de plantillas/Plantillas de información|Guía de plantillas de información]]
+* <code><nowiki>{{Algo:Plantilla}}</nowiki></code> incluye <code><nowiki>[[Plantilla:Algo:Plantilla]]</nowiki></code>
-== Plantillas de sección ==
-Las plantillas de sección son parecidas a las de mantenimiento, e incluso pueden ser derivados con parámetros de estas, pero la diferencia es que su uso es exclusivo de las secciones. Sus principales funciones son:
+=== Avanzado ===
-# Indicar el estado de mantenimiento de una sección.
+Hay otras formas de usar plantillas, útiles en la edición de fuente. Además de la transclusión estándar, otras formas avanzadas de usar plantillas son:
-# Solicitar actualizaciones de contenido.
+* <code><nowiki>{{subst:Nombre}}</nowiki></code>: Cuando se utilice este enlace de plantilla, se reemplazará de una vez por todas con el contenido de <nowiki>[[Plantilla:Nombre]]</nowiki> a partir del momento en el que una página es '''guardada'''; una copia del contenido de <nowiki>[[Plantilla:Nombre]]</nowiki> ''sustituirá'' el código de la plantilla. Los contenidos formarán parte de la página y se pueden editar normalmente, por separado de la plantilla original. Los cambios en la página de la plantilla de origen ''no'' se propagarán a la página con el enlace de la plantilla.
-* [[Minecraft Wiki:Guía de plantillas/Plantillas de sección|Guía de plantillas de sección]]
+* <code><nowiki>{{safesubst:Nombre}}</nowiki></code>: Para casos especiales en los que se puede diseñar una plantilla para que funcione tanto a través de la transclusión como de la sustitución. Por ejemplo, supongamos que utilizó una plantilla <nowiki>{{Primer nombre}}</nowiki> dentro de <nowiki>[[Plantilla:Nombre]]</nowiki>. Si usa <nowiki>{{subst:Nombre}}</nowiki>, el <nowiki>{{Primer nombre}}</nowiki> se guardará en la página. Si intenta cambiarlo a <nowiki>{{subst:Primer nombre}}</nowiki> dentro de <nowiki>[[Plantilla:Nombre]]</nowiki>, entonces se sustituirá dentro de la plantilla. <code>safesubst:</code> no sustituye hasta que la plantilla que lo contiene se utiliza con <code>subst:</code>.
+* <code><nowiki>{{msgnw:Nombre}}</nowiki></code> incluye la plantilla en una forma que la muestra como sintaxis wiki sin formato (de la misma manera que como hace <code><nowiki> & lt; nowiki & gt; </nowiki></code>) cuando se recupera la página que lo contiene.
+=== Parámetros ===
-== Plantillas de contenido ==
+Las plantillas pueden tener parámetros que la página puede incorporar dinámicamente en la página transcluida. En lugar de solo el nombre de la plantilla, como <code><nowiki>{{algo}}</nowiki></code>, una etiqueta de plantilla incrustada tendría valores adicionales separados por barras verticales (<code><nowiki>|</nowiki></code>).
-Las plantillas de contenido hablan del contenido presente en cada una de las ediciones de Minecraft, así como hablan de estas en sí. Sirven para denotar hechos relevantes en estas. Algunos usos son:
+Por ejemplo, en <code><nowiki>{{algo|Julio|lc=yes}}</nowiki></code>, <code>Julio</code> es el valor del primer parámetro sin nombre; <code>yes</code> es el valor del parámetro nombrado {{cd|lc}}. La sintaxis de esto es <code><nowiki>{{Plantilla|parámetro|parámetro}}</nowiki></code> donde {{cd|Plantilla}} es el nombre de la plantilla, y cada {{cd|parámetro}} puede contener solo un valor (estos se denominan ''parámetros sin nombre'') o tener el formato {{cd|nombre}}{{=}}{{cd|valor}} (''parámetros con nombre''). El primer, segundo, tercer, etc. parámetro sin nombre recibirá los nombres <code>1</code>, <code>2</code>, <code>3</code>, etc.
-# Marcar la exclusividad de una característica.
-# Señalar que una versión está obsoleta.
-# Indicar que algo no es oficial.
-# Indicar que algo solo ha aparecido en versiones de desarrollo.
-# Señalar características de una versión.
+Los caracteres de espacio en blanco (espacios, tabulaciones, retornos) se eliminan desde el principio y el final de los nombres y valores de los parámetros con nombre, pero no desde el medio: así <code><nowiki>{{...| parámetro = esto es una prueba }}</nowiki></code> tiene el mismo efecto que <code><nowiki> {{...|parámetro=esto es una prueba}}</nowiki></code>. Esto no se aplica a los parámetros sin nombre, donde se conservan todos los espacios en blanco.
-* [[Minecraft Wiki:Guía de plantillas/Plantillas de contenido|Guía de plantillas de contenido]]
+El valor de un parámetro puede ser la cadena vacía, como cuando la tubería o el signo igual es seguido inmediatamente por la siguiente tubería o las llaves de cierre. Esto es diferente de omitir el parámetro por completo, lo que lo deja indefinido, aunque las plantillas a menudo se codifican para que se comporten de la misma manera en ambos casos.
-== Plantillas de descripción ==
-Las plantillas de descripción son principalmente útiles cuando se desea describir algún elemento.</br>Su único uso es:
+== Documentación ==
-# Describir algún elemento, sea persona, bloque, versión, etc. e indicar sus características principales y relevantes respecto al artículo en el que se encuentren.
+La documentación de una plantilla es la descripción de su uso, explicando cada detalle y parámetro utilizado. Se encuentra en la página de la plantilla. Una forma en la que normalmente puede llegar rápidamente a la página de la plantilla es utilizando la sección "Plantillas usadas en esta página" en la parte inferior de la página de edición.
+Desafortunadamente, muchas plantillas no están documentadas. En este caso, puede intentar buscar ejemplos de la plantilla que se utiliza en otras páginas. Desde la página de la plantilla, intente hacer clic en "Lo que enlaza aquí" en el menú "Herramientas" en la barra lateral para buscar otras páginas donde se utiliza la plantilla. Si no está documentada, considere escribir su propia documentación para la plantilla.
-* [[Minecraft Wiki:Guía de plantillas/Plantillas de descripción|Guía de plantillas de descripción]]
+Para enlazar a una plantilla, también puede utilizar la [[Plantilla:Template link]]. Un ejemplo es <code><nowiki>{{tl|ampliar}}</nowiki></code>, que genera {{tl|ampliar}}.
-== Plantillas de versiones ==
-Las plantillas de versiones sirven para documentar versiones y listados de algunas características. Su función principal es la de denotar en un artículo otras características relevantes. Pueden ser usadas para:
+== Colocación ==
-# Indicar otras características de la versión a la que pertenece algo.
+Las plantillas deben colocarse en un orden específico:
-# Señalar otras versiones de una edición específica.
-# Colocar el historial de versiones.
+# Hatnotes. Siempre al inicio del artículo o sección.
-* [[Minecraft Wiki:Guía de plantillas/Plantillas de versiones|Guía de plantillas de versiones]]
+# Message boxes. Siempre colocado después de las hatnotes.
+# Infoboxes. Después de los dos primeros, si es necesario utilizarlas.
+# Navboxes. Se colocan al final del artículo, justo antes de las categorías e interwikis.
-== Plantillas de sprites ==
+== Listados ==
+Los siguientes enlaces dirigen a listados generales de plantillas con una descripción breve de su propósito.
-Las plantillas de sprites sirven para colocar un sprite en una página. Su uso es reducido y son visualmente útiles para marcar algo que podría ser difícil de hallar en el texto. Su único uso es:
+* [[Minecraft Wiki:Guía de plantillas/Mantenimiento|Lista de plantillas de mantenimiento]]
-# Colocar un sprite en una página, y si se puede, hacer que este lleve a una página específica.
+* [[Minecraft Wiki:Guía de plantillas/Información|Lista de plantillas de información]]
+* [[Minecraft Wiki:Guía de plantillas/Contenido|Lista de plantillas de contenido]]
+* [[Minecraft Wiki:Guía de plantillas/Descripción|Lista de plantillas de descripción]]
+* [[Minecraft Wiki:Guía de plantillas/Elementos|Lista de plantillas de elementos]]
+* [[Minecraft Wiki:Guía de plantillas/Sprites|Lista de plantillas de sprites]]
+* [[Minecraft Wiki:Guía de plantillas/Formato|Lista de plantillas de formato]]
+== Enlaces detallados ==
-* [[Minecraft Wiki:Guía de plantillas/Plantillas de sprites|Guía de plantillas de sprites]]
+'''Español:'''
+* [[wikipedia:Ayuda:Guía rápida de plantillas]]
+* [[wikipedia:Ayuda:Plantillas]]
+* [[mw:Help:Templates/es]]
+'''Inglés:'''
+* [[gphelp:gphelp:Templates]]
+* [[:en:wikipedia:Help:A quick guide to templates]]
+* [[:en:wikipedia:Help:Template]]
+* [[metawikipedia:Help:A quick guide to templates]]
+* [[metawikipedia:Help:Template]]
+* [[metawikipedia:Help:Advanced templates]]
+* [[mw:Help:Templates]]
+}}
+{{Ayuda}}
+[[Categoría:Ayuda]]
-== Plantillas de formato ==
-Nota: Estas plantillas son personalizables y son parte fundamental del resto de plantillas. Las plantillas de formato sirven para estructurar textos y personalizar el contenido de una página. Su uso es avanzado y lo que se documenta puede que no sea fácil de comprender si no se consulta, por lo que se deben usar con cuidado. Algunas plantillas tienen como usos:
-# Personalizar un cuadro de texto.
-# Adecuar un texto según las necesidades.
-* [[Minecraft Wiki:Guía de plantillas/Plantillas de formato|Guía de plantillas de formato]]
-{{Ayuda}}
 [[en:Minecraft Wiki:Templates]]