Citoid/Enabling Citoid on your wiki/zh

Citoid 是一个自动填充的引文生成器，它根据 URL 或一些学术参考标识符（如 DOI、PMID、PMCID 和 ISBN）自动从在线资源创建引文模板. 它目前作为 可视化编辑器 功能提供，并且在. Citoid使用Zotero翻译器将页面链接转换为详细信息.

center|700px





第1步：启用引用模板工具
Citoid 服务使用 可视化编辑器的引文工具. 这已经在大多数大型维基百科和许多较小的项目中启用. 如果启用了引文工具，则"" 菜单将列出一个或多个本地引文模板，以及 ""和"". 如果未启用引文工具，则需要先启用它，然后再继续，按照Citation tool definition. 每个引文模板都需要正常的模板数据来工作.



第2步：配置Citoid
必须使用特殊的模板数据映射和特定于 Citoid 的特殊消息来配置 Citoid 扩展. 按顺序执行这两个步骤很重要！



第2a步：为每个引用模板创建“citoid”地图值
由于Citoid对于每种文档类型都有自己的一套字段（例如，期刊名称在Citoid中叫做“publicationTitle”，但在Template:Cite_journal中叫做“journal”），所以您需要在每个引用模板的TemplateData中添加 ，叫做“citoid”. 此 特殊映射 在 Citoid 的字段和模板的字段之间创建映射. 该地图必须称为“citoid”，才能让 Citoid 扩展知道要查找哪个地图. maps 对象中允许无限数量的具有唯一键的映射. 请注意，您只能在编辑模式下查看模板数据映射;它们在模板数据表中不可见. 另外请注意，如果您最近通过从其他wiki复制来创建了您的wiki的TemplateData，那么它可能已经包含了Citoid地图，所以您可以在验证后跳过这一步.

与Citoid扩展兼容的最新地图对象在英语维基百科上：
 * w:Template:Cite news/doc
 * w:Template:Cite journal/doc
 * w:Template:Cite web/doc
 * w:Template:Cite book/TemplateData
 * w:Template:Citation/doc



步骤2.b：配置特殊的MediaWiki消息
您需要配置一个特殊的 MediaWiki： namespace message， 这条消息将34种原生Citoid类型（ ， ， ， ， 等）映射到相应的模板（Cite web，Cite book，Cite journal等）.

您应将本地引文模板与每个 Citoid 类型匹配. 如果没有匹配到对应的模板，Citoid 将不起作用. 有一个不好的匹配总比没有匹配好. 例如，您的 wiki 可能没有用于引用 DVD 包装中的 liner Notes 的特殊模板，因此在这种情况下请考虑使用为书籍或视频设计的模板. 如果您要映射的源类型没有很好的匹配，您可以考虑使用通用模板（例如 en.wiki 的 Template:Citation）作为类型的包罗万象.

可以在英语维基百科上找到示例命名空间消息：https://en.wikipedia.org/wiki/MediaWiki:Citoid-template-type-map.json.

故障排除


新的引用按钮不会出现在工具栏中


当您在步骤 2.b 中创建 MediaWiki 消息时，之前的 cite 下拉菜单 (File:VisualEditor_-_Cite_Pulldown.png) 应替换为工具栏菜单中 citoid 服务的新按钮. 如果新按钮没有出现在工具栏中，则 MediaWiki:Citoid-template-type-map.json 可能有问题. 如果本地不存在该页面，或者该页面上的 JSON 无效，那么 citoid 将无法工作. 或者，您可能需要刷新 JavaScript 缓存.



出现空白引用
当您尝试插入没有地图数据的引文模板时，最常出现空引用. 如果模板具有地图数据，但该数据未到达 MediaWiki API，也会出现此问题. 如果地图对象存在于模板文档中的 TemplateData 块中，则尝试在模板上创建“空白编辑”. 如果这不起作用，则地图本身可能存在问题.



我最喜欢的网站未被 Citoid 识别，只能获取基本信息
Citoid 服务的大部分“魔力”都依赖于出色的 Zotero 社区，因为需要为每个站点编写 Zotero 翻译程序. 您可以在 https://github.com/zotero/translators 查看所有 Zotero 翻译器的列表. 目前，Zotero 最好支持英语源. 我们需要您的帮助来提高其他网站的覆盖率. 您可以编写自己的 Zotero 翻译器. 首先查看类似网站的现有翻译器，然后阅读 Citoid/Creating Zotero 翻译器 中的教程.



我的维基上的日期格式不同
包含完整信息（月、年和日）的日期采用 ISO 格式，这是国际标准. 如果社区不喜欢用户看到的方式，可以编辑引文模板，将 ISO 日期格式化为您语言中的标准格式. 例如，您可以向模板添加逻辑，以便如果检测到日期采用 ISO yyyy-mm-dd 格式，则日期将重新格式化*以在页面上显示*为 dd/mm/yyyy. 但是，如果您这样做，基础数据（即当您编辑维基文本或可视化编辑器中的表单时）仍将保持不变.

仅包含月份和年份的日期也在 ISO (YYYY-MM) 中，但某些引文模板不接受这些日期. 参见.



许多语言 wiki 模板（pl、it 和）不接受 xx-XX 风格的语言代码
请参阅 了解相关任务. 请参阅 上的线程，了解不同的 wiki 如何决定解决此限制.



参见

 * Zotero tutorial
 * Zotero translation server -- 基于 xpcshell 的 Zotero 翻译服务器，以及 zotero-node，一个废弃的 Nodejs 等效项
 * Valid field names for each item type
 * Zotero field mappings
 * 研究：Citoid 对维基媒体参考的支持
 * https://www.zotero.org/support/dev/translators/testing
 * 学习如何编写翻译器 与 Sebastian Karcher、Zotero（视频、幻灯片、链接）
 * 具有 Zotero 翻译人员的网站列表
 * 不同 itemType URL 的示例
 * James Forrester talks Citoid and Zotero at m:WikiCite 2017