可用于 Hayagriva 的 CSL 样式
CSL sanitizer for Hayagriva

语言版本:中文(当前页面) | English

Citation Style Language (CSL) 样式处理成 Hayagriva 可用的文件。

针对的 Hayagriva 版本:2025-12-27 a137441,预计对应 Typst v0.15.0。

使用方法:查看 CSL 文件列表,或安装浏览器用户脚本Zotero 中文社区 CSL 样式页面搜索查看。

初心

由于实现方式纷繁复杂,许多 CSL 样式超出了 CSL 规范,有些甚至还超出了 CSL-M 扩展(因为 Zotero 允许任意扩展 CSL 变量)。在 300+ 中文 CSL 样式中,约 74% 会被 Hayagriva(Typst 所用实现)判为 malformed,但它们都能被 citeproc-jsZotero 所用实现)接受。

然而很不幸,Hayagriva 提供的错误信息一般并不清晰,导致调试异常困难。即使您理解 Hayagriva 报了什么错,通常也需删除各个<macro>并反复重新编译,一番二分法后,才能定位问题。

  • Failed to load CSL style (duplicate field layout)
  • Failed to load CSL style (data did not match any variant of untagged enum Term)

本项目希望能免除这些繁重工作,让 CSL 样式能被 Hayagriva 接受

不过请注意,这并不保证能完全正确地著录参考文献,具体可参考 Hayagriva 对 GB/T 7714—2015 的支持情况。总之,Typst 在中文支持方面还有不小差距,必要时请结合其它方案使用

为 Hayagriva 修改过的中文 CSL 样式