Citoid/Enabling Citoid on your wiki/es

Citoid es un  'generador de de citas de autollenado' , que crea automáticamente una plantilla de cita desde fuentes en línea basado en una URL o algunos identificadores de referencia académicos como DOI, PMIDs o PMCIDs. Se planea soporte a ISBN. Actualmente está disponible como una funcionalidad del Editor visual, pero en el futuro estará disponible en el editor de wikitexto. Citoid usa traductores de Zotero para convertir un enlace de página en información detallada.

Paso 1: Habilita la herramienta de plantilla de cita
El servicio Citoid usa la herramienta de citas del Editor visual. Esto ya está habilitado en la mayoría de las Wikipedia más grandes y en muchos proyectos más pequeños. Si la herramienta de cita se habilita, el menú "" listará una o más plantillas de cita locales, además de las "" y "". Si la herramienta de cita no está habilitada, necesitas de habilitarla antes de proceder. Cada plantilla de cita requerirá "$basic" and "$re-using-reference". normal para funcionar.

Paso 2: Configurar Citoid
La herramienta Citoid debe configurarse utilizando mapas TemplateData especiales y un mensaje especial específico de Citoid. ¡Es importante hacer estos dos pasos en orden!

Paso 2.a: Crear un valor de mapas 'Citoid' para cada plantilla de cita
Ya que Citoid tiene su propia selección de campos para cada tipo de documento (por ejemplo, el nombre de diario se llama 'publicationTitle' en Citoid, pero se llama 'journal' en Template:Cite_journal), necesitarás agregar TemplateData especial para Citoid. Este TemplateData especial crea un mapa entre los campos de Citoid y los campos de la plantilla. Llamar al mapa 'Citoid' permite la extensión Citoid saber en qué mapa buscar. Un número ilimitado de mapas con claves únicas se permiten en el objeto de mapas. Ten en cuenta que solo puedes ver los mapas TemplateData en el modo de edición; no son visibles en la tabla TemplateData.

Los objetos mapa más actualizados que son compatibles con la extensión Citoid están en la versión beta de Wikipedia:
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Cite_news/doc
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Cite_journal/doc
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Cite_web/doc
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Cite_book/doc
 * http://en.wikipedia.beta.wmflabs.org/wiki/Template:Citation/doc

Paso 2.b: Configurar un mensaje MediaWiki especial
Necesitarás configurar un mensaje MediaWiki: namespace message especial, MediaWiki:Citoid-template-type-map.json. Este mensaje mapea los tipos Citoid nativos (website, book, journalArticle) a la plantilla apropiada (Cite web, Cite book, Cite journal).

Debes hacer coincidir una plantilla de cita local a todos y cada uno de los tipos Citoid. Si ninguna plantilla corresponde, entonces Citoid no funcionará. Es mejor tener una mala concordancia que ninguna en absoluto. Por ejemplo, tu wiki puede no tener una plantilla especial para citar las notas en línea para el empaquetado para un DVD, así que considera usar una plantilla diseñada para un libro o un video en ese caso. Puedes considerar usar una plantilla genérica, tal como en Template:Citation de en.wiki, como un predeterminado para todos los tipos si no hay un buen candidato para el tipo de fuente que estés mapeando.

Puedes encontrar un ejemplo de mensaje de espacio de nombres aquí: Citoid/MediaWiki:Citoid-template-type-map.json.

Solución de problemas

 * Principal: Citoid

El nuevo botón citar no aparece en la barra de herramientas
Cuando creas el mensaje MediaWiki en el paso 2.b, el menú desplegable de cita previo ( File: VisualEditor _-_ Cite_Pulldown.png) debe sustituirse por un nuevo botón para el servicio citoid en el menú de la barra de herramientas. Si el nuevo botón no aparece en la barra de herramientas, entonces puede haber un problema con MediaWiki:Citoid-template-type-map.json. Si esta página no existe localmente, o si el JSON en esa página es inválido, Citoid no trabajará. Alternativamente, puedes necesitar actualizar tu caché de JavaScript.

Aparecen referencias vacías
Las referencias vacías aparecen más comúnmente cuando intentas insertar una plantilla de cita que no tiene información de mapas. Este problema también aparece si la plantilla tiene infformación de mapas, pero esa información no llega a la API de MediaWiki. Si el objeto de mapas está presente en el bloque TemplateData en la documentación de la plantilla, entonces intenta un null edit" en la plantilla. Si eso no funciona, puede haber un problema con el propio mapa.

Citoid no reconoce mi sitio favorito y solo obtiene información básica

 * Principal: Citoid/Determinar si una URL tiene un traductor en Zotero

El servicio Citoid depende de la brillante comunidad de Zotero por la mayoría de la "magia", ya que los traductores de Zotero deben escribirse para cada sitio. Puedes ver una lista de todos los traductores de Zotero en https://github.com/zotero/translators. Por ahora, Zotero soporta mejor las fuentes en idioma inglés. Necesitamos tu ayuda para mejorar la cobertura de otros sitios. Puedes escribir tu propio traductor de Zotero. Comienzo por mirar un traductor existente para un sitio web similar, y lee las instrucciones generales de desarrollo de infraestructura en https://www.zotero.org/support/dev/translators/framework.

Véase también

 * tutorial de Zotero
 * Zotero translation server -- servidor de traducción de Zotero basado en xpcshell, y zotero-node el equivalente de nodejs equivalente abandonado
 * Nombres de campos válidos para cada tipo de elemento
 * mapeo de campos de Zotero