引用样式语言(CSL)样式

资助包维护!
adam3smith

安装量: 234,420

依赖项: 3

建议者: 0

安全: 0

星标: 3,256

关注者: 87

分支: 3,746

开放问题: 288

语言:Ruby

v0.0.537 2024-09-18 20:42 UTC

This package is not auto-updated.

Last update: 2024-09-21 04:12:04 UTC


README

CSL logo

引用样式语言 - 样式仓库

License Build Status

简介

独立开源的引用样式语言(CSL)项目旨在通过自动化引用和参考书目格式的处理,促进学术交流。CSL生态系统的主要组成部分包括:

  • CSL架构和规范,描述了基于XML的CSL样式和地区文件应该如何编写和解释
  • CSL样式和地区文件的精选仓库
  • 第三方CSL处理器,用于从CSL样式、CSL地区文件和项目元数据中渲染格式化的引用和参考书目

此README描述了我们的官方精选CSL样式仓库,托管在https://github.com/citation-style-language/styles/。提供CSL样式(如翻译和日期格式)默认本地化数据的CSL地区文件可在https://github.com/citation-style-language/locales找到。

有关CSL和CSL样式的更多信息,请访问https://citationstyles.org/以及本仓库中的信息文件(样式要求样式开发请求样式贡献样式质量控制)。

收录标准

官方CSL样式仓库是唯一的此类仓库,被数十个第三方软件产品使用,被数十万用户依赖。此仓库的流行部分是由于其众包性质,我们相信,也部分得益于我们细致的策划。虽然我们会根据具体情况评估样式提交,但我们通常使用以下标准来决定是否将样式纳入CSL样式仓库:

  • 样式必须达到足够的质量,并符合我们的样式要求。虽然我们可能能够提供帮助,但最终提供符合我们标准的样式的责任在于提交者。
  • 样式应基于官方样式指南(并链接到在线或印刷形式的样式指南)。
  • 样式应吸引更广泛的受众。我们乐于接受针对特定受众的样式,但作为一般规则,样式提交者不应了解所有可能对其样式感兴趣的人。如果您确实如此,通常最好自行分发您的样式。

根据这些标准,我们通常接受

  • 为开放(非请求)投稿的期刊(以及此类期刊出版商的样式)提供的样式。
  • 已发布的样式指南的样式,例如来自专业组织、大学和大学部门的样式。

然而,我们通常不会接受

  • 个人使用的样式,或在小组织内部使用的样式。
  • 仅用于(内部)API的样式。

如果您不确定您的样式是否适合存储库,请随时提交一个问题或拉取请求,并寻求我们的意见。如果我们不接受您的提交,我们鼓励您自行分发您的CSL样式。

版本控制和样式分发

我们目前仅在“master”分支中积极维护CSL样式,这是CSL最新发布版本的分支。

此外,为了提供一个稳定的位置,存放特定CSL版本的样式,"master"中的样式会自动复制到以CSL最新版本命名的分支(例如,当CSL 1.0.2是最新版本时,则为“v1.0.2”)。一旦发布CSL的新版本(例如,CSL 1.1.0),"master"将升级到该版本,之后样式将从"master"复制到新的版本分支(例如,“v1.1.0”)。旧版本的CSL版本分支被保留,但通常处于休眠状态,因为这些分支我们通常停止维护,不会通过拉取请求接受第三方贡献,也不会将“master”中对样式所做的更改回滚。

从“v1.0.1”分支开始,版本分支与“master”有以下不同

  • 最新版本分支只有在“master”中的所有测试都通过时才会接收来自“master”的更新
  • 版本分支中的样式的<updated/>时间戳会更改,以匹配“master”中每个单独样式的git修改日期
  • 存在于“master”中的多余文件,例如用于样式测试的文件,将被删除。

因此,特别是对于下游集成者,建议您从适当的版本分支(例如,CSL 1.0.2样式的“v1.0.2”)获取您的CSL样式。目前,样式存储库包括以下(受保护)分支

  • "master"
  • "v1.0.2"(用于CSL 1.0.2样式)
  • "v1.0.1"(用于CSL 1.0.1样式)
  • "v1.0"(用于CSL 1.0样式)

这里描述的发布计划也用于我们的CSL地域

截至2020年11月,https://github.com/citation-style-language/styles-distribution,它承担了与版本分支类似的角色,已被弃用,不再从https://github.com/citation-style-language/styles接收更新。

许可

此存储库中的所有样式均在Creative Commons Attribution-ShareAlike 3.0 Unported license下发布。对于归属,使用此存储库中CSL样式的任何软件都必须明确提及CSL项目并链接到https://citationstyles.org/。当重新分发样式时,样式元数据中的作者和贡献者列表必须保持不变。