MediaWiki

Citoid/在您的wiki启用Citoid

< Citoid
This page is a translated version of the page Citoid/Enabling Citoid on your wiki and the translation is 100% complete.
Languages:
主页面： Citoid

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

center|700px

第1步：启用引用模板工具

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

第2步：配置Citoid

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

第2a步：为每个引用模板创建“citoid”地图值

主页面： Citoid/Maps TemplateData
ISSN，ISBN，作者，编辑器等字段是特殊字段，它们在citoid地图中可以是数组[]或二维数组[[]]。更多详情

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

与Citoid扩展兼容的最新地图对象在英语维基百科上：

步骤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包装中的专辑注释的特殊模板，因此在这种情况下请考虑使用为书籍或视频设计的模板。 如果您要映射的源类型没有很好的匹配，您可以考虑使用通用模板（例如 en.wiki 的 Template:Citation）作为类型的包罗万象。

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

故障排除

主页面： Citoid#Troubleshooting_Citoid_VisualEditor_Extension

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

 
Citoid 的工具栏按钮

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

出现空白引用

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

我最喜欢的网站未被 Citoid 识别，只能获取基本信息

主页面： Citoid/Determining if a URL has a translator in Zotero

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 如何决定解决此限制。


参见

Retrieved from "https://www.mediawiki.org/w/index.php?title=Citoid/Enabling_Citoid_on_your_wiki/zh&oldid=6864369"