Citoid/Enabling Citoid on your wiki/es

Citoid es un generador de citas precompiladas, 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á de un conjunto TemplateData para funcionar.

Paso 2: Configurar Citoid
La extensión Citoid debe configurarse utilizando mapas especiales de TemplateData 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.

Citoid has disappeared from my wiki
Please report any outage on Phabricator, and see that task for a temporary workaround.

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
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.

Access date is formatted differently on my wiki
The dates are in ISO format, which is an international standard. On the back-end, we're sticking to ISO and in the future all dates will all be in ISO, not just access date. This is because it is an unambiguous way to present the date in any language. If the community doesn't like the way this looks to the user, it is possible to edit the citation template to format the ISO dates to something that is standard in your language. For instance, you can add logic to the template such that if the date is detected to be in ISO yyyy/mm/dd format, the date is reformatted *to appear* to be dd/mm/yyyy on the page. However, if you do this, the underlying data (i.e. when you edit the wikitext, or the form in VisualEditor) will still remain the same.

Many language wiki templates (pl, it, en) don't accept xx-XX style language codes
Véase T115326 para la tarea relacionada. See the thread at T97256 to learn how different wikis decided to workaround this limitation.

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
 * Research:Citoid support for Wikimedia references
 * https://www.zotero.org/support/dev/translators/testing
 * http://citoid.wmflabs.org
 * Learn how to write a translator with Sebastian Karcher, Zotero (video, slides, links)
 * List of websites with Zotero translators
 * Examples of different itemType URLs