Ver el código de «Plantilla:Código/doc»

{{Documentation subpage}}

==Uso==
Esta plantilla envuelve un fragmento corto de texto en etiquetas de <code><nowiki><syntaxhighlight></nowiki></code> (véase [[mw:Extension:SyntaxHighlight]]). Esta plantilla debe usarse para fragmentos cortos; para contenido más largo se debe usar {{tag|pre}} o {{tag|syntaxhighlight}}. Véase [[Ayuda:Wikitexto]] para obtener una explicación de lo que hacen las distintas etiquetas.

Si el contenido incluye un signo igual (=), se debe especificar el parámetro explícitamente: <code><nowiki>{{código|1=fecha=30 de febrero de 2010}}</nowiki></code>.

La plantilla usa la etiqueta <code><nowiki><syntaxhighlight></nowiki></code> con el atributo <code>inline=1</code>. Esto funciona como la combinación de las etiquetas <code><nowiki><code></nowiki></code> y <code><nowiki><nowiki></nowiki></code>, aplicadas al wikitexto expandido. Por ejemplo, <code><nowiki>{{código|'''wikitexto'''}}</nowiki></code> '''''no''''' representará la palabra "wikitexto" en negrita, sino que la mostrará con tres comillas simples:

:{{código|'''wikitexto'''}}

Sin embargo, <code><nowiki>{{código| {{Plantilla:Ejemplo}} }}</nowiki></code> seguirá invocando la plantilla:

:{{code| {{Plantilla:Ejemplo}} }}

Para evitar este problema, se debe usar {{tag|nowiki}} alrededor de la plantilla: 

:{{código|<nowiki>{{Plantilla:Ejemplo}}</nowiki>}}

Cuando se usa en línea con el texto regular, <code><nowiki>{{código}}</nowiki></code> generalmente se ve mejor y es más fácil de leer cuando está explícitamente separado del texto regular. Por ejemplo, la línea:
:{{código|foo &nbsp;<nowiki>{{código|bar baz}}</nowiki>&nbsp; quux.}}
está bien espaciada:
:foo &nbsp;{{código|bar baz}}&nbsp; quux.
mientras que:
:{{código|foo <nowiki>{{código|bar baz}}</nowiki> quux.}}
resultaría visualmente confusa para muchos:
:foo {{código|bar baz}} quux.
ya que "foo" y "{{código|bar}}" parecerán estar más estrechamente asociados que "{{código|bar}}" y "{{código|baz}}". El ancho del carácter de espacio en una fuente monoespaciada casi siempre es mayor que en una fuente proporcional.

Para especificar un idioma para [[mw:Extension:SyntaxHighlight GeSHi]], se usa el parámetro {{{2}}} (sin nombre, como <code>|2=</code>, o más explícitamente como <code>|lang=</code>). Esta opción está predeterminada en texto sin formato, es decir, sin resaltado.

===Ejemplos===
* <code><nowiki>Lorem {{code|ipsum '''dolor'''}} sit amet</nowiki></code>: Lorem {{code|ipsum '''dolor'''}} sit amet

* <code><nowiki>La declaración {{code |lang=cpp |int foo(const std::string& bar, const std::vector<long double*>& baz);}} es el prototipo de una función definida más adelante.</nowiki></code>: La declaración {{código |lang=cpp |int foo(const std::string& bar, const std::vector<long double*>& baz);}} es el prototipo de una función definida más adelante.

* <code><nowiki>Si el código contiene un [[signo igual]], como {{code |lang=javascript |code=var img = document.getElementsByTagName("img");}}, se debe identificar el primer parámetro explícitamente como {{{1}}} o {{{code}}}; véase también bugzilla:5138.</nowiki></code>: Si el código contiene un [[signo igual]], como {{código |lang=javascript |code=var img = document.getElementsByTagName("img");}}, se debe identificar el primer parámetro explícitamente como {{{1}}} o {{{code}}}; véase también [[:bugzilla:5138]].

===Plantillas incluidas===
Las plantillas incrustadas no funcionan dentro de {{tl|código}}. Para bloques de código de forma libre más largos, que pueden contener plantillas como {{tl|var}}<!---y {{tl|samp}}--->, es preferible usar {{tag|code}} como contenedor en lugar de esta plantilla.

Las plantillas utilizadas dentro de {{tl|código}} exponen el HTML renderizado, lo que puede ser útil. Por ejemplo:

* <code><nowiki>{{código|
{{cita web |título=Título |url=http://example.org}}
}}</nowiki></code>
queda como:
* {{código| {{cita web |título=Título |url=http://example.org}} }}

El ejemplo anterior muestra el HTML representado por la plantilla de cita, incluyendo los metadatos ocultos.

== TemplateData ==
{{Encabezamiento de TemplateData}}
<templatedata>
{
	"description": "Una plantilla para vincular una categoría de Commons sobre un artículo",
	"params": {
		"1": {
			"label": "Código",
			"description": "El código a usar.",
			"type": "content",
			"required": true,
			"aliases": ["code"]
		},
		"2": {
			"label": "Lenguaje",
			"description": "El lenguaje de programación.",
			"type": "string",
			"aliases": ["lang", "texto"]
		},
		"class": {
			"label": "Clase",
			"description": "Clase CSS",
			"type": "string"
		},
		"style": {
			"label": "Estilo",
			"description": "Clase CSS",
			"type": "string"
		},
		"id": {
			"label": "Estilo",
			"description": "",
			"type": "string"
		}
	}
}
</templatedata>

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
[[Categoría:Hispanopedia:Plantillas de formato de texto]]
}}</includeonly>