Help:Template (Español)

From ArchWiki
Estado de la traducción: esta traducción de Help:Template fue revisada el 2019-09-15. Si existen cambios puede actualizarla o avisar al equipo de traducción.

Artículos relacionados

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:Nota: 

{{Nota|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: {{Sugerencia|1=https://www.archlinux.org/?foo=bar}}

Resultado:

Sugerencia: https://archlinux.org/?foo=bar

Esto es muy útil a la hora de:

  • Definir variables.
  • Órdenes y cadenas de shell.
  • Líneas de código.
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 : 

{{Sugerencia|<nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}</nowiki>}}
Sugerencia: = | }} https://www.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 : 

{{Sugerencia|<nowiki>= | }}</nowiki> https://www.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 : 

{{Sugerencia|&#61; &#124; &#123;&#123; &#125;&#125;}}
Sugerencia: = | {{ }}

Creación

Nota:
  • Antes de crear una plantilla, discuta la idea en Help talk:Template.
  • Solo debe crear plantillas relevantes. Si se está tratando de crear una plantilla muy especializada que es probable que solo llegue a utilizarse en algunos artículos, por favor no se apresure, evite abarrotar párrafos con plantillas.
  • Solo debe crear plantillas concisas. Recuerde The Arch Way: Keep It Simple, Stupid!

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

Plantallas sobre el estado del artículo

Para uso en artículos en inglés:

Para uso exclusivo en páginas traducidas:

Para que los artículos sean archivados:

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

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.

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:Nota en las traducciones.
└─> Utilice Template:Sugerencia en las traducciones.
└─> Utilice Template:Advertencia en las traducciones.

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

Plantillas misceláneas

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

└─> Utilice Template:Enlace roto 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:

Para uso en artículos en inglés:

Nombre Marcado Wiki Resultado
Template:Yes {{Yes}} Sí
{{Yes|https://wiki.archlinux.org/}} Sí

Para uso en artículos en general:

Nombre Marcado Wiki Resultado
Template:No {{No}} No
{{No|https://wiki.archlinux.org/}} No
Template:- {{-}} –

Para uso en páginas traducidas:

Nombre Marcado Wiki Resultado
Template:Sí {{Sí}} Sí
{{Sí|https://wiki.archlinux.org/}} Sí
Sugerencia: Puede utilizar atributos con las plantillas de celdas de tabla, anteponiéndolos, por ejemplo: | colspan=2 {{Yes}}.

Plantillas de Categorías

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

Véase también