合入 csl 文档，暂存

src/csl-dev-guide/README.md

@@ -1,7 +1,23 @@
 ---
-title: CSL 手册
-date: 2023-04-20 10:06:44
-updated: 2023-07-20 16:51:54
+title: 首页
+date: 2022-08-01 16:23:04
+updated: 2023-07-22 20:39:20
 ---
 
-# CSL 手册
+# 首页
+
+> [!warning] WORK IN PROGRESS
+> 此页面正在施工中。
+
+CSL (Citation Style Language) 是一种基于 XML 的语言，用来描述或格式化引用和参考文献目录的开源语言。使用 CSL 的参考文献管理软件包括 Zotero，Mendeley，Papers。
+
+Zotero 文件管理软件开源且简单。CSL 的发展与 Zotero 有一定的关系，Zotero 也是第一个使用 CSL 的文献管理软件。$\LaTeX$ 一直是国际上期刊投稿的主流，但现在的越来越多的国际期刊除提供 $\LaTeX$ 模板外，同时还支持 Word 格式投稿。国内投稿或者各种报告大多要求都是 Word 格式。Zotero 可以在 Word 中生成和 $\LaTeX$ 同样漂亮的引用和参考文献目录。
+
+由 CSL 编写的 style 定义了引用和参考文献目录的格式。Zotero 就是通过 style 来生成指定格式的引用和参考文献目录。据统计，现在已经有超过 9000 个 style，覆盖了大多数的常见的 SCI 期刊。在 Zotero 中能很容易检索到对应期刊的 style。但是即使有这么多的 style，仍然有可能有的期刊没有对应的 style。此外，有的 style 年代久远，已经不符合期刊 author guideline 中的要求，因此，我们需要学习 CSL 来定制需要的 style，至少能在已有的 style 上修改来满足期刊的要求。但是遗憾的是，国内 CSL 的资料几乎没有。
+
+本项目是对 [CSL 英文文档](https://docs.citationstyles.org/en/stable/primer.html) 的翻译。本人能力有限，理解和翻译有误处请大家谅解，同时欢迎 issue 和 pull。
+
+本文档基于 [Welcome to CSL-chinese’s documentation! — CSL-chinese documentation](https://csl-chinese.readthedocs.io/en/latest/) 修改。
+
+> [!danger] 译者注
+> 文档中，凡标注 Work in progress 的均为正在施工的页面，无法确保与现有英文文档相一致，无法确保译文修改前后的一致性、准确性，请酌情阅读。

src/csl-dev-guide/appendix/appendix1-categories.md

@@ -0,0 +1,37 @@
+---
+title: 附录 I 学科分类
+date: 2022-08-01 16:42:15
+updated: 2022-08-03 10:27:14
+---
+
+# 附录 I 学科分类
+
+> [!warning] WORK IN PROGRESS
+> 此页面正在施工中。
+
+- anthropology 人类学
+- astronomy 天文学
+- biology 生物学
+- botany 植物学
+- chemistry 化学
+- communications 通讯
+- engineering 工程学
+- generic-base - used for generic styles like Harvard and APA 通用基础 - 用于通用样式，像哈弗和 `APA`
+- geography 地理学
+- geology 地质学
+- history 历史
+- humanities 人文学科
+- law 法学
+- linguistics 语言学
+- literature 文学
+- math 数学
+- medicine 药物学
+- philosophy 哲学
+- physics 物理学
+- political_science 政治科学
+- psychology 心理学
+- science 科学
+- social_science 社会科学
+- sociology 社会学
+- theology 神学
+- zoology 动物学

src/csl-dev-guide/appendix/appendix2-terms.md

@@ -0,0 +1,123 @@
+---
+title: 附录 II 术语
+date: 2022-08-01 16:43:59
+updated: 2022-08-03 10:28:07
+---
+
+# 附录 II 术语
+
+> [!warning] WORK IN PROGRESS
+> 此页面正在施工中。
+
+术语在本地化文件中使用
+
+## Locators/用来定位的术语
+
+- book 书
+- chapter 章
+- column  
+- figure 图
+- folio 作品集
+- issue 议题/问题
+- line 行
+- note 笔记/注记
+- opus 作品（音乐作品）
+- page 页
+- paragraph 段
+- part 部分
+- section 节
+- sub verbo 词条
+- verse 诗
+- volume 卷
+
+## Months/月
+
+- month-01
+- month-02
+- month-03
+- month-04
+- month-05
+- month-06
+- month-07
+- month-08
+- month-09
+- month-10
+- month-11
+- month-12
+
+## Ordinals/序数
+
+- ordinal
+- ordinal-00 through ordinal-99
+- long-ordinal-01
+- long-ordinal-02
+- long-ordinal-03
+- long-ordinal-04
+- long-ordinal-05
+- long-ordinal-06
+- long-ordinal-07
+- long-ordinal-08
+- long-ordinal-09
+- long-ordinal-10
+
+## Quotation marks/引号
+
+- open-quote
+- close-quote
+- open-inner-quote
+- close-inner-quote
+
+## Roles/角色
+
+- author 作者
+- collection-editor 文集编辑
+- composer 作曲者
+- container-author 文章作者
+- director 主任/导演
+- editor 编辑
+- editorial-director 编辑部主任
+- editortranslator
+- illustrator 插画者
+- interviewer 采访者
+- original-author 原作者
+- recipient 收件人
+- reviewed-author 复查作者
+- translator 译者
+
+## Seasons/季节
+
+- season-01
+- season-02
+- season-03
+- season-04
+
+## Miscellaneous/其他
+
+- accessed
+- ad
+- and
+- and others
+- anonymous
+- at
+- available at
+- bc
+- by
+- circa
+- cited
+- edition
+- et-al
+- forthcoming
+- from
+- ibid
+- in
+- in press
+- internet
+- interview
+- letter
+- no date
+- online
+- presented at
+- reference
+- retrieved
+- scale
+- version

src/csl-dev-guide/appendix/appendix3-types.md

@@ -0,0 +1,46 @@
+---
+title: 附录 III 文献类型
+date: 2022-08-01 16:47:15
+updated: 2022-08-03 10:28:14
+---
+
+# 附录 III 文献类型
+
+> [!warning] WORK IN PROGRESS
+> 此页面正在施工中。
+
+- article 文章
+- article-magazine 杂志文章
+- article-newspaper 新闻文章
+- article-journal 期刊文章
+- bill
+- book 书
+- broadcast
+- chapter 章节
+- dataset 数据集
+- entry
+- entry-dictionary
+- entry-encyclopedia
+- figure 图
+- graphic
+- interview 采访
+- legislation
+- legal_case
+- manuscript
+- map 地图
+- motion_picture
+- musical_score
+- pamphlet
+- paper-conference
+- patent
+- post 海报
+- post-weblog  
+- personal_communication 私人交流
+- report 报告
+- review
+- review-book
+- song 歌曲
+- speech 演讲
+- thesis 学位论文
+- treaty
+- webpage 网页