Skip to content

Commit 7a1eb6f

Browse files
重译 CSL 文档 (#375)
* 同步jiaojiaodubai修正的CSL文档 * Fix lint * fix: ::: note -> ::: info --------- Co-authored-by: jiaojiaodubai <63148861+jiaojiaodubai@users.noreply.github.com>
1 parent be5a424 commit 7a1eb6f

5 files changed

Lines changed: 462 additions & 457 deletions

File tree

csl-dev-guide/glossary.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,5 @@
11
---
22
title: 术语对照表
3-
authors:
4-
- jiaojiaodubai
5-
date: 2024-02-16 00:51:03
63
---
74

85
# 术语对照表
@@ -37,10 +34,18 @@ date: 2024-02-16 00:51:03
3734

3835
特指 `CSL` 的 style 文件及其代码,是对引用格式的代码实现。注意区别于 Microsoft Word 中的「样式」,在 Microsoft Word 中,「样式」是指若干具体格式的集合。
3936

37+
## 本地化文件(locale file)
38+
39+
CSL 预置的一些文件,它用来将日期或[术语](#术语term)翻译为特定语言区域所采用的形式。
40+
4041
## 术语(term)
4142

42-
`locale file` 有关的语境里,「术语」指那些出现在引文或参考文献条目中用于串起相关信息的固定短语,如「xx****」、「xx****」、「**载于**xx」中的术语就分别连接着著作人、编者、出版物来源的信息。
43+
`locale file` 有关的语境里,「术语」指那些出现在引文或参考文献条目中用于串起相关信息的固定短语,如「xx****」、「xx****」、「**载于**xx」中的术语就分别连接着著者、编者、出版物来源的信息。
4344

4445
## 翻译(translation)
4546

4647
`locale file` 有关的语境里,「翻译」特指术语(term)在不同语言中的翻译。
48+
49+
## 形式(form)
50+
51+
指词形,即词语在不同的语境中使用的不同形态。如名词的单复数形式、词语的动词/名词形式等、数量词数量形式和序数形式。

csl-dev-guide/index.md

Lines changed: 2 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,6 @@ updated: 2023-07-22 20:39:20
66

77
# CSL 中文文档
88

9-
> [!warning]
10-
> 此页面正在施工中。
9+
此文档是对 [CSL 英文文档](https://docs.citationstyles.org/en/stable/primer.html) 的翻译。它最初由 [ZMAlt](https://github.com/ZMAlt) 维护并发布于 [CSL-chinese documentation](https://csl-chinese.readthedocs.io/en/latest/),后来 [Zotero Chinese](https://github.com/zotero-chinese) 社区接管了维护工作。
1110

12-
CSL (Citation Style Language) 是一种基于 XML 的语言,用来描述或格式化引用和参考文献目录的开源语言。使用 CSL 的参考文献管理软件包括 Zotero,Mendeley,Papers。
13-
14-
Zotero 文件管理软件开源且简单。CSL 的发展与 Zotero 有一定的关系,Zotero 也是第一个使用 CSL 的文献管理软件。$\LaTeX$ 一直是国际上期刊投稿的主流,但现在的越来越多的国际期刊除提供 $\LaTeX$ 模板外,同时还支持 Word 格式投稿。国内投稿或者各种报告大多要求都是 Word 格式。Zotero 可以在 Word 中生成和 $\LaTeX$ 同样漂亮的引用和参考文献目录。
15-
16-
由 CSL 编写的 style 定义了引用和参考文献目录的格式。Zotero 就是通过 style 来生成指定格式的引用和参考文献目录。据统计,现在已经有超过 9000 个 style,覆盖了大多数的常见的 SCI 期刊。在 Zotero 中能很容易检索到对应期刊的 style。但是即使有这么多的 style,仍然有可能有的期刊没有对应的 style。此外,有的 style 年代久远,已经不符合期刊 author guideline 中的要求,因此,我们需要学习 CSL 来定制需要的 style,至少能在已有的 style 上修改来满足期刊的要求。但是遗憾的是,国内 CSL 的资料几乎没有。
17-
18-
本项目是对 [CSL 英文文档](https://docs.citationstyles.org/en/stable/primer.html) 的翻译。本人能力有限,理解和翻译有误处请大家谅解,同时欢迎 issue 和 pull。
19-
20-
本文档基于 [Welcome to CSL-chinese’s documentation! — CSL-chinese documentation](https://csl-chinese.readthedocs.io/en/latest/) 修改。
21-
22-
> [!caution]
23-
> 文档中,凡标注 Work in progress 的均为正在施工的页面,无法确保与现有英文文档相一致,无法确保译文修改前后的一致性、准确性,请酌情阅读。
11+
出版物对参考文献的一系列引注规则构成了其引注样式,CSL 旨在提供一种计算机可读的语言来描述这些规则,从而在文献管理软件(如 [Zotero](https://www.zotero.org/)[Mendeley](https://www.mendeley.com/)[Papers](https://www.papersapp.com/))中自动生成引注。虽然 CSL 已经涵盖多个语言地区的数千种样式,但现实的需求是多样的,如果你没能在 CSL 样式仓库([官方仓库](https://www.zotero.org/styles)[中文社区仓库](https://zotero-chinese.com/styles/))中找到合适的样式,而且 [申请新样式](https://zotero-chinese.com/user-guide/citation-styles#%E8%AF%B7%E6%B1%82%E6%96%B0%E6%A0%B7%E5%BC%8F) 的周期太长,那么你可以参考本文档着手修改或创建自己的样式。

csl-dev-guide/primer.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ updated: 2023-07-22 20:42:39
3333

3434
引用格式可以分为两个主要的类型。第一种类型就是 `in-text` 风格,在这种风格中,一个引注直接指向参考文献表中的一个或者多个条目。CSL 继续将这种风格细分为 `author-date``author``numeric``label` 风格。
3535

36-
每个引注都指向一个或者多个参考文献条目。在 CSL 中,每个独立的指向关系称为一个引用。例如,引注 `(Doe et al. 2002, Smith 1997)` 包含两个引用:一个是 `Doe et al.` 在 2002 年发表的文献,另一个是 Smith 于 1997 年发表的文献。在 CSL 的语境中,参考文献表中的条目有时也称为参考文献。
36+
每个引注都指向一个或者多个参考文献条目。在 CSL 中,每个独立的指向关系称为一个引用。例如,引注 `(Doe et al. 2002, Smith 1997)` 包含两个引用:一个是 `Doe et al.` 在 2002 年发表的文献,另一个是 `Smith` 于 1997 年发表的文献。在 CSL 的语境中,参考文献表中的条目有时也称为参考文献。
3737

3838
#### author-date 和 author 风格
3939

0 commit comments

Comments
 (0)