Help:TemplateData/es

 es una extensión que almacena información y parámetros asociados a una plantilla wikitexto y la pone a disposición de una interfaz de edición que puede recuperarla y presentarla en un editor de plantillas -- todo lo cual ayuda a los usuarios a añadir y editar plantillas en las páginas.

Desde abril de 2019, TemplateData forma parte de la experiencia de usuario predeterminada para todos los usuarios de todos los wikis de Wikimedia cuando añaden una plantilla, incluidos los usuarios no registrados. Tanto los editores de fuente por defecto como los visuales lo incorporan de alguna manera, al igual que muchos scripts, herramientas y gadgets. Si quieres esta funcionalidad en tu propia wiki, instala.

Añadir TemplateData a una plantilla consiste básicamente en insertar un bloque pequeño de código JSON (explicado más abajo) en la página de documentación de la plantilla. Puede hacerlo manualmente o con el editor TemplateData, una interfaz de usuario gráfica ubicada en las secciones «Editar»/«Editar código» de páginas de plantillas en wikis con la extensión TemplateData instalada. El JSON contiene una lista de los parámetros de la plantilla e información sobre esos parámetros y sobre la plantilla en su conjunto (ver más abajo para más detalles).

Las plantillas que contienen TemplateData mostrarán esta información en la interfaz de usuario cuando un usuario añada la plantilla. En algunos casos, cambiará la forma en que se comporta el editor cuando se utiliza para editar o insertar una plantilla determinada, facilitando a los usuarios los pasos necesarios para añadir una plantilla determinada.

Historia
Los datos de plantilla se desarrollarón originalmente a principios de 2013 con $ 1 en mente, que estaba en etapas de prueba de MediaWiki en ese momento. VisualEditor es la principal interfaz de edición visual para los wikis de Wikimedia, y TemplateData le permitió tener una interfaz más útil al añadir plantillas. Fue soportado oficialmente por VisualEditor inmediatamente. A medida que VisualEditor se desplegó en las principales wikis de Wikimedia como una característica por defecto desde 2013 hasta 2016, TemplateData se convirtió en una parte de ellos también.

En diciembre de 2016, la interfaz de VisualEditor se puso a disposición para editar el código fuente como una función beta. Esto se denominó el. Esto trajo las características de TemplateData a la edición de fuentes por primera vez.

En marzo de 2018, Sam Wilson desarrolló, una extensión del editor de plantillas de la interfaz gráfica de usuario para el editor de fuentes predeterminado de Wikimedia, (también conocido como el editor de wikitextos de 2010), diseñado para facilitar el proceso de adición de plantillas utilizando la información de TemplateData. En Abril 2019, TemplateWizard se convirtió en una parte por defecto del editor de wikitexto de 2010 en todos los wikis de Wikimedia. Esto significaba que TemplateData era ahora una parte por defecto tanto del editor visual como del editor de fuentes en los wikis de Wikimedia.



Agregar o editar TemplateData
Para añadir o editar TemplateData, primero navegue a la página de una plantilla, situada en "/Template:Templatename".



Comprobar el estado actual
Antes de agregar o editar datos de la plantilla, verifique si la plantilla tiene una documentación de subpágina. Luego verifique si la plantilla ya contiene datos de plantilla y, de ser así, si se encuentra en la página de la plantilla o en la subpágina de documentación.



Documentación de subpáginas
Hay dos formas principales en que las plantillas en la mayoría de los wikis de Wikimedia almacenan sus notas de uso y otros datos que no deberían incluirse en la propia plantilla, como las categorías en las que debería estar la plantilla:


 * La gran mayoría de las plantillas guardan notas de uso y otros datos que no pertenecen a la propia página de la plantilla en una subpágina de documentación: '/Template:Templatename/doc'. En páginas como esta, la plantilla de {{}} transcluye todo el contenido de la página /doc en la página de la plantilla, manteniendo el código fuente de la plantilla mucho más limpio.
 * En las plantillas con subpáginas de documentación, el encabezado 'Test Template Info-Icon - Version (2).svg Documentación de la plantilla' estará seguido de enlaces como [ver], [editar], [historial] y [purgar].


 * Algunas páginas de plantilla han conservado esa información en la página principal de la plantilla. Puede detectarlo en estas páginas buscando una ocurrencia de  entre las etiquetas de.

Diferentes wikis pueden presentar todo esto de manera diferente. En raras ocasiones, las páginas de la plantilla principal aún pueden contener documentación incluso cuando hayan verificado todo lo anterior; aquí, un usuario habrá agregado un título de página /doc personalizado entre ' ' y ' ' y luego habrá agregado contenido después de ' '.

También puede buscar un aviso en la parte inferior de la página similar a este: 'La documentación anterior se incluye de Plantilla:Templatename/doc'.



Plantillas sin subpáginas de documentación
Si una plantilla no tiene una subpágina de documentación, créela y mueva allí la documentación de la plantilla (o un marcador de posición). Luego puede agregar datos de plantilla a la subpágina de documentación.



Creando la subpágina y moviendo la documentación
Para crear la subpágina de documentación, haga clic en / en la página principal de la plantilla; busque las etiquetas de y su contenido (generalmente en la parte inferior).

Debería verse algo como esto:

También puede encontrar que ya contiene datos de plantilla. Si es así, se verá algo como esto:

Selecciona todo lo que esté después de ' ' y antes de '' y córtalo en tu portapapeles o guárdalo en un documento temporal. Eliminar ' ', dejando solo lo siguiente:

Guarde la página de la plantilla.

Ahora, para crear la nueva subpágina, mire la barra de direcciones de su navegador y agregue /doc al final de la URL. Presione Enter, luego elija la opción para crear una nueva página.

Si este wiki tiene una plantilla de aviso de {{}}, agréguela en la parte superior de la nueva página. También es posible que desee agregar otras plantillas, como un enlace de $ 1 o $ 2 (si el wiki en cuestión lo admite). Consulte m:Help:Template documentation para obtener más información.

Inserte el texto que cortó o guardó en el texto anterior (debajo de la plantilla de aviso, si corresponde).

Envuelva cualquier categoría en etiquetas de para que se apliquen solo a la página principal de la plantilla:

Muchos wikis tienen una plantilla de. Utilice esta plantilla aquí si es que la plantilla que está editando o exista en una versión de sandbox (ubicada en 'Template:Templatename/sandbox') para evitar que las categorías se apliquen a la página de sandbox:

Finalmente, publique la página.

Ahora puede agregar y editar los datos de la plantilla en la subpágina de documentación siguiendo las instrucciones descritas en #Methods.



Agregar y editar datos de plantilla en la página de plantilla principal
Si no puede crear la página /doc, puede agregar y editar los datos de la plantilla en la página principal de la plantilla siguiendo las instrucciones en #Methods.

Si una plantilla tiene una subpágina de documentación, compruebe tanto la página principal como la subpágina de documentación para ver si hay datos de la plantilla (la etiqueta seguida de una matriz entre corchetes:  ).

Alternativamente, la extensión TemplateData puede realizar esta verificación por usted. Haga clic en  o  en cualquiera de las páginas. Si la plantilla ya tiene datos de plantilla en cualquiera de las páginas, verá un aviso amarillo en la parte superior de la página que dice:



o

Si la plantilla tiene datos de plantilla en su subpágina de documentación

Si la plantilla tiene datos de plantilla en su subpágina de documentación, esta es la página que debe editar. Puede hacer esto haciendo clic en '[editar]' ubicado después del encabezado ' Documentación de plantilla' (o similar), o, si ya está en la página /doc, haciendo clic en  o  en la parte superior. Siga las instrucciones en #Methods para agregar o editar los datos de la plantilla.

Si la plantilla tiene datos de plantilla en su página principal

Si la plantilla tiene datos de plantilla en su página principal, nuevamente tiene dos opciones:


 * Puede pasar a su subpágina de documentación. Esta es la opcion preferida.


 * O bien, puede editarlo en la página principal de la plantilla.

Mover datos de plantilla a la subpágina de documentación

Para hacer esto, haga clic en / en la página principal de la plantilla y busque las etiquetas de, encerradas dentro de las etiquetas de. Debería verse algo como esto:

Corte solo las etiquetas de y su contenido del código, luego guarde la página.

A continuación, edite la subpágina de documentación haciendo clic en '[edit]' ubicado después del título ' Documentación de plantilla' (o similar).

Escriba un encabezado, como 'Datos de la plantilla', luego, debajo, pegue los datos de la plantilla.

Ahora puede editar los datos de la plantilla según la guía en #Methods.

Edición de datos de plantilla en la página de plantilla principal

Si no desea mover los datos de la plantilla a la página /doc, puede editarlos en la página principal de la plantilla. Consulte #Methods para saber cómo editar los datos de la plantilla.

Si la plantilla aún no tiene datos de plantilla pero tiene una subpágina de documento

Si la plantilla aún no tiene datos de plantilla, debe agregarlos a la subpágina de documentación.

Haga esto haciendo clic en '[editar]' ubicado después del encabezado ' Documentación de plantilla' (o similar), o, si ya está en la página /doc, haciendo clic en '' o ' ' en la cima. Escriba un encabezado, como 'Datos de la plantilla', luego, debajo, pegue los datos de la plantilla. Consulte #Methods para saber cómo editar los datos de la plantilla.

Métodos


Editor de TemplateData
Esta es una forma sencilla de agregar o editar datos de plantilla, recomendada para usuarios menos experimentados.

El editor de TemplateData es una intefaz gráfica de usuario para añadir y editar TemplateData. Es parte de la extensión TemplateData, disponible en la página de cualquier plantilla (o subpágina de documentación) haciendo clic en  o .

Tras pulsar el botón "" o "", verás un botón encima del área de edición y título de la página que dice "".

|453px

Pulsando este botón te llevará al Editor de TemplateData. Si la página en la que te encuentras ya contiene un bloque de TemplateData, aparecerá de forma automática la información ya documentada.

600px|La herramienta de edición TemplateData, en una página que todavía no contiene TemplateData.

Características en la ventana de arriba:


 * El elemento superior elige el idioma del texto de la interfaz. Le permite ingresar contenido de texto en varios idiomas, que se muestra a los usuarios según su configuración en Preferencias, no según el idioma de la wiki; diferentes wikis tienen bases de datos de plantillas completamente diferentes. Si no existen datos de plantilla de idioma, la interfaz solo ofrecerá a los usuarios el idioma base de la wiki, pero los usuarios pueden hacer clic en '' para agregar más entradas. El código de idioma se muestra entre paréntesis junto a los parámetros a los que se puede aplicar, como descripciones y etiquetas.
 * El siguiente elemento es la descripción de la plantilla. Esta es la descripción de la plantilla en su conjunto; se muestra a los usuarios en numerosos lugares en los editores de plantillas al agregar una plantilla. Este parámetro y sus efectos se describen aquí.
 * El tercer elemento controla el formato de wikitexto de la plantilla. Este parámetro determina cómo se distribuirá el wikitexto cuando el usuario haga clic en "", siendo los dos tipos principales  (en una línea) y   (en nuevas líneas). Este parámetro y sus efectos se describen aquí.
 * Si el usuario elige , puede ingresar wikitexto en  según las reglas descritas aquí, para crear un diseño personalizado para la plantilla cuando el usuario haga clic en ''.


 * El cuarto elemento configura los parámetros de una plantilla. Si los parámetros ya se han definido en los datos de la plantilla, esta área los muestra en una lista. Si el código fuente de la plantilla especifica parámetros para los que no existen datos de plantilla, es posible que vea un botón con la etiqueta "". El editor extrae estas sugerencias del código fuente de la plantilla buscando  o  . Al hacer clic en "" se agregarán estos parámetros usando sus nombres como se define en el código fuente. También aparecerá un aviso verde en la parte superior, por ejemplo, ''.
 * En la parte inferior de la ventana verá un botón "". Esto le permite agregar un parámetro manualmente con un nombre personalizado.

Continúe con el paso siguiente haciendo clic en cualquiera de los parámetros de la lista. Esto le permitirá editar la información de ese parámetro.

600px

Todas estas funciones y sus efectos se describen en la sección #Dentro del nombre de un parámetro.

Cuando haya terminado, haga clic en "". Esto insertará automáticamente los datos de la plantilla en la parte inferior de la página antes de la etiqueta ; o, si ya está presente, se actualizará con la nueva información sin cambiar su posición. El texto de datos de la plantilla también se seleccionará al hacer clic en "".

El editor de datos de la plantilla crea un parámetro  en la parte inferior de los datos de la plantilla (o lo actualiza si ya existe). contiene los parámetros de datos de plantilla actuales en el orden en que fueron mostrados por el editor de datos de plantilla. Puede cambiar  arrastrando los parámetros hacia arriba y hacia abajo en el editor de datos de plantilla utilizando las tres barras horizontales de la izquierda. y sus efectos se describen aquí.

Después de esto, haga clic en "" para guardar su revisión de la página.



Método manual
También puede agregar o editar datos de plantilla manualmente. La estructura de TemplateData se basa en el estándar JSON. Ten en cuenta que todas las descripciones en TemplateData deben estar en texto plano (sin wikitexto, sin enlaces, etc.). Los datos de la plantilla siguen algunas reglas muy simples y aceptan solo unas pocas docenas de posibles parámetros y valores predefinidos, generalmente siguiendo un formato de.

Agregando datos de plantilla manualmente

Consideraciones:


 * Si está agregando datos de plantilla en la subpágina de documentación de una plantilla (recomendado), puede agregarlos en cualquier parte de la página; verifique si la Wikipedia de su idioma tiene una ubicación preferida para ello. Por ejemplo, en la Wikipedia en inglés, los datos de la plantilla suelen estar cerca de la parte inferior de la página de documentación; en la Wikipedia en alemán, normalmente se encuentra en la parte superior.
 * Si está agregando datos de plantilla en la página principal de una plantilla (no recomendado; consulte #Comprobaciones previas), debe asegurarse de colocarlo dentro de las etiquetas .

Haga clic en "" o "" en la página respectiva, luego desplácese al lugar de la página donde desea agregar datos de plantilla y escriba un encabezado: 'Datos de plantilla'.

Muchos wikis tienen una plantilla TemplateData header que agrega un breve aviso sobre los datos de la plantilla. Si tu wiki lo hace, agrégalo después del encabezado.

Para comenzar a agregar datos de plantilla, escriba una etiqueta de apertura y cierre de y un par de corchetes en las nuevas líneas, con una línea vacía entre ellos:

A continuación, agregue una sangría en la línea vacía entre los dos corchetes y comience a agregar parámetros. Los detalles de los parámetros se pueden encontrar en #Parámetros de datos de plantilla. La mayoría son opcionales; algunos son muy recomendables.

Los parámetros pueden estar en cualquier orden, pero lo que sigue es el orden que mejor se ajusta a la documentación de datos de la plantilla y hace que el contenido sea más fácil de usar para los editores:

Asegúrese de que los parámetros, por ejemplo, en el objeto, permanezcan dentro de ese objeto; de lo contrario, activará un error "" cuando intente guardar.

Ejemplo

Aquí hay algunos datos de plantilla de ejemplo para una plantilla de limpieza hipotética. Dicha plantilla mostraría un aviso y colocaría la página en una categoría fechada según el mes y el año ingresados. El aviso también puede contener un enlace a una sección de la página de discusión. Los datos de la plantilla se verían así:

La documentación de datos de la plantilla correspondiente se mostraría de la siguiente manera:

{	"description": "Utilice esta plantilla para indicar que un artículo necesita limpieza.", "format": "inline", "params": { "date": { "label": "Month and year", "description": "The month and year that the template was added", "type": "string", "autovalue": " ", "example": "January 2013", "suggested": true },		"reason": { "aliases": ["1"], "label": "Reason", "description": "The reason the article is in need of cleanup", "type": "string" },		"talk": { "aliases": ["talksection"], "label": "Talk page section", "description": "The section of the talk page containing relevant discussion", "type": "string" }	},	"paramOrder": [ "date", "reason", "talk" ] }



Descripción y parámetros
All available template data parameters are listed below with a description and example. They are also listed in more technical detail at Extension:TemplateData#Format.

Within a parameter's name
Note: if neither,   nor   are set as   for a parameter, its status will show as   in the template data documentation.

Una vez que hayas terminado, presiona "Guardar". Si hay errores, no se te permitirá guardar, (lo cual puede ser molesto pero se asgura que no se pueda romper nada). Si tienes algun error, explica en la página de comentarios lo qué estabas tratando de hacer y estaremos encantados de ayudarte.

Note that if you are abusing a hack template to dynamically generate template data, it cannot be checked for errors before saving.

Ten en cuenta que cada fragmento de información está entre comillas (a excepción de  y  ), y separado del siguiente por una coma (a menos que sea el último).

Type parameter
El parámetro, está destinado a señalar a un editor de plantillas La naturaleza del valor de un parámetro. In some cases, template editors have been programmed to modify the user interface for a certain parameter according to this template data value, such as to only allow the user to enter valid values that match the specified type. This parameter does not have any functional effect on the template parameter or its value; it merely controls how template editors see and treat the parameter in editing mode.

How to use

It is used by adding the  parameter, followed by a colon and a space, then adding any of the values listed in the table below in quotation marks.

Example:

Effects

As of February 2020, only 5 of the 13 type values have visible effects in VisualEditor and the 2017 wikitext editor, while 8 have visible effects in TemplateWizard.

The effects of certain values are likely to change as the template editors get updates to support them. One such effort for VisualEditor and the 2017 wikitext editor is tracked in the Phabricator task T55613. A similar effort to get TemplateWizard to support the boolean value is tracked in T200664.

The currently known effects are listed as follows.

Formatos personalizados
When editing the  value, you create custom formats by inputting a set of wikitext symbols using some predefined rules.


 * - start of the template
 * - content (e.g., string, integer or parameter). This underscore serves to indicate the minimum length of a value in characters and can be repeated, like . If this length is not reached, it fills the remaining characters with spaces. This can be used to align all equals signs to a specific position after a parameter (if used with   for new lines).
 * - pipe (separates parameters)
 * - equals sign (precedes the value of a parameter)
 * or pressing the enter key - new line (this will display as  in the entry field)
 * - space (can be used with  to indent new lines)
 * - end of the template

The wikitext should at least meet the minimum of, otherwise there will be an invalid format string error.



Texto modelo en blanco
Puedes copiar el texto modelo en blanco para agregar un nuevo TemplateData a una plantilla. Sólo se incluyen las etiquteas más comunes.

/ Bad JSON format
These errors occur when saving template data, usually manually edited, with invalid JSON code (duplicate keys/parameters, trailing or missing commas, etc.) in the visual editor or the 2017 wikitext editor.

"" appears in the visual editor and the 2017 wikitext editor; "Bad JSON format" appears when editing in the template data GUI editor.

These errors can be difficult to detect and come in too many forms to list. The best way to avoid them is to edit template data exclusively with the template data editor; the best way to detect them once they've occurred is to use an external JSON validator, such as JSONLint, which will highlight errors and aid in fixing them.

The 2010 wikitext editor does not check for invalid JSON thanks to an old, unfixed bug. Pages that contain invalid JSON may throw alarming "" messages. To fix these errors, your best bet is to use a JSON validator (see above).

This error occurs if you state a parameter in  that is not stated in. The number in the square brackets refers to the parameter in  that is missing. It refers to its order in the sequence, but it is one less than its actual position, since  is an array; 0 is the first one, 1 is the second, etc.

To fix this, make sure all parameters stated in  are listed in. Alternatively, you can remove the  object to remove this error.

This error occurs if you state a parameter in  that is not stated in. The number in the square brackets refers to the parameter in  that shouldn't be there. It refers to its order in the sequence, but it is one less than its actual position, since  is an array; 0 is the first one, 1 is the second, etc.

To fix this, make sure all parameters stated in  are listed in. Alternatively, you can remove the  object to remove this error.

This error occurs if you put quotation marks around the value of either  or.

These are boolean values, not strings, therefore they require no quotation marks. To fix this, remove any quotation marks around the values  or   for these parameters.

Property "format" is expected to be ...
If the  parameter exists but its value is not ,   or a valid format string, you will see the error message "".

To fix this, make sure the value after  equals   or   and that there no spelling mistakes. Alternatively, if it's wikitext, make sure it contains a minimum of  and that there are no mistakes in the syntax that would normally cause a template to fail, such as duplicate equals signs or missing/duplicate curly brackets; see the section #Custom formats for the syntax for custom formats. Alternatively, you can remove the  parameter to remove this error.

This error occurs if you state a parameter that does not exist in template data. This is probably due to spelling mistakes.

It also occurs if you state a parameter in any template data object that is not a parameter of that object. This may be due to spelling mistakes, or you may have written the parameter of one template data object under another object that it doesn't belong to.

For example, you might have written the parameter  under the root template data object instead of inside  :

Alternatively, if the unexpected parameter is under a template parameter inside, you'll see its name after "params.parametername." in the error.

To fix this, make sure there aren't any spelling mistakes in the parameter names, and make sure your parameters are in their correct location. Additionally, make sure you don't state any parameters that don't exist for a template data object. You can check which parameters exist for an object in the section #Template data parameters.

This error occurs if there is no  object in the template data. This is a necessary object, as it contains all the details of each parameter, so to fix this error, make sure it's added and that there are no spelling mistakes. See the section above on how to add the  parameter.



Limitaciones y preguntas

 * Funcionalidades faltantes – TemplateData es mucho un ejemplo de herramienta que se hizo disponible con pocas características, con la esperanza de que los usuarios ayuden al desarrollo de guías de caracterísiticas cuando lo decidan. Si quisieras solicitar nuevas caracerísticas de TemplateData, por favor, háznoslo saber.
 * Retrasos mostrando las plantillas – Después de agregar TemplateData a una plantilla, la metainformación debiera ser visible inmediatamente cuando la plantilla se abra en el editor visual. Sin embargo, es posible que tome varias horas antes que la metainformación se muestre. Puedes forzar una actualización haciendo una edición nula a la propia página de la plantilla (no la subpágina de la documentación). Para realizar una edición nula, abre la página de la plantilla para editarla y guarda la página "sin hacer ningún cambio ni escribiendo ningún resumen de edición".
 * Problemas actuales – En el sistema de seguimiento de incidencias de Wikimedia hallarás una lista de los errores y las solicitudes de funciones actuales.



Otras herramientas

 * : A toolbar dialog window for entering template wikitext via an form built from template data.
 * TemplateData Wizard: Una herramienta que genera TemplateData a través de una interfaz interactiva.
 * Skeleton TemplateData generator: Una herramienta que lee el código wikicode fuente de una plantilla, trata de encontrar todos los parámetros usados y muestra un documento esquematizado con los parámetros indicados.
 * JSONLint: Una herramienta que te permite validar JSON manualmente escrito para encontrar errores en la sintaxis.
 * [ Lista de todas las plantillas con TemplateData] en este wiki
 * Con TemplateData de la plantilla dewiki la información de la plantila se muestra en una caja y la plantilla se agrega a una categoría de plantillas con la información de la plantilla
 * https://query.wikidata.org/ and Query Helper