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, PMCIDs e 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. This special mapping creates a map between Citoid's fields and the template's fields. Llamar al mapa 'citoid' permite a la extensión Citoid saber en qué mapa buscar. Se permite un número ilimitado de mapas con claves únicas 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. Ten en cuenta también que si recientemente creaste TemplateData para tu wiki copiándolo de otro wiki, este probablemente incluye los mapas Citoid, así que puedes saltarte este pasto después de verificar. An unlimited number of maps with unique keys are allowed in the maps object. Note that you can only see TemplateData maps in edit mode; they are not visible in the TemplateData table. Also note that if you recently created TemplateData for your wiki by copying it from another wiki, it probably already includes the Citoid maps, so you can just skip this step after verifying.

Los objetos mapa más actualizados que son compatibles con la extensión Citoid están en la versión en inglés de Wikipedia:
 * w:Template:Cite news/doc
 * w:Template:Cite journal/doc
 * w:Template:Cite web/doc
 * w:Template:Cite book/TemplateData
 * w:Template:Citation/doc



Paso 2.b: Configurar un mensaje MediaWiki especial
Necesitarás configurar un mensaje MediaWiki: namespace message especial,. This message maps the 34 native Citoid types (, ,  ,  ,  , etc.) to the appropriate templates (Cite web, Cite book, Cite journal, etc.).

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. You may consider using a generic template, such as en.wiki's Template:Citation, as a catch-all for types if there is no good match for the type of source you are mapping.

Puedes encontrar un ejemplo de mensaje de espacio de nombres en la Wikipedia en inglés: https://en.wikipedia.org/wiki/MediaWiki:Citoid-template-type-map.json.

Solución de problemas


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. If the new button does not appear in the toolbar, then there may be a problem with 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. If that doesn't work, then there may be an issue with the map itself.



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. You can see a list of all Zotero translators at https://github.com/zotero/translators. Right now, Zotero best supports English-language sources. Necesitamos tu ayuda para mejorar la cobertura de otros sitios. Puedes escribir tu propio traductor de Zotero. Comienza por mirar un traductor existente para un sitio web similar, y lee el tutorial en Citoid/Creating Zotero translators. You can write your own Zotero translator. Start by looking at an existing translator of a similar website, and by reading the tutorial at Citoid/Creating Zotero translators.



Las fechas tienen un formato diferente en mi wiki
Las fechas con información completa (día, mes y año) están en formato ISO, que es un estándar internacional. Si a la comunidad no le agrada la apariencia visual que tiene la fecha para el usuario, se puede editar la plantilla de cita para dar un formato a las fechas ISO que sea más acorde a tu idioma. Por ejemplo, puedes añadir lógica a la plantilla para que, si se detecta que la fecha está en formato ISO aaaa/mm/dd, se muestre como dd/mm/aaaa en la página. Sin embargo, si haces esto, los datos subyacentes (es decir, el wikitexto, o la forma que toma en el editor visual) seguirán siendo los mismos. 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.

Las fechas con solo mes y año están actualmente en inglés. Véase T132308. See.



Muchas plantillas de idioma (pl, it, en) no aceptan códigos de idioma de tipo xx-XX
Véase para la tarea relacionada. Véase el hilo correspondiente en para aprender cómo los distintos wikis han decidido solventar esta limitación.



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
 * Investigación:Soporte Citoid para referencias de Wikimedia
 * https://www.zotero.org/support/dev/translators/testing
 * Learn how to write a translator with Sebastian Karcher, Zotero (video, slides, links)
 * Lista de sitios web con traductores de Zotero
 * Ejemplos de diferentes URL itemType
 * James Forrester talks Citoid and Zotero at m:WikiCite 2017