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 con TemplateData, y un mensaje especial .json con el fin de conectar al Editor visual con las plantillas.

Se recomienda tener las siguientes extensiones para usar con plantillas de citas comunes: Extension:VisualEditor, Extension:Scribunto, Extension:Cite, Extension:TemplateData, y Extension:ParserFunctions.

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. Scribunto permite usar el lenguaje de programación lua en las plantillas de citas, y la mayoría de las plantillas de citas en Wikipedia están en lua y hacen uso de las funciones de intérprete. La extensión Cite permite usar las etiquetas . La extensión TemplateData permite que las plantillas proporcionan el etiquetado y la información estructurada acerca de sí mismos para el Editor visual.
 * 2) Export citation templates from wikipedia: Manual:Using_content_from_Wikipedia. Exporting Template:Cite_web, Template:Cite_news, Template:Cite_journal, Template:Cite_book is a good place to start.
 * 3) Upload your templates using the Special:Import page on your wiki (for example, http://localhost/index.php/Special:Import)

Template Data
You'll need Extension:TemplateData for the citation tool to be able to load the template data into the fields in VisualEditor and each template must have template data defined. For more information on how to define template data for citations, and to see screenshots of how a citation window should look with and without template data defined, see: Wikipedia:VisualEditor/TemplateData

Citation Tool Definition
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.
 * There are a standard four, "web", "book", "news" and "journal", which correspond to  etc.
 * Indica qué icono te gustaría usar para cada tipo de cita.
 * There are a standard four, "ref-cite-web", "ref-cite-book", "ref-cite-news" and "ref-cite-journal", which correspond to CSS classes with the icon as a background SVG image called  etc.

Tipos adicionales
If you are considering adding an additional type, the development team would really like to talk with you first, to give advice, help create an appropriate icon, and so we can consider whether other wikis might also want this type defined for all wikis.

Para agregar un tipo adicional, necesitarás
 * 1) Decide qué tipo quieres crear
 * 2) * In this example, say you wished to have a database reference, you could call the type "database".
 * 3) Create a label for it
 * 4) * For the example, you could make the label name "db" and add a label at   with the value "database". This should be in your wiki's content language. If your wiki uses multiple languages or scripts, you may need to create several of these labels.
 * 5) Create an icon for it
 * 6) * For the example, you could make the icon label "ref-cite-dbase", and create the icon as an SVG file uploaded to commons, create the icon class " " in  and add the icon you want with " " or similar.

Ejemplos
You can see example definition messages on the English Wikipedia and the Polish Wikipedia.

Troubleshooting
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 will flush the cache.

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.