跳转到内容

模组讨论:Citation/CS1/Whitelist

页面内容不支持其他语言。
维基百科，自由的百科全书

修改CS1系列引文格式模板（第三阶段）：启用biorxiv，citeseerx参数；新增cnidcn（国内统一刊号）；启用bibcode，jfm，mr，oclc，ssrn及zbl参数格式检查等

本主题或以下段落文字，移动自Wikipedia:互助客栈/技术。执行者：Jimmy-bot（留言） 2021年9月23日 (四) 08:14 (UTC)。

已通过：
下列讨论已经关闭，请勿修改。如有任何意见，请至合适的讨论页进行，并不要再次编辑本讨论。

如题，该案主要是为了实现下列目标：

  • 兼容bioRxiv和CiteSeerX参数，以解决引进英文条目后模板中相应参数带来的“含有未知参数”的问题；bioRxiv在COVID-19相关条目中有广泛的运用，故对其的兼容有一定程度的迫切性；
  • 响应上方提议，新增参数cnidcn用以填写国内统一刊号。模块接受形如"(CN ?)?AA-BBBB(/CCC)?"格式的国内统一刊号参数值，检查AA是否为合法的省份代码，CCC（如有）是否为合法的图书分类，通过BBBB判断出版物的类型，并检验出版物类型与图书分类是否一致（e.g. 印刷报纸无CCC，而印刷刊物有CCC）。对于印刷报、刊的情形，模块会产生指向国家新闻出版署的链接，以供查证。
  • 改变Bibcode、JFM、MR、OCLC、SSRN、zbl六个参数产生外部链接的方式，由“直接生成外链”改为“先检查格式再生成外链”。这有助于编者发现对应参数值中格式错误。
  • 改变CSBN参数产生外部链接的方式，新增格式检查，同时针对豆瓣网的搜索链接做出针对性修改。

此外，还修复了早前版本错误引入的报错信息格式的不一致性，以及旧模块中由于漏翻译可能导致的一处lua错误。

为实现该修改，需改动Module:Citation/CS1/Configuration、Module:Citation/CS1/Whitelist和Module:Citation/CS1/Identifiers。此外，为复用日期检查函数，还需对Module:Citation/CS1/Date validation和主模块进行配套性修改。测试结果见Module_talk:Citation/CS1/testcases/identifiers/Antigng（新增、启用参数）和Module_talk:Citation/CS1/testcases/errors/Antigng（启用格式检查）。

CCC并不是统一刊号的一部分吧？（严格意义上）如果这也算的话，那么国内几乎所有的书籍ISBN后也有/CCC--百無一用是書生 (☎) 2021年8月31日 (二) 02:29 (UTC)
额，标准里还真是这么规定的--百無一用是書生 (☎) 2021年8月31日 (二) 02:40 (UTC)
说起这个，我想起来自己是新手的时候往CS1系列模板里填ISBN号的时候因为带上了CCC，然后模板报错却搞不清楚为什么报错。有必要在引用模板中特殊处理，在编者填写带CCC格式的ISBN号时，通过具体的报错信息提示其删去尾部的CCC么？--Antigng（留言） 2021年8月31日 (二) 03:25 (UTC)
个人支持以报错提示其删去尾部的CCC的做法。--DreamerBlue（留言） 2021年8月31日 (二) 03:28 (UTC)
(！)意见：新参数命名为“cn”即可，应该没有必要添加“id”后缀。参考 issn，直接缩写自 International Standard Serial Number，cn 则是 China serial number 的缩写，字母 n 已经含有 number（编号、编码）之义，再加上 id [entifier]（识别码、标识符）似乎略显赘余。--萧漫（留言） 2021年8月31日 (二) 15:53 (UTC)
@蕭漫：，主要是在下不确定cn是否存在歧义？如果没有歧义使用cn当然最好。--Antigng（留言） 2021年8月31日 (二) 16:02 (UTC)
原来是基于这样的考量啊，不过我想是没有歧义的。--萧漫（留言） 2021年8月31日 (二) 16:15 (UTC)
已修改。--Antigng（留言） 2021年9月1日 (三) 03:49 (UTC)

CS1系列的unified参数的问题

Module:Citation/CS1/Configuration#L-951

简而言之，如果输入统一书号，unified=17197·99，会得到CSBN 17197·99。

但由于豆瓣统一地、错误地将统一书号中的间隔号（·）改为连接号（-），所以应该生成CSBN 17197·99才是有意义的。

本人对技术基本一窍不通，希望有人能帮助实现该功能。——三猎（留言） 2021年8月31日 (二) 12:51 (UTC)

公示

本讨论已经关闭，请勿修改。如有任何意见，请至合适的讨论页进行，并不要再次编辑本讨论。

修改CS1系列引文格式模板（第四阶段）：新增name-list-style参数并增加“&”格式，新增url-access参数并兼容既有registration、subscription参数

本主题或以下段落文字，移动自Wikipedia:互助客栈/技术。执行者：Jimmy-bot（留言） 2022年5月1日 (日) 08:14 (UTC)。

已通过
无反对意见，已通过。--Antigng（留言） 2022年4月12日 (二) 08:18 (UTC)
下列讨论已经关闭，请勿修改。如有任何意见，请至合适的讨论页进行，并不要再次编辑本讨论。
有生之年系列，您辛苦了。—— Eric Liu 創造は生命（留言・留名・学生会） 2022年3月27日 (日) 19:45 (UTC)
(＋)支持，url-access终于来了，您辛苦了。--BlackShadowG（留言） 2022年3月27日 (日) 23:58 (UTC)
旧有的“|last-author-amp=”参数在填写yes或ture后也会在最后两名作者之间生成“&”符号，不知引入新参数后是否能兼容这个旧参数？若像英维那样删除这个旧参数，估计会导致本站使用该参数的页面出现红字警告，需安排机器人逐一将“last-author-amp=yes”替换为“name-list-style=amp”。此外，上次更新时加入的 CN 号参数链接已经失效，原因是新闻出版署的网页定位符改成了纯数字的 id，而不再是之前的 CN 号，由此导致本站的 CN 号链接无法指向正确页面（目前维基数据也还在沿用之前的失效链接，未作出任何更新）。
链接变更情况如下：
若新闻出版署的网页不再使用 CN 号作为定位方式，那旧链接将永久失效，这种情况下除了移除失效链接外，是否还有更好的处理方式？比如通过某种技术手段，让 CN 号能够跳转至新闻出版署的当前页面？若只能移除链接而无其他解决方案，CN 号参数的参考价值将大打折扣，甚至可能没有再保留该参数的必要。--萧漫（留言） 2022年3月28日 (一) 17:17 (UTC)
(：)回应，1.兼容，优先级last-author-amp>name-list-style/name-list-format。事实上先后这四次CS1的更改都是本着“不废弃既有参数，兼容新参数，如无必要尽可能不改变既有显示方式”的原则进行的。2. 目前暂无解决方案。--Antigng（留言） 2022年3月29日 (二) 01:12 (UTC)
关于既有显示方式，建议在后续修改中按照英维改进两点：
  1. 在填写了作者或编者参数时，年份或日期以半角括号括起，显示于作者或编者之后；未填写作者或编者时，年份或日期不带括号，显示于出版者之后 （即维持现有的显示格式）。
  2. 为各类 id（ISBN、doi、pmc……）前部标示 id 类型的文字添加内链，使其不再与后方的字符串合为一个指向外部的整体链接，便于读者快速直接地获知各类 id 的信息。--萧漫（留言） 2022年3月29日 (二) 14:39 (UTC)
再下一个版本将是主模块的大幅度拆分与重构，同时修复一些bug/微调一些格式。抱歉可能您提到的其中一些功能可能要下下个版本才能实现。--Antigng（留言） 2022年3月30日 (三) 16:17 (UTC)
最后一条意见于七日前留下。现公示七日。--Antigng（留言） 2022年4月6日 (三) 05:21 (UTC)
注意到还有个“chapter-url-access”参数，不知这次是否一同引进？该参数用于书籍章节的链接，若某本书的被引章节乃至全书均有一定的访问限制时，便有必要使用该参数，引文示例大概如下：
  • Jefferies, R.P.S. The Origin of Chordates — A Methodological Essay需注册. House, M.R. (编). The Origin of Major Invertebrate Groups需注册. London; New York: Academic Press for The Systematics Association: 443–447. ISBN 0123574501. LCCN 78-73884. OCLC 5844063. NLC 000271189.
--萧漫（留言） 2022年4月8日 (五) 14:33 (UTC)
  • 已经做好了，将于再下一个版本引进：
当前版本：Glut, Donald F. Appendix: Dinosaur Tracks and Eggs. Dinosaurs: The Encyclopedia. 3rd Supplement. Jefferson, North Carolina: McFarland & Company, Inc. 2003: 613–652. ISBN 0-7864-1166-X.  已忽略未知参数|chapter-url-access= (帮助)
引入该参数之后的效果：Glut, Donald F. Appendix: Dinosaur Tracks and Eggs需要免费注册. Dinosaurs: The Encyclopedia. 3rd Supplement. Jefferson, North Carolina: McFarland & Company, Inc. 2003: 613–652. ISBN 0-7864-1166-X. 

--Antigng（留言） 2022年4月10日 (日) 14:49 (UTC)

本讨论已经关闭，请勿修改。如有任何意见，请至合适的讨论页进行，并不要再次编辑本讨论。

修改CS1系列引文格式模板（第五阶段）：新增chapter-url-access、map-url-access参数；临时修复语言代码显示问题；改善模板信息的显示方式；模板内部逻辑大规模拆分整理

本主题或以下段落文字，移动自Wikipedia:互助客栈/技术。执行者：Jimmy-bot（留言） 2022年5月7日 (六) 00:14 (UTC)。

已通过
下列讨论已经关闭，请勿修改。如有任何意见，请至合适的讨论页进行，并不要再次编辑本讨论。

本站CS1系列模板先后历经四轮小规模更新，目前英文站模板较常用而本站模板过去没有的参数，如url-access，url-status，name-list-style，各种文献标识符及对应的-access参数均在这四轮更新中逐步引进。Category:含有未知参数的引用的页面中页面的数量也从去年的四千余个降低至目前的约1500个 ，足见更新之成效。本轮CS1模板更新，表面上主要涉及以下三方面：

  • 一是启用chapter-url-access（section-url-access为其别名）和map-url-access参数，分别用于填写chapter-url（section-url）和map-url的访问状态（有限度免费访问/需要注册/订阅等）。效果如下：
  • 二是临时在本地修复了由于mediawiki内部代码缺乏更新而引起的语言参数不正常显示的问题。见上方讨论。
  • 三是调整完善了模板的一些显示方式，特别是错误信息的显示，较为明显的改动有：
    • a. 本轮更新后，模板未填写作者（author系列参数）或贡献者（contributor系列参数），但填写编者（editor系列参数）时，模板将依所填写的编者参数生成元数据（COinS）作者栏位的信息。考虑到部分性质的来源（如百科全书），编者等同于实质上的作者，这一处理应当是合理的。
    • b. CS1系列模板中各模板支持的参数略有不同。例如，{{cite news}}模板填写卷（volume参数）是没有意义的，{{cite book}}模板填写邮件列表（mailing-list）参数是没有意义的。现在模板的处理方式是直接丢弃这些参数而不告知使用者。本轮更新后，遇到相应的情况模板会红字报错，并将页面纳入追踪分类Category:引文格式1错误：已知参数被忽略。这有助于编者及时发现参数使用方面的错误（其中有一些还很隐蔽，例如bookTitle参数很容易被“望文生义”成“书名”，但实际上仅有{{cite conference}}模板支持，{{cite book}}模板反而不支持）。以下是一些例子：
      • 例2b1：
        {{cite book| author=Herbst, T. M.; Rix, H.-W.|year=1999 |editor=Guenther, Eike; Stecklum, Bringfried; Klose, Sylvio|title=Star Formation and Extrasolar Planet Studies with Near-Infrared Interferometry on the LBT |book-title=Optical and Infrared Spectroscopy of Circumstellar Matter, ASP Conference Series, Vol. 188. |isbn=1-58381-014-5|pages=341–350 |bibcode=1999ASPC..188..341H |publisher=Astronomical Society of the Pacific |location=San Francisco, Calif.}} 注：bookTitle参数仅{{cite conference}}模板支持
      • 更新前：Herbst, T. M.; Rix, H.-W. Guenther, Eike; Stecklum, Bringfried; Klose, Sylvio , 编. Star Formation and Extrasolar Planet Studies with Near-Infrared Interferometry on the LBT. San Francisco, Calif.: Astronomical Society of the Pacific. 1999: 341–350. Bibcode:1999ASPC..188..341H. ISBN 1-58381-014-5.  |book-title=被忽略 (帮助)
      • 更新后：Herbst, T. M.; Rix, H.-W. Guenther, Eike; Stecklum, Bringfried; Klose, Sylvio , 编. Star Formation and Extrasolar Planet Studies with Near-Infrared Interferometry on the LBT. San Francisco, Calif.: Astronomical Society of the Pacific. 1999: 341–350. Bibcode:1999ASPC..188..341H. ISBN 1-58381-014-5.  |book-title=被忽略 (帮助)
      • 例2b2：
        {{cite web| author=Vijverberg et al. | title=Similar mode of action of pyrethroids and DDT on sodium channel gating in myelinated nerves | url=http://www.nature.com/nature/journal/v295/n5850/abs/295601a0.html | journal=Nature | volume=42 | issue=295 | year=1982 | accessdate=2012-04-28}}注：{{cite web}}不支持volume与issue
      • 更新前：Vijverberg; 等. Similar mode of action of pyrethroids and DDT on sodium channel gating in myelinated nerves. Nature. 1982 [2012-04-28].  参数|journal=与模板空引用 (帮助) 不匹配（建议改用空引用 (帮助) 或|website=） (帮助); |volume=被忽略 (帮助); |issue=被忽略 (帮助)
      • 更新后：Vijverberg; 等. Similar mode of action of pyrethroids and DDT on sodium channel gating in myelinated nerves. Nature. 1982 [2012-04-28].  参数|journal=与模板空引用 (帮助) 不匹配（建议改用空引用 (帮助) 或|website=） (帮助); |volume=被忽略 (帮助); |issue=被忽略 (帮助)
      • 例2b3：
        {{cite journal/Antigng|author=許宗傑| title=《清代澎湖方志研究》 | date=2011-01 | degree=中國文化大學中國文學系碩士 |url=https://hdl.handle.net/11296/723f6b | pages=15-16 | registration=yes }}注：仅{{cite thesis}}支持degree参数
      • 更新前：许宗杰. 《清代澎湖方志研究》需要免费注册: 15–16. 2011-01.  |degree=被忽略 (帮助)
      • 更新后：许宗杰. 《清代澎湖方志研究》需要免费注册: 15–16. 2011-01.  |degree=被忽略 (帮助)
    • c. 此外，引用模板内部的参数之间存在较为复杂的关系，可能出现“某个参数填写以后另一个参数的值被丢弃”的情况。当前模板的做法是直接丢弃有关参数。本轮更新后，将尽可能地以红字报告“只需其一”错误，方便编者查错。如下例所示：
      • 例2c：
        {{cite web|title=Title|url=http://example.com/|quote = "this is a test"|postscript = "test"}}注：quote参数填写后，post-script参数会被丢弃
      • 更新前：Title. this is a test  |quote=和|postscript=只需其一 (帮助)
      • 更新后：Title. this is a test  |quote=和|postscript=只需其一 (帮助)
    • d. 特别地，当日期与年份同时填写，两者的参数值都有效，但彼此不兼容的情况下，将红字报错：
      • 例2d：
        {{cite web|title=Title|url=http://example.com/|date=2020-01-01|year=2021}}
      • 更新前：Title. 2020-01-01.  |year=与|date=不匹配 (帮助)
      • 更新后：Title. 2020-01-01.  |year=与|date=不匹配 (帮助)
    • e. 最后，完善了部分界面文字的显示方式：
      • 例2e1：
        {{cite thesis|title=xxx研究|publisher=xx大学学报|year=2022}}
      • 更新前：xxx研究 (学位论文). xx大学学报. 2022. 
      • 更新后：xxx研究 (学位论文). xx大学学报. 2022. 
      • 例2e2：
        {{cite speech|title=Economic Isolationism Isn't an Option|first=Mike |last=Eskew |author-link= |event=Executive Speeches |location=Washington, D.C. |date=December 30, 2004 |url= |access-date= |medium=演讲 }}
      • 更新前：Eskew, Mike. Economic Isolationism Isn't an Option (演讲). Executive Speeches. Washington, D.C. December 30, 2004. 
      • 更新后：Eskew, Mike. Economic Isolationism Isn't an Option (演讲). Executive Speeches. Washington, D.C. December 30, 2004. 
      • 例2e3：
        {{cite book |title=Title |url=//example.com |archive-url=//archive.org |archive-date=2020-07-29 |url-status=bot: unknown}}
      • 更新前：Title. （原始内容存档于2020-07-29）.  无效|url-status=bot: unknown (帮助)
      • 更新后：Title. （原始内容存档于2020-07-29）.  无效|url-status=bot: unknown (帮助)
      • 例2e4：
        {{cite newsgroup |title=Title |newsgroup=sommat.sommat.sommat |publisher=Publisher}}注：当前模板显示实际上没有填写的|url=参数有问题，是因为模板的内部逻辑将输入的|publisher=参数当成url的一部分处理，更新后已正确反映这一点
      • 更新前：Title. Newsgroup: Publisher 请检查|publisher=值 (帮助).  |newsgroup=和|publisher=只需其一 (帮助)
      • 更新后：Title. Newsgroup: Publisher 请检查|publisher=值 (帮助).  |newsgroup=和|publisher=只需其一 (帮助)

最后，欢迎大家用沙盒版本的CS1模板（例如：{{Cite web/Antigng}}，{{Cite book/Antigng}}）进行测试。--Antigng（留言） 2022年4月12日 (二) 17:34 (UTC)

@Antigng 请问，{{cite book}}里面的 id={{XXX}}，这个参数id的选项是否可以多加几个，比如说几十年前没有ISBN、且没有录入OCLC的书籍，用类似NDL 12345677. NLC 12345677去定位。--Kethyga（留言） 2022年4月13日 (三) 02:48 (UTC)
@Kethyga：目前引文模板中|id=参数起到的就是后备用途，也就是所有模板本身没有支持的文献标识符参数都可以填写在|id=参数中；该参数没有任何格式上的限制，想填什么填什么。当然如果您的需求是像|doi=，|pmid=一样另设文献标识符参数并统一格式，可以在后续更新中予以考虑。由于本人对之不甚熟悉，可能需要麻烦您提供相关参数的定义，以及合法的范围等信息。--Antigng（留言） 2022年4月13日 (三) 03:22 (UTC)
重新测试了下，Special:diff/71124395，可以用形如|id={{NLC|12345678|01}}. {{NDL|12345678}}的方式添加多个。之前想法固定在只能添加一个模板上了。--Kethyga（留言） 2022年4月13日 (三) 06:35 (UTC)
(！)意见：目前沙盒版本“chapter-url-access=free”会出现“可免费查阅”的绿锁，但根据英文版的解释，一般而言这类网址是被假定为可免费访问，所以兼容free参数值是没有必要的。应该是：
  • url-access/article-url-access/chapter-url-access/contribution-url-access/entry-url-access/map-url-access/section-url-access = registration / limited / subscription
  • bibcode-access / doi-access / hdl-access / jstor-access / ol-access / osti-access / s2cid-access = free--BlackShadowG Pray for Ukraine 2022年4月14日 (四) 13:25 (UTC)
简单来说，编者提供的链接（如：url、chapter-url）默认是能免费查阅的，只需要标记需要付费或注册的即可；文献标识符自动生成的链接（如：doi、jstor）默认是不能免费查阅的，只需要标记免费的即可。--BlackShadowG Pray for Ukraine 2022年4月14日 (四) 13:31 (UTC)
已修正，请复查。--Antigng（留言） 2022年4月14日 (四) 14:38 (UTC)
公示七日。--Antigng（留言） 2022年4月20日 (三) 15:31 (UTC)
本讨论已经关闭，请勿修改。如有任何意见，请至合适的讨论页进行，并不要再次编辑本讨论。
检索自“https://zh.wikipedia.org/w/index.php?title=Module_talk:Citation/CS1/Whitelist&oldid=71505394”