Difference between revisions of "Help:Template (Español)"

From ArchWiki
Jump to: navigation, search
(Artículo actualizado)
m (Corregir plantilla «Tip»)
Line 55: Line 55:
 
Hay algunos caracteres que, si se utilizan dentro de una plantilla, se romperá su salida: con mayor frecuencia ésto ocurre con {{ic|1==}} (signo igual) y {{ic|<nowiki>|</nowiki>}} (signo barra vertical). Las soluciones a este problema se describen a continuación.
 
Hay algunos caracteres que, si se utilizan dentro de una plantilla, se romperá su salida: con mayor frecuencia ésto ocurre con {{ic|1==}} (signo igual) y {{ic|<nowiki>|</nowiki>}} (signo barra vertical). Las soluciones a este problema se describen a continuación.
  
{{Tip|El símbolo «{{!}}» se puede soslayar utilizando la [[MW:Help:Magic_words#Other|palabra mágica]] {{ic|<nowiki>{{!}}</nowiki>}} .}}
+
{{Sugerencia|El símbolo «{{!}}» se puede soslayar utilizando la [[MW:Help:Magic_words#Other|palabra mágica]] {{ic|<nowiki>{{!}}</nowiki>}} .}}
  
 
==== Parámetros nombrados y numerados ====
 
==== Parámetros nombrados y numerados ====

Revision as of 08:12, 10 September 2018

Estado de la traducción
Este artículo es una traducción de Help:Template, revisada por última vez el 2018-09-07. Si advierte que la versión inglesa ha cambiado puede ayudar a actualizar la traducción, bien por usted mismo o bien avisando 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: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://www.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://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:
  • 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 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 prueba

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:

Plantillas sobre artículos relacionados

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

└─> Utilizar 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:

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

└─> Utilizar Template:Dead link (Español) en las traducciones.

Plantillas de paquetes

Plantillas de celdas de tabla

Alineación del texto:

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

Fondo de la celda:

Nombre Color Utilización 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:Grey gris {{Grey|texto}} texto

Texto común:

Para uso en artículos en inglés:

Nombre Utilización Ejemplo
Template:Yes {{Yes}} Yes
Template:No {{No}} No
Template:- {{-}}

Para uso en páginas traducidas:

Nombre Utilización Ejemplo
Template:Sí {{Sí}}
Template:No {{No}} No

Plantillas de Categorías

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

Véase también