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. To enable the tool, you'll need the following: a working installation of VisualEditor and Parsoid, citation templates on your wiki that use TemplateData to specify how they are invoked, and a special  message in order to hook VisualEditor and the templates together.

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.

Todas las wikipedias y otras wikis WMF ya tienen todos estos elementos instalados
 * 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.
 * 1) 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. Versiones recientes de estas plantillas en la Wikipedia en inglés y algunos otros también requieren los módulos de soporte Lua.
 * 2) Sube tus plantillas desde la página Special:Import en tu wiki (por ejemplo, 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. Copy the code to your wiki and adapt the names to the local context.

"Citation needed" tool
"Citation needed" templates can be configured to show an "Add a citation" button in the editor by configuring  with a   key.

See the example definition on English Wikipedia.

Solución de problemas
Si navegas a Special:Version y TemplateData está instalado, pero los campos no se están mostrando en el diálogo de citas, puede que necesites abrir la plantilla de cita para editar, sin hacer cambios, y guardarla de nuevo. Esto es debido a un bug donde el TemplateData el cual es incluido (por ejemplo, presente en Template:Cite_web/doc en lugar de directamente en Template:Cite_web) no se carga dentro de la base de datos hasta que la plantilla padre se edita; mira.

Por favor nota que el usuario con experiencia diferirá ligeramente cuando utilice tus propias plantillas diferentes de las cuatro estándar. Por ejemplo, una lista de campos no se mostrarán inicialmente en el diálogo de citas, pero serás capaz de solicitar una lsita de todos los posibles campos presionando un botón.