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 日期格式化为您语言中的标准格式. 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.

Dates with only month and year are in also in ISO (YYYY-MM) but these are not accepted by some citation templates. See.

Many language wiki templates (pl, it, en) don't accept xx-XX style language codes
See for the related task. See the thread at to learn how different wikis decided to workaround this limitation.



参见

 * Zotero tutorial
 * Zotero translation server -- xpcshell-based Zotero translation server, and zotero-node, an abandoned nodejs equivalent
 * Valid field names for each item type
 * Zotero field mappings
 * Research:Citoid support for Wikimedia references
 * https://www.zotero.org/support/dev/translators/testing
 * Learn how to write a translator with Sebastian Karcher, Zotero (video, slides, links)
 * List of websites with Zotero translators
 * Examples of different itemType URLs
 * James Forrester talks Citoid and Zotero at m:WikiCite 2017