Minecraft Wiki
Registrarse
Sin resumen de edición
(No se muestran 10 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
  +
{{:Minecraft Wiki/style|header=Guía de plantillas de la Minecraft Wiki|content=
{| style="cellspacing:6px"
 
  +
<big>'''Esta es una guía simple para una introducción ordenada al uso de las plantillas.'''</big><br/>
| style="width:65%; border:1px solid #68a; background-color:#f0fff1; padding:0.5em;" valign="middle" |
 
  +
{{:Minecraft Wiki/style|content=
{{Message box
 
 
'''En esta guía uno aprenderá sobre el uso adecuado de cada una de estas plantillas.'''
|title=¿Notó los cuadros de texto especiales en los artículos y desea saber cómo usarlos?
 
  +
|text=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.<br/>
|image=Crafting Table.png
 
 
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.
|imagesize=40px
 
 
}}
 
}}
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.
 
== Uso ==
 
   
  +
== 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:
== Ubicación ==
 
   
  +
* 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.
Las plantillas deben ir al inicio de los artículos. El orden establecido es colocar:
 
  +
* 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 ==
# Hatnotes (Cajas de nota). Deben colocarse sobre el resto de plantillas siendo lo primero que debe estar en el artículo de ser necesario.
 
  +
=== Simple ===
# Message boxes (Cajas de mensaje). Van debajo de las primeras, aunque no necesariamente van al inicio.
 
  +
La principal manera de usar una plantilla es transcluyéndola:
# Infoboxes (Cajas de información). Siempre se deben colocar antes del inicio del texto inicial, sea el del artículo o de una sección.
 
# Navboxes (cajas de navegación). Van exclusivamente al final. No hay nada debajo de ellas salvo categorías e interwikis.
 
   
  +
* <code><nowiki>{{Plantilla|Parámetro}}</nowiki></code> - como el ejemplo de arriba.
== Especificaciones ==
 
   
  +
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í:
=== Plantillas de mantenimiento ===
 
  +
* <code><nowiki>{{Plantilla:Nombre de una página}}</nowiki></code> incluye <code><nowiki>[[Plantilla:Nombre de una página]]</nowiki></code>
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:
 
  +
* <code><nowiki>{{Algo:Nombre de una página}}</nowiki></code> incluye <code><nowiki>[[Algo:Nombre de una página]]</nowiki></code>
  +
* <code><nowiki>{{:Nombre de una página}}</nowiki></code> incluye <code><nowiki>[[Nombre de una página]]</nowiki></code>
  +
** <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:
# Mejorar el contenido de una página si es corto o inadecuado.
 
# Indicar que algo requiere corrección o tradución.
 
# 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.
 
   
  +
* <code><nowiki>{{Algo:Plantilla}}</nowiki></code> incluye <code><nowiki>[[Plantilla:Algo:Plantilla]]</nowiki></code>
* [[Minecraft Wiki:Guía de plantillas/Plantillas de mantenimiento|Lista de plantillas de mantenimiento]]
 
   
=== Plantillas de información ===
+
=== 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:
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:
 
   
  +
* <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.
# Marcar un texto o párrafo como dudoso.
 
  +
* <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>.
# Solicitar que se verifique una información.
 
  +
* <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.
# Denotar la exclusividad de algo.
 
# Marcar algo como futura característica.
 
   
  +
=== Parámetros ===
* [[Minecraft Wiki:Guía de plantillas/Plantillas de información|Lista de plantillas de información]]
 
  +
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>).
   
  +
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.
=== 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:
 
   
  +
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.
# Indicar el estado de mantenimiento de una sección.
 
# Solicitar actualizaciones 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.
* [[Minecraft Wiki:Guía de plantillas/Plantillas de sección|Lista de plantillas de sección]]
 
   
  +
== Documentación ==
=== Plantillas de contenido ===
 
  +
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.
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:
 
   
  +
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.
# 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.
 
   
  +
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}}.
* [[Minecraft Wiki:Guía de plantillas/Plantillas de contenido|Lista de plantillas de contenido]]
 
   
  +
== Colocación ==
=== Plantillas de descripción ===
 
  +
Las plantillas deben colocarse en un orden específico:
Las plantillas de descripción son principalmente útiles cuando se desea describir algún elemento.</br>Su único uso es:
 
   
  +
# Hatnotes. Siempre al inicio del artículo o secció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.
 
  +
# 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 ==
* [[Minecraft Wiki:Guía de plantillas/Plantillas de descripción|Lista de plantillas de descripción]]
 
  +
Los siguientes enlaces dirigen a listados generales de plantillas con una descripción breve de su propósito.
   
 
* [[Minecraft Wiki:Guía de plantillas/Mantenimiento|Lista de plantillas de mantenimiento]]
=== Plantillas de versiones ===
 
 
* [[Minecraft Wiki:Guía de plantillas/Información|Lista de plantillas de información]]
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:
 
 
* [[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 ==
# Indicar otras características de la versión a la que pertenece algo.
 
  +
'''Español:'''
# Señalar otras versiones de una edición específica.
 
  +
* [[wikipedia:Ayuda:Guía rápida de plantillas]]
# Colocar el historial de versiones.
 
  +
* [[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]]
* [[Minecraft Wiki:Guía de plantillas/Plantillas de versiones|Lista de plantillas de versiones]]
 
   
=== Plantillas de sprites ===
 
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:
 
 
# 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/Plantillas de sprites|Lista de plantillas de sprites]]
 
 
=== 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|Lista de plantillas de formato]]
 
 
{{Ayuda}}
 
 
[[en:Minecraft Wiki:Templates]]
 
[[en:Minecraft Wiki:Templates]]

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:

  1. Hatnotes. Siempre al inicio del artículo o sección.
  2. Message boxes. Siempre colocado después de las hatnotes.
  3. Infoboxes. Después de los dos primeros, si es necesario utilizarlas.
  4. 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: