Help:Template (Español)

From ArchWiki
Revision as of 04:10, 1 March 2014 by Kynikos (Talk | contribs) (update link(s) (avoid redirect), comply with Help:Style#Title)

Jump to: navigation, search

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.

Uso

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|param1|param2|...|paramN}}

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.

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.

Parámetros nombrados

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. Esto es muy útil con cadenas de consulta en las URL o definiciones de variables, pero no va a funcionar para otros caracteres problemáticos , como «|». Por ejemplo:

{{Sugerencia|1=https://www.archlinux.org/?foo=bar}}

O, con múltiples parámetros:

{{hc|1=$ echo "="|2="="}}
{{hc|head=$ echo "="|output="="}}
$ 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://www.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; &#125;&#125;}}
Sugerencia: = | }}

Creación

Nota:
  • Sólo debe crear plantillas relevantes. Si se está tratando de crear una plantilla muy especializada que es probable que sólo llegue a utilizarse en algunos artículos, por favor no se apresure, evite abarrotar párrafos con plantillas.
  • Sólo 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>{{Plantilla}}

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

====Uso====
{{ic|<nowiki>{{Nombre de la plantilla|param1|param2|...|paramN}}</nowiki>}}

====Ejemplo====
{{Nombre de la plantilla|param1|param2|...|paramN}}</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 experimentar con las plantillas existentes. Si desea editar una plantilla no protegida, copie el texto a Template:Sandbox, edite y compruebe allí, y cópielo de nuevo cuando verifica que funciona. Es una práctica muy recomendable hacerlo 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

Plantillas sobre artículos relacionados

Plantillas para dar formato al código

Plantillas de notas

Plantillas misceláneas

Plantillas de paquetes

Véase también