# 贡献指南：如何新增样式

本文档说明如何在本仓库中新增一个 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`：注明格式规范的文件名称、发布日期、文件号（可选），
  例如“《经济研究》参考文献索引及用录体例说明（2025-01-03）”、
  “北京理工大学研究生学位论文撰写规范（研函〔2026〕024号），2026年3月31日发布”。
  也可以补充说明相对于基准格式的修改细节。
- `updated`：更新时间应为有效时间格式。

注意事项：

- 不要手动修改自动生成文件（如 `metadata.json`、`index.md`），脚本会覆盖这些文件。