Help:Template (Español)
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:Note (Español):
{{Note (Español)|Este texto sirve como nota.}}
que se visualiza:
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.
{{!}}
.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: {{Tip (Español)|1=https://archlinux.org/?foo=bar}}
Resultado:
Esto es muy útil a la hora de:
- Definir variables.
- Enlaces externos con cadenas de consulta en URLs.
- Órdenes y cadenas de intérprete de línea de órdenes.
- Líneas de código.
Los caracteres de espacio en blanco (es decir, líneas nuevas) se eliminan automáticamente del principio y el final de los valores de parámetros con nombre. Para conservar los espacios en blanco, comience el valor del parámetro con una etiqueta <nowiki/>
.
Este ejemplo:
{{Tip (Español)|1=<nowiki/> * https://archlinux.org/?foo=bar * https://archlinux.org/?foo=baz }}
Tiene como resultado:
Parámetros múltiples
- Utilizar parámetros de posición
1
y2
{{hc|1=$ echo "="|2==}}
Resultado:
$ echo "="
=
- Utilizar parámetros de nombres
head
youtput
{{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 :
{{Tip (Español)|<nowiki>= | }} https://archlinux.org/ {{ic|foo}}</nowiki>}}
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 :
{{Tip (Español)|<nowiki>= | }}</nowiki> https://archlinux.org/ {{ic|foo}}}}
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 :
{{Tip (Español)|= | {{ }}}}
Creación
- El espacio de nombres de la plantilla está semiprotegido. Solo los usuarios autoconfirmados pueden crear o editar plantillas.
- 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 El modo Arch: ¡Manténgalo simple, estúpido!
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.
Para hacer pruebas
Plantillas sobre el estado del artículo
Estas plantillas deben agregarse al comienzo de los artículos o secciones correspondientes. Véase también Help:Style (Español)#Plantillas del estado del artículo.
Los traductores también deben consultar las pautas de la plantilla en ArchWiki:Translation Team (Español).
Las páginas marcadas con las plantillas de estado del artículo se rastrean en la categoría de mantenimiento correspondiente y en las ArchWiki:Statistics#Maintenance statistics.
Nombre | Uso recomendado | Parámetros |
---|---|---|
Template:Style | Contenido con problemas de idioma, sintaxis wiki o estilo. | 1 — razón, 2 — página de discusión opcional, section — sección opcional en la página de discusión predeterminada
|
Template:Accuracy | Contenido incorrecto, engañoso o confuso. | |
Template:Expansion | Contenido incompleto. | |
Template:Out of date | Contenido obsoleto. | |
Template:Remove | Contenido irrelevante o inútil. | |
Template:Archive | Páginas obsoletas. | |
Template:Laptop style | Páginas Laptop que no siguen las Directrices de la página de la computadora portátil. | |
Template:Translateme (Español) | Traducciones incompletas. | |
Template:Bad translation (Español) | Traducciones problemáticas. | |
Template:TranslationStatus (Español) | Estado de las traducciones. | 1 — título original, 2 — fecha de la traducción/revisión, 3 — número de revisión
|
Template:Merge | El contenido se superpone con otro artículo. | 1 — página destino, 2 — razón, 3 — página de discusión opcional, section — sección opcional en la página de discusión predeterminada
|
Template:Move | Renombrar la página, mover la sección a otro artículo. | |
Template:Redirect | Redirigir la página a otro artículo. | |
Template:Unsupported | Páginas de usuario no soportadas por Arch Linux. | 1 — fecha de la última revisión por el autor de la página
|
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.
- └─> Utilice Template:Related2 si desea traducir el título del enlace.
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:Note (Español) en las traducciones.
- └─> Utilice Template:Tip (Español) en las traducciones.
- └─> Utilice Template:Warning (Español) en las traducciones.
Para usar en borradores en páginas de discusión solamente:
- └─> Utilice Template:Comment (Español) en los borradores en español.
Plantillas misceláneas
Las plantillas en inglés deben sustituirse por las correspondientes en español (si las hubiere):
- └─> Utilice Template:Broken package link (Español) en las traducciones.
- └─> Utilice Template:Broken section link (Español) en las traducciones.
- └─> Utilice Template:Dead link (Español) 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:
Nombre | Marcado Wiki | Resultado |
---|---|---|
Template:Yes (Español) | {{Yes (Español)}} |
Sí |
{{Yes (Español)|https://wiki.archlinux.org/}} |
Sí | |
Template:No | {{No}} |
No |
{{No|https://wiki.archlinux.org/}} |
No | |
Template:- | {{-}} |
– |
| colspan=2 {{Yes (Español)}}
.Plantillas de Categorías
- └─> Utilice Template:Cat main (Español) en las traducciones.