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

From ArchWiki
Jump to: navigation, search
m (update like the English article)
(simplification and beautification of wikilinks, fixing whitespace, capitalization and section fragments (https://github.com/lahwaacz/wiki-scripts/blob/master/link-checker.py (interactive)))
 
(17 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
[[Category:Help (Español)]]
 
[[Category:Help (Español)]]
 
[[en:Help:Template]]
 
[[en:Help:Template]]
[[zh-CN:Help:Template]]
+
[[fa:راهنما:الگو]]
{{Article summary start|Sumario}}
+
[[ja:ヘルプ:テンプレート]]
{{Article summary text|Este artículo contiene una introducción básica sobre la utilización y creación de plantillas.}}
+
[[ru:Help:Template]]
{{Article summary end}}
+
[[zh-cn:Help:Template]]
 +
[[zh-tw:Help:Template]]
 +
{{Related articles start (Español)}}
 +
{{Related|Help:Editing (Español)}}
 +
{{Related|Help:Reading (Español)}}
 +
{{Related|Help:Style (Español)}}
 +
{{Related articles end}}
  
 
Una plantilla (template) es una pieza predefinida de [[Wikipedia:es:Wikitexto|wikitexto]] que puede ser insertada en un artículo. Las plantillas se utilizan, principalmente, para ayudar a dar formato al contenido.
 
Una plantilla (template) es una pieza predefinida de [[Wikipedia:es:Wikitexto|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==
 
==Uso==
Line 15: Line 19:
 
{{bc|<nowiki>{{Nombre de la plantilla}}</nowiki>}}
 
{{bc|<nowiki>{{Nombre de la plantilla}}</nowiki>}}
  
La mayoría de las plantillas tienen argumentos adicionales, como [[:Template:Nota]]:
+
La mayoría de las plantillas tienen argumentos adicionales, como [[Template:Nota]]:
  
 
{{bc|<nowiki>{{Nota|Este texto sirve como nota.}}</nowiki>}}
 
{{bc|<nowiki>{{Nota|Este texto sirve como nota.}}</nowiki>}}
Line 23: Line 27:
 
{{Nota|Este texto sirve como nota.}}
 
{{Nota|Este texto sirve como nota.}}
  
Algunas plantillas hacen uso de parámetros nombrados, como:
+
Algunas plantillas hacen uso de parámetros nombrados, tal como [[Template:hc]]:
  
{{bc|<nowiki>{{Hc|head=/etc/rc.local|output=exit 0}}</nowiki>}}
+
{{bc|<nowiki>{{hc|head=/etc/rc.local|output=exit 0}}</nowiki>}}
  
 
que se visualiza:
 
que se visualiza:
  
{{Hc|head=/etc/rc.local|output=exit 0}}
+
{{hc|head=/etc/rc.local|output=exit 0}}
  
 
El formato general es:
 
El formato general es:
Line 36: Line 40:
  
 
Consulte la página de cada plantilla para ver las instrucciones de uso específicas.
 
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 {{ic|&#123;{Pkg&#124;...}} y {{ic|&#123;{ic&#124;...}} son correctas, mientras que {{ic|&#123;{pkg&#124;...}} y {{ic|&#123;{Ic&#124;...}} no lo son.
 +
* No debe haber espacios alrededor del nombre de la plantilla: {{ic|&#123;{Template name&#124;...}} es correcta, mientras que, por ejemplo, {{ic|&#123;{ Template name &#124;...}} no lo es.
  
 
===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==
Line 72: Line 101:
 
{{Nombre de la plantilla|param1|param2|...|paramN}}</noinclude><includeonly>El código de la plantilla va aquí...</includeonly></nowiki>}}
 
{{Nombre de la plantilla|param1|param2|...|paramN}}</noinclude><includeonly>El código de la plantilla va aquí...</includeonly></nowiki>}}
  
Para comenzar el proceso de creación, tiene que dirigirse a [[:Template:Template Name]] (sutituyendo {{ic|Template Name}} con el nombre deseado para la plantilla), luego [[Help:Editing (Español)|edite y añada el wikitexto pertinente]].
+
Para comenzar el proceso de creación, tiene que dirigirse a [[:Template:Template name]] (sutituyendo {{ic|Template name}} con el nombre deseado para la plantilla), luego [[Help:Editing (Español)|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===
 +
 
 +
* [[Template:Sandbox]]
 +
* [[Template:Lorem Ipsum]]
 +
 
 +
===Plantallas sobre el estado del artículo===
 +
 
 +
* [[Template:Accuracy]]
 +
* [[Template:Bad translation]]
 +
* [[Template:Deletion]]
 +
* [[Template:Expansion]]
 +
* [[Template:Merge]]
 +
* [[Template:Move]]
 +
* [[Template:Out of date]]
 +
* [[Template:Stub]]
 +
* [[Template:Style]]
 +
* [[Template:Translateme]]
 +
 
 +
===Plantillas sobre artículos relacionados===
 +
 
 +
* [[Template:Related articles start]]
 +
* [[Template:Related]]
 +
* [[Template:Related articles end]]
 +
 
 +
===Plantillas para dar formato al código===
 +
 
 +
* [[Template:ic]]
 +
* [[Template:bc]]
 +
* [[Template:hc]]
 +
 
 +
===Plantillas de notas===
 +
 
 +
* [[Template:Note]]
 +
* [[Template:Tip]]
 +
* [[Template:Warning]]
  
== Plantillas de uso frecuente ==
+
===Plantillas misceláneas===
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 ===
+
* [[Template:App]]
* [[Template:Nota|<nowiki>{{Nota|Este texto contiene una nota o puntualización.}}</nowiki>]]
+
* [[Template:Bug]]
* [[Template:Advertencia|<nowiki>{{Advertencia|Este texto contiene una advertencia o llamada de atención.}}</nowiki>]]
+
* [[Template:Dead link]]
* [[Template:Tip|<nowiki>{{Tip|Este texto debe ser considerado una sugerencia o consejo.}}</nowiki>]]
+
  
=== Formatos de código ===
+
===Plantillas de paquetes===
* [[Template:ic|<nowiki>{{ic|Código en línea}}</nowiki>]]
+
* [[Template:bc|<nowiki>{{bc|Código en bloque sin encabezado}}</nowiki>]]
+
* [[Template:hc|<nowiki>{{hc|Código en bloque con encabezado}}</nowiki>]]
+
  
=== Otras ===
+
* [[Template:Pkg]]
* [[Template:Pkg|<nowiki>{{Pkg|paquete}}</nowiki>]]
+
* [[Template:Grp]]
* [[Template:AUR|<nowiki>{{AUR|paquete}}</nowiki>]]
+
* [[Template:AUR]]
* [[Template:Linkrot|<nowiki>{{Linkrot|aaaa|mm|dd}}</nowiki>]]
+
  
 
==Véase también==
 
==Véase también==
 
*[[Template:Template]]
 
*[[Template:Template]]
 
*http://meta.wikimedia.org/wiki/Help:Template
 
*http://meta.wikimedia.org/wiki/Help:Template
*[[Help:Style]]
 

Latest revision as of 12:23, 30 April 2016

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