Jump to content

Citoid/在您的wiki启用Citoid

From mediawiki.org
This page is a translated version of the page Citoid/Enabling Citoid on your wiki and the translation is 99% complete.
Outdated translations are marked like this.
主页面: Citoid

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

center|700px

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

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

第2步:配置Citoid

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

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

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 messageMediaWiki:Citoid-template-type-map.json. 这条消息将34种原生Citoid类型(artworkbookjournalArticletvBroadcastwebsite等)映射到相应的模板(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。

故障排除

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

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 服务的大部分“魔力”都依赖于出色的 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 如何决定解决此限制。


参见