View source for Template:ES:Tag/doc

<noinclude>{{Mbox|type=notice|image=[[File:Edit-copy green.svg|40px|link=]]
    |style=font-size:.875rem
    |text='''Esta es una [[w:mw:Help:Subpáginas|subpágina]] de [[w:es:Wikipedia:Documentación de las plantillas de mantenimiento|documentación]] para {{{1|[[:{{Template:BASEPAGENAME|ns={{SUBJECTSPACE}}:}}]]}}}.'''<br /> Contiene información sobre su uso, [[w:es:Wikipedia:Categorización|categorías]] y otros contenidos o metadatos que no son parte de la plantilla original.}}</noinclude>

{{info|Esta plantilla funciona igual que la plantilla {{t|Tag}}, pero con el español como idioma predeterminado.}}

Esta plantilla se usa para representar una [[ES:Tags|clave]] de datos de [[ES:Acerca de OpenStreetMap|OpenStreetMap]] o una pareja clave-valor. Los elementos del contenido se enlazan automáticamente con las páginas wiki correspondientes.

== Uso ==
La plantilla se puede usar en una amplia variedad de formas. Las más sencillas y más comúnmente empleadas son:

{|class="wikitable"
|-
!scope="col"|Descripción
!scope="col"|Ejemplo de wikitexto
!scope="col"|Resultado
|-
|Una sola clave
|<code><nowiki>{{Tag|highway}}</nowiki></code>
|{{Tag|highway}}
|-
|Una pareja clave-valor específica
|<code><nowiki>{{Tag|highway|residential}}</nowiki></code>
|{{Tag|highway|residential}}
|-
|Una clave con un valor literal genérico (sin hiperenlace)
|<code><nowiki>{{Tag|bridge||yes}}</nowiki></code>
|{{Tag|bridge||yes}}
|-
|Una clave con una descripción de valor
|<code><nowiki>{{Tag|ref||''número de referencia''}}</nowiki></code>
|{{Tag|ref||''número de referencia''}}
|}

===Claves multiparte===
Algunos nombres de claves pueden tener varias partes, a menudo asociadas a [[ES:Namespace|espacios de nombres]] de claves. Un ejemplo de ello son las claves asociadas a [[ES:Addresses|direcciones]]: la clave {{key|addr:housenumber}} se usa para especificar un número de portal, {{key|addr:street}} se usa para especificar el nombre de una calle, etc. Esta plantilla ofrece la posibilidad de elegir entre varios enfoques sobre cómo se formatean las distintas partes de una clave multiparte: mientras que el texto en sí sigue siendo el mismo, la forma en que se enlazan las partes difiere.
* '''enlace simple a una página de subclave'''
*: Este enfoque trata la clave compuesta como una sola entidad y enlaza con la página wiki que describe esa clave compuesta.
*:: <code><nowiki>{{Tag|building:fireproof}}</nowiki></code>
*: genera un enlace simple a la página wiki [[{{LL|Key:building:fireproof}}]], tal como:
*:: {{Tag|building:fireproof}}
*: Este enfoque es más útil cuando una clave compuesta se describe en su propia página, como, por ejemplo, [[{{LL|Key:building:fireproof}}]] o [[{{LL|Key:addr:flats}}]].

* '''enlace simple a una página de clave principal''': El siguiente texto wiki:
*:: <code><nowiki>{{Tag|addr|subkey=housenumber}}</nowiki></code>
*: genera un enlace simple a la página wiki principal [[{{LL|Key:addr}}]], tal como:
*:: {{Tag|addr|subkey=housenumber}}
*: Este enfoque es más útil cuando una colección de subclaves se describe en la página wiki de la propia clave principal, como, por ejemplo, [[{{LL|Key:addr}}]].

* '''varios enlaces a páginas de clave principal'''
*:: <code><nowiki>{{Tag|oneway|:=bicycle}}</nowiki></code>
*: genera enlaces independientes a cada una de las páginas wiki principales [[{{LL|Key:oneway}}]] y [[{{LL|Key:bicycle}}]], tal como:
*:: {{Tag|oneway|:=bicycle}}
*: y:
*:: <code><nowiki>{{Tag|cycleway|:=right|::=smoothness}}</nowiki></code>
*: genera enlaces independientes a cada una de las páginas wiki principales [[{{LL|Key:cycleway}}]], [[{{LL|Key:right}}]] y [[{{LL|Key:smoothness}}]], tal como:
*:: {{Tag|cycleway|:=right|::=smoothness}}
*: Este enfoque es más útil cuando cada una de las partes de la clave es en sí misma una clave principal, como, por ejemplo, {{Tag|oneway|:=bicycle}}, donde tanto [[{{LL|Key:oneway}}]] como [[{{LL|Key:bicycle}}]] están presentes.

===Valores múltiples===
Algunas claves pueden tener especificados varios valores, con cada uno de ellos separado por un signo de punto y coma (;). Se pueden especificar hasta dos valores adicionales con esta plantilla, tal como:
{|class="wikitable"
|-
!scope="col"|Ejemplo de wikitexto
!scope="col"|Resultado
|-
|<code><nowiki>{{Tag|motor_vehicle|agricultural|;=forestry}}</nowiki></code>
|{{Tag|motor_vehicle|agricultural|;=forestry}}
|-
|<code><nowiki>{{Tag|access|agricultural|;=forestry|;;=destination}}</nowiki></code>
|{{Tag|access|agricultural|;=forestry|;;=destination}}
|}

=== Enlaces de destino predeterminados a sitios externos para valores de claves específicos ===
Algunas claves como {{Tag|wikipedia}}, {{Tag|wikidata}} o {{Tag|website}} pueden crear enlaces externos, en cuyo caso se mostrarán sus valores en el parámetro 3 (en lugar de mostrar solo un asterisco) junto con su enlace específico según su valor; sin embargo, cuando el valor es la URL completa de un sitio web, a diferencia de otros valores de etiquetas (que generalmente son cortos), se permite que ese valor se ajuste cuando es demasiado largo para caber en una línea (esto evita que las columnas de las tablas de características excedan un ancho máximo razonable).

Solo unas pocas claves reconocen esta funcionalidad:
{| class='wikitable'
|-
!scope="col"|Ejemplo de wikitexto
!scope="col"|Resultado
|-
|<code><nowiki>{{Tag|wikipedia||fr:Paris}}</nowiki></code>
|{{Tag|wikipedia||fr:Paris}}
|-
|<code><nowiki>{{Tag|wikipedia|subkey=fr||Paris}}</nowiki></code>
|{{Tag|wikipedia|subkey=fr||Paris}}
|-
|<code><nowiki>{{Tag|wikipedia|subkey=en||Paris}}</nowiki></code>
|{{Tag|wikipedia|subkey=en||Paris}}
|-
|<code><nowiki>{{Tag|wikidata||Q90}}</nowiki></code>
|{{Tag|wikidata||Q90}}
|-
|<code><nowiki>{{Tag|website||http://www.paris.fr/}}</nowiki></code>
|{{Tag|website||http://www.paris.fr/}}
|}

Para todas las demás claves, el tercer parámetro se muestra tal cual, sin intentar convertirlos en nuevos enlaces externos. Esta funcionalidad tampoco se usa cuando el valor se especifica en el segundo parámetro (donde se emplea para generar enlaces internos, si es posible).

== Enlaces a páginas no inglesas ==
Aunque la acción predeterminada de la plantilla es enlazar con páginas en el mismo idioma que el actual, es posible especificar que se use un idioma diferente. El parámetro '''kl''' se usa para especificar el idioma del enlace a la página de clave de destino, y el '''vl''' para especificar el idioma del enlace del valor. En cada caso, se usa un código de idioma estándar.

Cuando una clave contiene varias partes que se enlazan por separado, los parámetros '''kl:''' y '''kl::''' especifican el idioma para el segundo y tercer enlace, respectivamente. Cuando un valor contiene varias partes, el parámetro '''vl2''' especifica el idioma para el segundo enlace.

Los siguientes ejemplos ilustran esto.
{|class="wikitable"
|-
!scope="col"|Ejemplo de wikitexto
!scope="col"|Resultado
|-
| <tt><nowiki>{{Tag|kl=de|highway|motorway}}</nowiki></tt>
| {{Tag|kl=DE|highway|motorway}}
|-
| <tt><nowiki>{{Tag|highway|vl=de|motorway}}</nowiki></tt>
| {{Tag|highway|vl=DE|motorway}}
|-
| <tt><nowiki>{{Tag|highway|motorway|kl=de|vl=de}}</nowiki></tt>
| {{Tag|highway|motorway|kl=de|vl=de}}
|-
| <tt><nowiki>{{Tag|cycleway|:=right|::=smoothness|excellent|kl=de|kl:=de|kl::=de}}</nowiki></tt>
| {{Tag|cycleway|:=right|::=smoothness|excellent|kl=de|kl:=de|kl::=de}}
|}

<includeonly>{{#if:{{{nocat|}}}||
[[{{LLC|Plantillas para mapear objetos}}|Tag]]
}}</includeonly>
<includeonly>
<templatedata>
{
	"params": {
		"1": {
			"label": {
				"cs": "klíč",
				"en": "key",
                "es": "clave"
			},
			"description": {
				"cs": "Klíč značka (ta část před rovnítkem)",
				"en": "key of the tag (the part before =)",
                "es": "clave de la etiqueta (la parte antes de =)"
			},
			"example": {
				"cs": "highway",
				"en": "highway",
                "es": "highway"
			},
			"type": "string",
			"required": true
		},
		"2": {
			"label": {
				"cs": "hodnota",
				"en": "value",
                "es": "valor"
			},
			"description": {
				"cs": "hodnota klíče (část značky za rovnítkem)",
				"en": "value of the key (the part after =)",
                "es": "valor de la clave (la parte después de =)"
			},
			"example": {
				"cs": "residential",
				"en": "residential",
                "es": "residential"
			},
			"type": "string"
		},
		"3": {
			"label": {
				"cs": "popis hodnoty",
				"en": "unlinked value/description",
                "es": "valor/descripción no enlazado"
			},
			"description": {
				"cs": "popis hodnoty - nebude linkován (chcete-li použít, musíte vynechat druhý parametr)",
				"en": "description of value which should not be linked as value would be. Second parameter should be left blank for this to work.",
                "es": "descripción del valor que no debe ser enlazado como valor. El segundo parámetro debe dejarse en blanco para que funcione."
			},
			"example": {
				"cs": "typ cesty"
			},
			"type": "string"
		}
	},
	"description": {
		"cs": "značka (key) nebo dvojice značka=klíč. Základní příklady: {{Tag|highway}}, {{Tag|highway|residental}} , {{Tag|ref||''referenční číslo''}}.",
        "en": "Key or key=value pair. Links automatically to appropriate wiki pages. ",
        "es": "Clave o pareja clave=valor. Enlaza automáticamente a la página wiki correspondiente. "
	},
	"format": "inline"
}
</templatedata>
</includeonly>

== Véase también ==
* {{T|TagKey}} [[Template:TagKey]] - para mostrar solo la clave
* {{T|TagValue}} [[Template:TagValue]] - para mostrar solo el valor
* {{T|Value}} [[Template:Value]] - marca con fondo azul claro y letra de imprenta, parecida al código
* {{T|LL}} [[Template:LL]] – nombre completo de una página especifica traducida al idioma usado en la página que se visualiza actualmente, similar a esta plantilla pero para todas las páginas
* {{T|Role}} [[Template:Role]] - marca con fondo azul claro y letra de imprenta, parecida al código

{{Languages|Template:Tag}}
{{Translated|revision=2001088}}
{{Traducido|2021-10-30}}
<includeonly>
[[Category:ES:Plantillas de enlace]]
</includeonly><noinclude>
[[Category:ES:Páginas de documentación de plantilla]]
</noinclude>