Ayuda:Extensión:TemplateWizard

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Help:Extension:TemplateWizard and the translation is 87% complete.

Other languages:
English • ‎dansk • ‎español • ‎français • ‎italiano • ‎polski • ‎русский • ‎українська • ‎中文 • ‎日本語

¿Qué es TemplateWizard?

TemplateWizard es una extensión de MediaWiki que proporciona una ventana emergente en la barra de herramientas del WikiEditor para insertar plantillas en Wikitexto .

¿Cómo usar TemplateWizard?

  • Para usar TemplateWizard, abre el editor de Wikitexto (no el editor de Wikitexto de 2017)
  • Coloca el cursor en la posición donde quieras insertar la plantilla. Luego haz clic en el icono del rompecabezas OOjs UI icon puzzle-ltr.svg en la barra de herramientas. TemplateWizard icon.png
  • Aparecerá una ventana de diálogo.

¿Cómo encuentro una plantilla?

  • Comienza a escribir el nombre de una plantilla y te aparecerá una lista de plantillas para elegir.

TemplateWizard help search en.png

  • Nota: Solo las plantillas que tengan TemplateData tendrán descripciones. Se recomienda agregar TemplateData a las plantillas.
  • Cuando encuentres la plantilla que estás buscando, haz clic en ella (o desplázate hasta ella con las teclas de flecha) y presiona Intro. Esto te llevará al formulario de la plantilla.

¿Cómo añado datos a la plantilla que escogí?

  • La barra superior que ves ahora contiene el título de la plantilla, la descripción, un enlace OOjs UI icon link-ltr-progressive.svg a la página wiki de la plantilla y un botón de cierre OOjs UI icon trash-destructive.svg para cerrar el formulario de la plantilla y volver a la búsqueda.
  • La lista de parámetros del lado izquierdo, dividida en hasta tres partes para los parámetros requeridos, sugeridos y opcionales. Este área también tiene un botón en la parte inferior con el que agregar o eliminar todos los campos no necesarios a la vez. Ten en cuenta que algunas plantillas no tienen parámetros y, en estos casos, no se enumerarán aquí. Al hacer clic en un parámetro de la plantilla, se agrega al lado derecho.
  • El formulario del lado derecho que contiene los campos de entrada de datos reales en los que se colocan los valores que se agregarán al wikitexto. Solo los parámetros que se enumeran aquí se insertarán en el área de edición (incluidos aquellos que no contienen ningún valor, ya que las plantillas pueden tratarlo de forma diferente desde el parámetro que no está presente en absoluto).
  • Puedes hacer clic en los iconos de información sobre los campos de la plantilla para leer más información sobre ellos.

TemplateWizard help template en.png

  • TemplateWizard funciona de manera más efectiva con plantillas que tienen TemplateData definido: es decir, sus parámetros se han documentado de manera detallada y estructurada, incluidos los valores predeterminados, etc. (la información sobre cómo hacerlo está en las páginas de ayuda de TemplateData) . También funciona sin definiciones de TemplateData, aunque con cierta funcionalidad reducida. Estos dos modos se describen en las siguientes dos secciones.
  • Solo se añadirán por defecto los campos requeridos
  • Ventanas emergentes para información del campo
  • Autocompletar los nombres de la página en la wiki
  • Autocompletar para archivos de Commons
  • Entradas de campo personalizadas para fechas, campos de texto de formato largo, números, etc.

Usando TemplateWizard con TemplateData

Hay siete tipos diferentes de campos utilizados en TemplateWizard, según el tipo de parámetro definido en TemplateData.

Nombre[fn 1] Tipo[fn 2] Campo utilizado Notas
1. Número number NumberInputWidget
2. Fecha date DateInputWidget
3. Usuario wiki-user-name UserInputWidget
4. Página wiki-page-name TitleInputWidget Para cualquier nombre de página (incluyendo los archivos).
5. Archivo wiki-file-name TitleInputWidget Limitado a títulos en el espacio de nombres de archivos, y se muestra con imágenes en miniatura.
6. Plantilla wiki-template-name TitleInputWidget Limitado a títulos en el espacio de nombres de la plantilla.
7. Algo más TextInputWidget Los demás tipos se mostrarán como entradas de texto estándar y aceptarán cualquier texto.
  1. El nombre utilizado en el formulario TemplateData.
  2. El tipo utilizado en el JSON TemplateData.

TemplateData en sí admite más tipos de campos de los que se enumeran arriba Algunos de estos pueden ser añadidos en task T200664.

Usando TemplateWizard sin TemplateData

Si una plantilla no tiene algún TemplateData, entonces se intentará adivinar los nombres de sus parámetros, y estos se presentarán como campos de formulario de entrada de texto estándar con etiquetas según se adivinen.

Note that it is likely that there will be duplicated, deprecated, or missing parameters in this list, because template authors will do things such as the following to allow different forms of a parameter name: {{{full name|{{{Full Name}}}}}} (note the difference in letter case). It is common for there to be a prefered form for a parameter, and this can only be found by viewing the template documentation (and, while you're there, maybe adding TemplateData, so other people aren't confused in the future!).

How do I insert the template?

When you've added all desired parameters to the template form and given them their values (including no value at all if you need an empty parameter), click the 'Submit' button at the top right of the dialog window and the template wikitext will be inserted at the cursor's current location in the main page editing box.

Template text will be inserted according to the format defined in TemplateData; if none is given then the 'inline' format will be used. It is not possible to have a different custom format for one template (but of course the template wikitext can always be edited after insertion).

See also