贡献指南:如何新增样式
本文档说明如何在本仓库中新增一个 CSL 样式。
1. 样式名称
新增样式前,请先确定样式的名称。建议遵循以下规则:
- 应包含期刊/学校/标准/体例的名称。
- 学校的院系使用“学校 - 院系”格式。
- 本科生的学位论文样式在括号中标注“本科”,研究生不标注。
- 如果有特定引用格式,在括号中标注“顺序编码”、“著者-出版年”。
可以参考仓库中的样式名称。
2. 在 src 下创建样式目录
每个样式都必须在 src 下使用独立目录。 建议结构:
text
src/
your-style-name/
your-style-name.csl
items.json # 可选
cites.json # 可选3. <info> 填写规则
请确保样式的 <info> 信息完整、规范,至少满足以下要求:
title:与样式名称一致。id:使用样式页面地址(例如https://zotero-chinese.com/styles/your-style-name),且应唯一。link rel="self":指向本样式地址,与id一致。link rel="template":如果是基于某个样式派生,建议保留并指向上游模板样式。link rel="documentation":期刊/学校的官网格式要求的链接。如果有单独的文件,使用两个link分别给出网页和文件的链接。issn:期刊可以列出 ISSN 号。summary:注明格式要求的文件名称、文件号、发布日期。updated:更新时间应为有效时间格式。
注意事项:
- 不要手动修改自动生成文件(如
metadata.json、index.md),脚本会覆盖这些文件。
