Citoid/在您的wiki启用Citoid
Citoid 是一个自动填充的引文生成器，它根据 URL 或一些学术参考标识符（如 DOI、PMID、PMCID 和 ISBN）自动从在线资源创建引文模板。 它目前作为 可视化编辑器 功能提供，并且在 2017 wikitext編輯器. Citoid使用Zotero翻译器将页面链接转换为详细信息。
第1步：启用引用模板工具
Citoid 服务使用 可视化编辑器的引文工具。 这已经在大多数大型维基百科和许多较小的项目中启用。 如果启用了引文工具，则"引证" 菜单将列出一个或多个本地引文模板，以及 "基本"和"复用"。 如果未启用引文工具，则需要先启用它，然后再继续，按照Citation tool definition. 每个引文模板都需要正常的模板数据来工作。
第2步：配置Citoid
必须使用特殊的模板数据映射和特定于 Citoid 的特殊消息来配置 Citoid 扩展。 按顺序执行这两个步骤很重要！
第2a步：为每个引用模板创建“citoid”地图值
由于Citoid对于每种文档类型都有自己的一套字段（例如，期刊名称在Citoid中叫做“publicationTitle”，但在Template:Cite_journal中叫做“journal”），所以您需要在每个引用模板的TemplateData中添加maps，叫做“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， MediaWiki：Citoid-template-type-map.json.
这条消息将34种原生Citoid类型（artwork，book，journalArticle，tvBroadcast，website等）映射到相应的模板（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) 中，但某些引文模板不接受这些日期。 参见 工單T132308 。
许多语言 wiki 模板（pl、it 和）不接受 xx-XX 风格的语言代码
请参阅 工單T115326 了解相关任务。 请参阅 工單T97256 上的线程，了解不同的 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