Help:Template (Español)

From ArchWiki
Esta traducción de Help:Template fue revisada el 2022-11-06. Si existen cambios puede actualizarla o avisar al equipo de traducción.

Una plantilla (template) es una pieza predefinida de wikitexto que puede ser insertada en un artículo. Las plantillas se utilizan, principalmente, para ayudar a dar formato al contenido.

Utilización

Las plantillas (Template) se usan añadiendo la siguiente etiqueta a una parte del texto de un artículo:

{{Nombre de la plantilla}}

La mayoría de las plantillas tienen argumentos adicionales, como Template:Note (Español):

{{Note (Español)|Este texto sirve como nota.}}

que se visualiza:

Nota: Este texto sirve como nota.

Algunas plantillas hacen uso de parámetros nombrados, tal como Template:hc:

{{hc|head=/etc/rc.local|output=exit 0}}

que se visualiza:

/etc/rc.local
exit 0

El formato general es:

{{Nombre de la Plantilla|parámetro1|parámetro2|...|parámetroN}}

Consulte la página de cada plantilla para ver las instrucciones de uso específicas.

Estilo

  • Las plantillas deben utilizarse con la capitalización que se muestra en los ejemplos de sus páginas, por ejemplo {{Pkg|... y {{ic|... son correctas, mientras que {{pkg|... y {{Ic|... no lo son.
  • No debe haber espacios alrededor del nombre de la plantilla: {{Template name|... es correcta, mientras que, por ejemplo, {{ Template name |... no lo es.
  • Las plantillas no deben ser categorizadas.

Soslayar caracteres que rompen la plantilla

Hay algunos caracteres que, si se utilizan dentro de una plantilla, se romperá su salida: con mayor frecuencia ésto ocurre con = (signo igual) y | (signo barra vertical). Las soluciones a este problema se describen a continuación.

Sugerencia: El símbolo «|» se puede soslayar utilizando la palabra mágica {{!}} .

Parámetros nombrados y numerados

Si el problema es solo con el signo «=», la solución recomendada es introducir explícitamente los parámetros de la plantilla con sus nombres o números posicionales.

Ejemplo: {{Tip (Español)|1=https://archlinux.org/?foo=bar}}

Resultado:

Esto es muy útil a la hora de:

  • Definir variables.
  • Enlaces externos con cadenas de consulta en URLs.
  • Órdenes y cadenas de intérprete de línea de órdenes.
  • Líneas de código.

Los caracteres de espacio en blanco (es decir, líneas nuevas) se eliminan automáticamente del principio y el final de los valores de parámetros con nombre. Para conservar los espacios en blanco, comience el valor del parámetro con una etiqueta <nowiki/>.

Este ejemplo:

{{Tip (Español)|1=<nowiki/>
* https://archlinux.org/?foo=bar
* https://archlinux.org/?foo=baz
}}

Tiene como resultado:

Parámetros múltiples
  • Utilizar parámetros de posición 1 y 2
{{hc|1=$ echo "="|2==}}

Resultado:

$ echo "="
=
  • Utilizar parámetros de nombres head y output
{{hc|head=$ echo "="|output==}}

Resultado:

$ echo "="
=

Etiquetas nowiki

Si se está teniendo problemas con los caracteres que no sean «=», por ejemplo «}», La solución recomendada es encerrar todo el parámetro con etiquetas <nowiki>. Este método muestra todos los tipos de caracteres, pero evita por completo el motor de la wiki para el marcado de procesamiento de texto, tales como enlaces y otras plantillas. Por ejemplo :

{{Tip (Español)|<nowiki>= | }} https://archlinux.org/ {{ic|foo}}</nowiki>}}
Sugerencia: = | }} https://archlinux.org/ {{ic|foo}}

Encerrando solo algunas partes (o incluso caracteres individuales) con etiquetas <nowiki> seguirá funcionando, por supuesto, pero, pero para facilitar la lectura se recomienda utilizar como método únicamente si los enlaces u otros plantillas tienen que ser mostradas con normalidad. Por ejemplo :

{{Tip (Español)|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}}
Sugerencia: = | }} https://archlinux.org/ foo

Entidades HTML

Sustituir los caracteres problemáticos con sus respectivas entidades HTML siempre funciona, pero ya que reduce la legibilidad del texto original, se recomienda utilizarlas únicamente cuando las soluciones anteriores no son viables. Por ejemplo :

{{Tip (Español)|&#61; &#124; &#123;&#123; &#125;&#125;}}
Sugerencia: = | {{ }}

Creación

Nota:

La siguiente plantilla debe utilizarse para crear nuevas plantillas para facilitar su uso y edición:

<noinclude>
{{Template (Español)}}

'''Una breve descripción de la plantilla'''

==== Utilización ====

<nowiki>{{Nombre de la plantilla|parámetro1|parámetro2|...|parámetroN}}</nowiki>

==== Ejemplo ====

{{Nombre de la plantilla|parámetro1|parámetro1|...|parámetroN}}</noinclude><includeonly>El código de la plantilla va aquí...</includeonly>}}

Para comenzar el proceso de creación, tiene que dirigirse a Template:Template name (sutituyendo Template name con el nombre deseado para la plantilla), luego edite y añada el wikitexto pertinente.

Lista de plantillas

Las plantillas que los usuarios pueden utilizar directamente en los artículos de ArchWiki se enumeran a continuación. Pinche en los enlaces para ver su uso detallado. Para obtener una lista que también incluye las localizaciones y las plantillas de metadatos véase Special:AllPages/Template:, Special:PrefixIndex/Template: o Special:MostLinkedTemplates.

Advertencia: Por favor, no experimente con las plantillas existentes. Si desea editar una plantilla no protegida, copie el texto a Template:Sandbox, edite y compruébela allí, y cópiela de nuevo cuando verifique que funciona. Es una práctica muy recomendable hacerlo así primero (y necesaria para plantillas protegidas) antes de sugerir cualquier modificación en las páginas de discusión.

Para hacer pruebas

Plantillas sobre el estado del artículo

Estas plantillas deben agregarse al comienzo de los artículos o secciones correspondientes. Véase también Help:Style (Español)#Plantillas del estado del artículo.

Los traductores también deben consultar las pautas de la plantilla en ArchWiki:Translation Team (Español).

Las páginas marcadas con las plantillas de estado del artículo se rastrean en la categoría de mantenimiento correspondiente y en las ArchWiki:Statistics#Maintenance statistics.

Nombre Uso recomendado Parámetros
Template:Style Contenido con problemas de idioma, sintaxis wiki o estilo. 1 — razón, 2 — página de discusión opcional, section — sección opcional en la página de discusión predeterminada
Template:Accuracy Contenido incorrecto, engañoso o confuso.
Template:Expansion Contenido incompleto.
Template:Out of date Contenido obsoleto.
Template:Remove Contenido irrelevante o inútil.
Template:Archive Páginas obsoletas.
Template:Laptop style Páginas Laptop que no siguen las Directrices de la página de la computadora portátil.
Template:Translateme (Español) Traducciones incompletas.
Template:Bad translation (Español) Traducciones problemáticas.
Template:TranslationStatus (Español) Estado de las traducciones. 1 — título original, 2 — fecha de la traducción/revisión, 3 — número de revisión
Template:Merge El contenido se superpone con otro artículo. 1 — página destino, 2 — razón, 3 — página de discusión opcional, section — sección opcional en la página de discusión predeterminada
Template:Move Renombrar la página, mover la sección a otro artículo.
Template:Redirect Redirigir la página a otro artículo.
Template:Unsupported Páginas de usuario no soportadas por Arch Linux. 1 — fecha de la última revisión por el autor de la página

Plantillas sobre artículos relacionados

Las plantillas en inglés deben sustituirse por las correspondientes en español (si las hubiere):

└─> Utilice Template:Related articles start (Español) en las traducciones.
└─> Utilice Template:Related2 si desea traducir el título del enlace.

Plantillas para dar formato al código

Plantillas de notas

Las plantillas en inglés deben sustituirse por las correspondientes en español:

└─> Utilice Template:Note (Español) en las traducciones.
└─> Utilice Template:Tip (Español) en las traducciones.
└─> Utilice Template:Warning (Español) en las traducciones.

Para usar en borradores en páginas de discusión solamente:

└─> Utilice Template:Comment (Español) en los borradores en español.

Plantillas misceláneas

Las plantillas en inglés deben sustituirse por las correspondientes en español (si las hubiere):

└─> Utilice Template:Broken package link (Español) en las traducciones.
└─> Utilice Template:Broken section link (Español) en las traducciones.
└─> Utilice Template:Dead link (Español) en las traducciones.

Plantillas de paquetes

Plantillas de celdas de tabla

Alineación del texto:

Nombre Alineación Marcado Wiki Ejemplo
Template:C centrada {{C|texto}} texto
Template:L izquierda {{L|texto}} texto

Fondo de la celda:

Nombre Color Marcado Wiki Ejemplo
Template:R rojo {{R|texto}} texto
Template:O naranja {{O|texto}} texto
Template:Y amarillo {{Y|texto}} texto
Template:G verde {{G|texto}} texto
Template:B azul {{B|texto}} texto
Template:V violeta {{V|texto}} text
Template:Grey gris {{Grey|texto}} texto

Texto común:

Nombre Marcado Wiki Resultado
Template:Yes (Español) {{Yes (Español)}}
{{Yes (Español)|https://wiki.archlinux.org/}}
Template:No {{No}} No
{{No|https://wiki.archlinux.org/}} No
Template:- {{-}}
Sugerencia: Puede utilizar atributos con las plantillas de celdas de tabla, anteponiéndolos, por ejemplo: | colspan=2 {{Yes (Español)}}.

Plantillas de Categorías

└─> Utilice Template:Cat main (Español) en las traducciones.

Véase también