Edición de «Plantilla:Cita/doc»

{{Subpágina de documentación}}
{{Plantilla con TemplateStyles|Cita/styles.css}}
Esta plantilla sirve para generar bloques de citas de texto.

=== Uso ===
{{epc|1=cita|2=<span style="font-family:serif;font-style:italic;color:#666;">texto a citar</span>|3=<span style="font-family:serif;font-style:italic;color:#666;">autor</span>}}

El último parámetro es opcional. El texto citado no debe ir en cursivas ni entrecomillado, pues este ya está enmarcado.

Por ejemplo, {{epc|cita|El juicio de amparo únicamente puede promoverse por la parte a quien perjudique la ley…|Artículo 4º, Ley de Amparo.}} se ve así:
{{cita|El juicio de amparo únicamente puede promoverse por la parte a quien perjudique la ley…|Artículo 4.º, Ley de Amparo.}}

Para poner texto a dos columnas (útil con frecuencia para acompañar un texto de su traducción), basta con pasar el contenido de la segunda columna en el parámetro opcional '''{{param|col2}}'''.

Por ejemplo, {{epc|1=cita|2=Ὦ ξεῖν’, ἀγγέλλειν Λακεδαιμονίοις ὅτι τῇδε&lt;br />κείμεθα, τοῖς κείνων ῥήμασι πειθόμενοι|3=col2=Extranjero, informa a los espartanos, que aquí&lt;br />yacemos obedeciendo a sus preceptos.|4=Lápida conmemorativa escrita por el poeta <nowiki>[[Simónides de Ceos]]</nowiki>}} se ve así:

{{cita|Ὦ ξεῖν’, ἀγγέλλειν Λακεδαιμονίοις ὅτι τῇδε<br />κείμεθα, τοῖς κείνων ῥήμασι πειθόμενοι|col2=Extranjero, informa a los espartanos, que aquí<br />yacemos obedeciendo a sus preceptos.|Lápida conmemorativa escrita por el poeta [[Simónides de Ceos]]}}

En algunos casos muy específicos se requiere una tercera columna, la cual también puede indicarse mediante el parámetro opcional '''{{param|col3}}'''.

; Recomendaciones
En el caso de que el contenido de la cita se distribuya en varias líneas o párrafos, es recomendable englobar dicho contenido mediante un bloque {{tag|div|contenido=...}}.
: {| style="width:100%;"
! Código
! Resultado
|- style="vertical-align:top;"
| <syntaxhighlight lang="text">
{{Cita|
<div>
Estos son elementos de ejemplo: <br>
a) Primero <br>
b) Segundo <br>
c) Tercero <br>
</div>
}}
</syntaxhighlight>
|
{{Cita|
<div>
Estos son elementos de ejemplo: <br>
a) Primero <br>
b) Segundo <br>
c) Tercero <br>
</div>
}}
|}

Para el uso de poemas es aconsejable englobar el contenido entre etiquetas {{xtag|poem}}, que permite escribir el poema sin la necesidad de definir los saltos de línea con etiquetas {{tag|br|simple}}.

: {| style="width:100%;"
! Código
! Resultado
|- style="vertical-align:top;"
| <syntaxhighlight lang="text">
{{Cita|
<poem>
Primera línea
Segunda línea
Tercera línea
</poem>
}}
</syntaxhighlight>
|
{{Cita|
<poem>
Primera línea
Segunda línea
Tercera línea
</poem>
}}
|}

'''Nota: caracteres de control'''<br />
En el caso de que el texto citado o el nombre del autor contengan los caracteres <code>=</code> o <code>|</code>, para que la plantilla funcione correctamente <u>es necesario sustituirlos</u> respectivamente por las expresiones <code><nowiki>{{=}}</nowiki></code> y <code><nowiki>{{!}}</nowiki></code>

== Redirecciones ==
* {{epr|Epígrafe}}
* {{epr|Quote}}

== Véase también ==
* {{ep|Caja de cita}}

== TemplateData ==
<templatedata>
{
	"params": {
		"1": {
			"label": "Cita",
			"description": "Texto a citar",
			"type": "content",
			"required": true,
			"aliases": [
				"text"
			]
		},
		"2": {
			"label": "Autor",
			"description": "Autor de la cita",
			"type": "content",
			"aliases": [
				"source"
			]
		},
		"col2": {
			"label": "Segunda columna",
			"description": "Para poner texto a dos columnas (útil con frecuencia para acompañar un texto de su traducción), pon el texto de la segunda columna aquí.",
			"type": "content"
		},
		"col3": {
			"label": "Tercera columna",
			"description": "Para poner texto a tres columnas (útil para acompañar un texto de su traducción y una grafía adicional), pon el texto de la tercera columna aquí.",
			"type": "content"
		},
		"estilo": {
			"label": "Estilo",
			"description": "Estilo de la caja de la cita",
			"example": "background-color: red; font-size: 140%;"
		}
	},
	"description": "Úsala para introducir citas textuales en un bloque preformateado",
	"paramOrder": [
		"1",
		"2",
		"col2",
		"col3",
		"estilo"
	]
}
</templatedata>
<includeonly>
[[Categoría:Wikipedia:Plantillas de referencias]]
</includeonly>