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

From ArchWiki
Jump to: navigation, search
(Soslayar caracteres que rompen la plantilla: Actualizar)
(Soslayar caracteres que rompen la plantilla: Actualizar)
Line 43: Line 43:
 
===Soslayar caracteres que rompen la plantilla===
 
===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 {{ic|1==}} (signo igual) y {{ic|<nowiki>|</nowiki>}} (signo barra vertical).
+
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.
  
Las soluciones más fáciles y efectivas a este problema son:
+
==== 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:
  
*Usando parámetros numerados, como en:
+
{{bc|<nowiki>{{Sugerencia|1=https://www.archlinux.org/?foo=bar}}</nowiki>}}
{{Nota|1=Este método es efectivo sólo para el signo = y es muy útil con cadenas URL a las que se remiten las consultas, por ejemplo, https://www.archlinux.org/?foo=bar}}
+
{{bc|<nowiki>{{Nota|1=Este método es efectivo sólo para el signo = y es muy útil con cadenas URL a las que se remiten las consultas, por ejemplo, https://www.archlinux.org/?foo=bar}}</nowiki>}}
+
  
*Sustituyendo los caracteres problemáticos con sus respectivas etiquetas HTML, como en:
+
{{Sugerencia|1=https://www.archlinux.org/?foo=bar}}
{{Nota|Este método es compatible con todo tipo de caracteres, incluyendo &#61;, &#124; y &#125;&#125; ( https://www.archlinux.org/?foo&#61;bar )}}
+
{{bc|<nowiki>{{Nota|Este método es compatible con todo tipo de caracteres, incluyendo &#61;, &#124; y &#125;&#125; ( https://www.archlinux.org/?foo&#61;bar )}}</nowiki>}}
+
  
*Encerrando los caracteres afectados entre las etiquetas <nowiki><nowiki></nowiki>, como en:
+
O, con múltiples parámetros:
{{Nota|<nowiki>Este método muestra todos los caracteres ( = | }} ), evitando completamente que el motor de wiki procese el texto marcado, como enlaces ( https://www.archlinux.org/ ) y otras plantillas ( {{ic|foo}} ).</nowiki>}}
+
 
{{bc|<nowiki>{{Nota|<nowiki>Este método muestra todos los caracteres ( = | }} ), previniendo completamente que el motor de wiki procese el texto marcado, como enlaces ( https://www.archlinux.org/ ) y otras plantillas ( {{ic|foo}} ).</nowiki>}}
+
{{bc|<nowiki>{{hc|1=$ echo "="|2="="}}</nowiki>}}
 +
 
 +
{{bc|<nowiki>{{hc|head=$ echo "="|output="="}}</nowiki>}}
 +
 
 +
{{hc|1=$ echo "="|2="="}}
 +
 
 +
==== 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 {{ic|<nowiki><nowiki></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 :
 +
 
 +
{{bc|<nowiki>{{Sugerencia|&lt;nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}&lt;/nowiki>}}</nowiki>}}
 +
 
 +
{{Sugerencia|<nowiki>= | }} https://www.archlinux.org/ {{ic|foo}}</nowiki>}}
 +
 
 +
Encerrando solo algunas partes (o incluso caracteres individuales) con etiquetas {{ic|<nowiki><nowiki></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 :
 +
 
 +
{{bc|<nowiki>{{Sugerencia|&lt;nowiki>= | }}&lt;/nowiki> https://www.archlinux.org/ {{ic|foo}}}}</nowiki>}}
 +
 
 +
{{Sugerencia|<nowiki>= | }}</nowiki> https://www.archlinux.org/ {{ic|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 :
 +
 
 +
{{bc|<nowiki>{{Sugerencia|&amp;#61; &amp;#124; &amp;#125;&amp;#125;}}</nowiki>}}
 +
 
 +
{{Sugerencia|&#61; &#124; &#125;&#125;}}
  
 
==Creación==
 
==Creación==

Revision as of 16:08, 8 December 2013

Template:Article summary start Template:Article summary text Template:Article summary end

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.

Visite Help:Template para ver una lista de todas las plantillas disponibles.

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, como:

{{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.

Plantillas de uso frecuente

Algunas de las plantillas más frecuentemente utilizadas en la Wiki de Arch se enumeran a continuación. Pulse los enlaces para ver su uso detallado. Para obtener una lista completa, consulte Special:MostLinkedTemplates.

Textos en recuadros

Formatos de código

Otras

Véase también