VisualEditor/Citation tool/es

La herramienta de citas del Editor visual permite a los usuarios usar las plantillas de citas de tu wiki desde adentro del Editor visual. Para activar la herramienta, necesitarás lo siguiente: una instalación en funcionamiento del Editor visual y Parsoid, plantillas de citas en tu wiki que usen TemplateData para especificar cómo se invocan, y un mensaje .json especial con el fin de conectar al Editor visual con las plantillas.

Importar plantillas de citas
Necesitarás plantillas de citas en la base de datos de tu wiki con el fin de utilizar las funciones de citas. Si actualmente no tienes plantillas de citas en tu wiki (por ejemplo, en el caso de una nueva instalación) tendrás que conseguirlas. La forma más fácil de hacer esto es copiarlos de Wikipedia. Si ya dispones de plantillas de citas en tu wiki, puedes omitir estos pasos.


 * 1) Instala Extension:Scribunto, Extension:Cite/Cite.php, Extension:ParserFunctions y Extension:TemplateData. La mayoría de las plantillas en Wikipedia utilizan el lenguaje de programación Lua la cual Scribunto pone disponible y también usan las funciones del analizador de extensiones. La extensiuón de citas te permite utilizar las etiquetas.
 * 2) Exporta plantilass de citas de Wikipedia: Manual:Using_content_from_Wikipedia. Exporting Template:Cite_web, Template:Cite_news, Template:Cite_journal, Template:Cite_book son buenos lugares para empezar.
 * 3) Upload your templates using the Special:Import page on your wiki (for example, http://localhost/index.php/Special:Import)

Información de plantilla
Necesitarás el Extension:TemplateData para que la herramienta de citas sea capaz de cargar la información de plantilla dentro de los campos en el Editor Visual y cada plantilla debe tener información de plantilla definida. Para más información en cómo definir información de plantilla para las citas y para ver capturas de pantalla de cómo debiera verse una ventana de cita con y sin plantilla definida, mira: Wikipedia:VisualEditor/TemplateData

Definición de herramienta de cita
Para activar la herramientas de citas del Editor visual en tu wiki, necesitas crear un mensaje especial en tu wiki:. Esto es porque cada wiki es diferente y por lo tanto tiene que personalizar que funcionalidades quiere utilizar; por ejemplo, los nombres de las plantillas usadas en tu wiki pueden ser diferentes de los de otras wikis.

Propósito del mensaje de configuración
El mensaje:

TemplateData]]''' definido o el sistema será muy difícil de entender para los usuarios. Si actualmente tu wiki no usa plantillas de citación, es común copiar las plantillas de la Wikipedia en inglés como regla general. Una vez que esté creado el mensaje de configuración, la herramienta de citas estará disponible para todos los usuarios del Editor visual de tu wiki en cuestión de minutos.
 * Indica qué plantillas usa tu wiki para citas estándar (puedes agregar hasta 5).
 * Nota que '''cada plantilla debe tener [[Help:TemplateData|
 * Indica qué etiqueta te gustaría usar para cada tipo de cita.
 * Hay cuatro estándar, "web", "book", "news" y "journal", los cuales corresponden a  etc.
 * Indica qué icono te gustaría usar para cada tipo de cita.
 * Hay cuatro estándar, "ref-cite-web", "ref-cite-book", "ref-cite-news" y "ref-cite-journal", los cuales corresponden a clases CSS con el icono como una imagen SVG de fondo llamada   etc.

Tipos adicionales
Si consideras agregar un tipo adicional, el equipo de desarrollo querría platicar contigo primero, para dar consejos, ayudar a crear un iconno apropiado y así podamos considerar si otros wikis también quisieran este tipo definido para todos los wikis.

Para agregar un tipo adicional, necesitarás


 * 1) Decide qué tipo quieres crear
 * 2) * En este ejemplo, digamos que quieres tener una referencia de base de datos, llamarías a este el tipo "database".
 * 3) Crear una etiqueta para tu tipo
 * 4) * Para el ejemplo, podrías hacer que la etiqueta se llamara "db" y agregar una etiqueta en   con el valor "database". Esto debería estar en tu lenguaje de contenido de wiki. Si tu wiki utiliza múltiples idiomas o scripts, puedes necesitar cerar varias de estas etiquetas.
 * 5) Crear un ínco para tu tipo
 * 6) * Para el ejemplo, podrías hacer una etiqueta de icono "ref-cite-dbase" y crear el icono como un archivo SVG subido a commons, crear la clase de icono " " en  y agregar el icono que quieras con " " o alguno similar.

Ejemplos
Puedes ver los mensajes de definición ejemplo en la Wikipedia en inglés y la Wikipedia en polaco.

Solución de problemas
If you navigate to Special:Version and TemplateData is installed, but fields aren't showing up in the citation dialog, you may need to open the citation template for editing, make no changes, and save it again. This is due to a bug where TemplateData which is transcluded (i.e. present in Template:Cite_web/doc instead of directly on Template:Cite_web) is not loaded into the database until the parent template is edited; see.

Please note that the user experience will differ slightly when using your own templates other than the standard 4. For instance, a list of fields won't show up initially in the citation dialog, but you will be able to request a list of all possible fields by clicking a button.