Add Chinese Translations for Alda Documention

doc/doc_zh_cn/chords_zh_cn.md

@@ -0,0 +1,11 @@
+# 和弦
+
+*此页面翻译自[chouds.md](../chouds.md)*
+
+**和弦**是一组具有相同[偏移量](offset_zh_cn.md)的[音符](notes_zh_cn.md) 即它们开始奏响的时间是相同的 在Alda中表示和弦 可以在组成和弦的音符之间加上斜杠`/` 例如 `c/e/g`
+
+和弦的音符之间可以有八度变化 这允许和弦跨越多个八度: `c/g/>c/e/g`
+
+和弦中的音符可以有不同的长度 在这种情况下 和弦之后的下一个音符事件会发生在**和弦中最短的音符** 之后这样可以轻松获得带有变调的和弦 例如: `c1~1/>c/<e4 f g f e1` (另外请注意 在定义了新的音符时值后 每个音符的时值都会成为后续所有音符的默认值 这与连续音符一样 -- 所以 刚刚的和弦中的两个C音符的时值都是2个全音符)
+
+在Alda中 您还可以在和弦中使用[休止符](rests_zh_cn.md) 因为和弦后的下一个音符事件将在和弦中最短的音符/休止符之后开始 这个特性对于编写与和弦交织在一起的旋律很有用 例如 `c1/e/g/r4 b e g`

doc/doc_zh_cn/editor-plugins_zh_cn.md

@@ -0,0 +1,18 @@
+# 编辑器插件
+
+*此页面翻译自[editor-plugins.md](../editor-plugins.md)*
+
+为了能在编辑Alda乐谱时拥有最好的体验 请为您的编辑器安装Alda插件 它们可以提供语法高亮等功能 在某些编辑器(如Vim和Emacs)中 它们还有更多功能 例如键盘快捷键 以及播放您正在编写的Alda乐谱
+
+> 没有您喜欢的编辑器的插件?
+> 编写您自己的插件 打开pr将其添加在此处! (^._.^)ﾉ
+
+|编辑器|插件|
+|--|--|
+|Ace|[内置支持](https://ace.c9.io)|
+|Atom|[MadcapJake/language-alda](https://github.com/MadcapJake/language-alda)|
+|Eclipse|[VishwaasHegde/Alda-Eclipse-Plugin](https://github.com/VishwaasHegde/Alda-Eclipse-Plugin)|
+|Emacs|[jgkamat/alda-mode](https://gitlab.com/jgkamat/alda-mode)|
+|Sublime Text|[erinzm/sublime-alda](https://github.com/erinzm/sublime-alda)|
+|Vim|[daveyarwood/vim-alda](https://github.com/daveyarwood/vim-alda)|
+|VS Code|[abhi18av/Alda-VsCode](https://github.com/abhi18av/Alda-VsCode)|

doc/doc_zh_cn/index_zh_cn.md

@@ -0,0 +1,54 @@
+# Alda: 文档™
+
+*翻译自[此页面](../index.md)*
+
+这是Alda的官方文档的索引页面 如果你想要了解Alda的更多信息及如何用它编写出色的乐谱 请继续阅读!
+
+## 有用的链接
+
+* [Alda官网](https://alda.io)
+* [社区](https://alda.io/community)
+* [为Alda做贡献](../CONTRIBUTING.md)
+* [CHANGELOG (发行说明)](../CHANGELOG.md)
+* [Dave于2015年发布的基于文本的音乐创作的的宣言](https://blog.djy.io/alda-a-manifesto-and-gentle-introduction)
+* Alda 博客系列
+  1. [Your first notes(第一个音符)](https://blog.djy.io/writing-music-with-alda-1/)
+  2. [Rhythm and meter(节奏和节拍)](https://blog.djy.io/writing-music-with-alda-2/)
+  3. [Flats, sharps, and key signatures(升号 降号和调式标记)](https://blog.djy.io/writing-music-with-alda-3/)
+* [Alda2迁移指南](alda-2-migration-guide_zh_cn.md)
+
+## 从这里开始
+
+* [安装Alda](https://alda.io/install)
+
+* [安装优质的SoundFont(音色库)](installing-a-good-soundfont_zh_cn.md)
+
+* [编辑器插件](editor-plugins_zh_cn.md)
+
+* [Alda教程](https://alda.io/tutorial)
+
+* 这篇文章[scores and parts(乐谱及各部分)](scores-and-parts_zh_cn.md)提供了一些关于Alda乐谱的一般信息 如果你有兴趣了解Alda乐谱基本部分的更多信息 可以查看下列文档:
+  * [音符](notes_zh_cn.md)
+  * [休止符](rests_zh_cn.md)
+  * [和弦](chords_zh_cn.md)
+  * [声部](voices_zh_cn.md)
+  * [markers](markers_zh_cn.md)
+  * [offset](offset_zh_cn.md)
+  * [attributes](attributes_zh_cn.md)
+  * [repeats](repeats_zh_cn.md)
+  * [variables](variables_zh_cn.md)
+  * [cram expressions](cram-expressions_zh_cn.md)
+  <!-- 这里的一些术语在我翻译了那些页面后再进行翻译...-->
+
+* 请仔细阅读此[可用乐器列表](list-of-instruments_zh_cn.md).
+
+## 如何使用文档
+
+Alda的文档由一组[Markdown](https://daringfireball.net/projects/markdown)文件构成 这些文件大部分是相互关联的 它们可以作为Alda的"官方手册": 关于如何在Alda乐谱中完成所有操作的权威指南
+
+文档之间包含尽可能多的相对链接 它就像[wiki](https://en.wikipedia.org/wiki/Wiki)一样 它们由Alda项目组进行版本控制和维护 并得到社区(就是您)的帮助 Alda的文档维护是一个永久进行的工作 任何人都可以为这个项目贡献力量
+
+如果您是那种爱好学习和了解一切的人 您可以[浏览整个文件夹](../) 或直接选择一篇文章开始阅读 点击任何您感兴趣的链接 看看它连到哪个页面 无论您想干什么 都可以...尽情探索吧!
+
+如果您在阅读文档时 发现任何可以改进的东西(哪怕是一个小小的拼写错误) 注意到某些信息有误或缺失 或者只是对某些东西感到困惑 请随时[提交pr](https://github.com/alda-lang/alda/pulls)或[提出一个issue](https://github.com/alda-lang/alda/issues)来帮助我们改进文档! 不要害羞!
+

doc/doc_zh_cn/installing-a-good-soundfont_zh_cn.md

@@ -0,0 +1,43 @@
+# 安装优质的soundfont(音色库)
+
+*此文档翻译自[installing-a-good-soundfont.md](../installing-a-good-soundfont.md)
+
+默认的JVM音色库通常音质较差 我们建议安装免费的音色库 如FluidR3 使您的MIDI音色更悦耳
+
+各种流行的免费音色库 包括FluidR3 均可从[这里](https://musescore.org/en/handbook/soundfonts#list)下载
+
+## Mac / Linux
+
+For your convenience, there is a script in this repo that will install the
+FluidR3 soundfont for Mac and Linux users.
+为了便于操作 此仓库中有一个shell脚本 用于为MacOS和Linux用户安装FluidR3音色库
+
+获取脚本的副本
+
+```bash
+curl \
+  https://raw.githubusercontent.com/alda-lang/alda/master/scripts/install-fluidr3 \
+  -o /tmp/install-fluidr3
+
+chmod +x /tmp/install-fluidr3
+```
+
+如果您愿意 可以在运行脚本之前检查一下:
+
+```bash
+/tmp/install-fluidr3
+```
+
+这会下载FluidR3 并用它替换`~/.gervill/soundbank-emg.sf2`(您的JVM的默认音色库)
+
+## Windows
+
+<img src="windows_jre_soundfont.png"
+     alt="在Windows上替换默认的音色库">
+
+要在Windows系统上替换默认的音色库:
+
+1. 找到Java运行时环境(JRE)的目录 并导航到`lib`文件夹
+    * 如果您安装了JDK8或更早的版本 请找到JDK的目录并导航到`jre\lib`文件夹
+2. 创建一个名为`audio`的新文件夹
+3. 将任何".sf2"格式的文件复制到此文件夹中

doc/doc_zh_cn/notes_zh_cn.md

@@ -0,0 +1,97 @@
+# 音符
+
+*本页面翻译自[Notes](../notes.md)*
+
+Alda的**音符**深受[MML](https://en.wikipedia.org/wiki/Music_Macro_Language#Modern_MML)的启发
+
+## 组件
+
+### 八度组
+
+西方音乐理论将音高分为12个音符的重复组(十二平均律) 例如: (升序的) `c c# d d# e f f# g g# a a# b (高八度) c c# d`等等
+
+音名(如C#)与八度的组合决定了音符的频率 八度组用数字表示 通常在1到7之间 它们对应于[科学音高记号](https://zh.wikipedia.org/wiki/%E7%A7%91%E5%AD%A6%E9%9F%B3%E9%AB%98%E8%AE%B0%E5%8F%B7)(也称国际音高记号)
+
+例如 中央C与A440都在第4个八度组中 这也是Alda中默认的八度组
+
+与MML一样 八度组与音符本身是分开设置的--八度组不是"附加"于音符 而是每个音符都查看当前的八度组来确定自己的音高
+
+您可以用这两种方式设置八度组:
+
+`o5` 将八度组设置为5 任何整数都可以跟在`o`后面
+
+`<` 将当前八度组减少1. `>`将当前八度组增加1.
+
+### 时值
+
+在Alda中 音符的时值通常以标准音乐符号中的音符长度表示 与MML一样
+
+它以数字形式表示 4是四分音符 2是二分音符 1是全音符 等等
+
+音符后面可以添加任意数量的点`.` 它代表附点 与标准音乐符号相同--它会将音符的时值延长到其原先时值的1.5倍(也就是延长其一半的时值)
+
+例如
+
+```
+2 = 二分音符 2拍
+2. = 附点二分音符 3拍(2 * 1.5)
+2.. = 复附点二分音符 3.5拍(2 * 1.5 + (2 * 0.5 * 0.5))
+```
+
+*译者注: 当一个音符有复附点时 每次附的点所延长的时值是上一个点所延长的时值的一半*
+
+音符时值也可以用连音线语法`~`相加 例如: `4~4` = 两个四分音符加在一起 总共2拍
+
+当音符在乐谱中按顺序解析时 Alda会跟踪当前八度组和当前默认的音符时值 每当您指定新的八度组和音符时值时 那些数据会被设为新的默认值
+
+如果您没有指定音符的时值 则每个音符都将遵循默认的初始时值 在每个乐器部分的开头 默认的八度组为4 默认的音符时值为4(即四分音符 1拍)
+
+#### 高级节奏
+
+* Alda的一个特殊功能是您可以使用非标准的数字(非2的幂)作为音符的时值标记 例如 6表示在4/4拍中持续1/6小节的音符 在标准的符号中 没有"六分音符" 但是这个音符的时值通常表示为四分音符三连音中的一个音符 但在Alda中 "六分音符"不一定是三连音的一部分 这为创造更多有趣的节奏创造了可能性
+
+* 扩展这个概念--Alda允许非整数的十进制音符时值标记
+
+  例如 `c0.5`(或是西方古典符号中的双全音符)是`c1`(全音符)时值的两倍
+
+  这些数字不必是2的幂 例如 `c2.4`也是有效的
+
+* Alda还有一种指定节奏的替代方法 称为[cram表达式](cram-expressions_zh_cn.md)
+
+* 音符时值也可以用毫秒(ms)和秒(s)表示 可以随意混搭标准音符长度:
+
+  ```alda
+  c350ms    # 持续350毫秒的C音符
+  d2s       # 持续2秒的D音符
+  e2s~200ms # 持续2秒+200毫秒的E音符
+  f300ms~4. # 持续300毫秒+附点四分音符的F音符
+  ```
+
+### 音符格式
+
+在Alda中 一个音符的格式为:
+从a到g的一个字母 任意数量的临时变音记号(可选) 音符时值标记(可选)
+
+降号和升号可以使音高降低/升高半音 在Alda中 降号和升号可以表示为`-`和`+` 您也可以使用多个升号或降号 甚至可以把它们组合起来 例如 `c++` = 双升号C = D
+
+*对于非C大调的乐曲*(*译者举例*) 可能会出现这样的情况: 在每个不在C调上的音符上放置升/降号 我们更推荐您使用[预设调号](attributes_zh_cn.md#key-signature) 这可以为每个需要的音符预设必要的升/降号以匹配调性 您可以参考下文中的示例
+
+要覆盖预设调号指定的降号/升号 您可以添加一个临时变音记号 即`+` `-`可以使音符升调或降调 还有`_`代表还原号 它会强制音符为自然音 例如`c_`是C自然音 无论您之前选择了哪个调子
+
+## 示例
+
+以下是1个八度的B大调音阶 从第4组开始上升和下降
+
+```alda
+o4 b4 > c+8 d+ e f+ g+ a+ b4
+a+8 g+ f+ e d+ c+ < b2.
+```
+
+这是同一个示例 在开头处预设了B大调中被升高的那些那些音名 这样就可以避免在乐谱中重复写升降号 它们会自动以您定义的升降号演奏
+
+```alda
+(key-signature "f+ c+ g+ d+ a+")
+o4 b4 > c8 d e f g a b4
+a8 g f e d c < b2.
+```
+

doc/doc_zh_cn/offset_zh_cn.md

@@ -0,0 +1,7 @@
+# 偏移量
+
+*此文档翻译自[offset.md](../offset.md)*
+
+Alda通过为每个[音符](notes_zh_cn.md)分配一个**偏移量**来按时间顺序放置音符 偏移有两种类型:绝对和相对
+
+绝对偏移表示距离乐谱开头的毫秒数 相对偏移表示距离[标记](markers_zh_cn.md)后的毫秒数

doc/doc_zh_cn/readme.md

@@ -0,0 +1,54 @@
+# 翻译说明
+
+这里是由[欧阳闻奕](https://github.com/OWALabuy)提供的中文版文档翻译
+
+这是[索引页面](./index_zh_cn.md) 您可以从这个页面开始阅读
+
+## 计划与规范
+
+翻译所有文档 所有文档的中译版存放在[本目录](./)下 而不与原文档的目录混淆
+
+所有翻译后的文档的文件名加上`_zh_cn` 以与原文档区别 并在翻译文档的开头处插入指向原文档的链接
+
+所有翻译后的文档中的指向本仓库的链接 均将其改为中文版链接
+
+## 其他说明
+
+译者是小学生 英语水平差 很多单词不认识要去查翻译
+
+因为文化背景存在差异 很多地方没有严格按照原文进行翻译 会掺杂自己的想法 但是会尽力将原文的意思表达出来 有争议之处均以原文为准
+
+译者虚心接受批评 如有翻译不当之处 敬请匡正 感谢各位
+
+## 翻译进度
+
+### doc目录下的文档
+
+- [ ] alda-2-migration-guide.md
+- [ ] alda-client.md
+- [ ] alda-repl.md
+- [ ] alda-repl-server-api.adoc
+- [ ] attributes.md
+- [x] chords.md
+- [ ] comments.md
+- [ ] cram-expressions.md
+- [x] editor-plugins.md
+- [ ] implementing-an-alda-library.md
+- [x] index.md
+- [x] installing-a-good-soundfont.md
+- [ ] instance-and-group-assignment.md
+- [ ] list-of-instruments.md
+- [ ] markers.md
+- [x] notes.md
+- [x] offset.md
+- [ ] repeats.md
+- [x] rests.md
+- [ ] scores-and-parts.md
+- [ ] sequences.md
+- [x] tempo.md
+- [ ] troubleshooting.md
+- [ ] variables.md
+- [ ] voices.md
+- [ ] writing-music-programmatically.md
+
+### 其他文档

doc/doc_zh_cn/rests_zh_cn.md

@@ -0,0 +1,10 @@
+# 休止符
+
+此页面翻译自[reset.md](../reset.md)
+
+**休止符**的工作方式与[音符](notes_zh_cn.md)完全相同 只是它用的是字母`r`(带有可选的时值 遵循的规则与音符相同)
+
+当Alda遇到休止符时 它会等待休止符的持续时间 然后再奏响下一个音符
+
+(在底层 它只是将当前[偏移量](offset_zh_cn.md)向前移动 而不会创建任何音符事件)
+

doc/doc_zh_cn/tempo_zh_cn.md

@@ -0,0 +1,49 @@
+# 节奏
+
+此项目翻译自[tempo.md](../tempo.md)
+
+乐谱的**节奏**描述了音符演奏的快慢程度 这个值通常以每分钟节拍数(BPM)表示 与音符的时值(如四分音符 二分音符 全音符)结合使用 以确定音符的持续时间(以毫秒为单位)
+
+## `tempo`属性
+
+在Alda中 指定节奏的最简单方法是通过`tempo`属性 它可以以BPM指定节奏 其中每个节拍占用一个四分音符的长度(以四分音符为一拍)
+
+例如 要指定180BPM的节奏 (♩ = 180):
+
+```alda
+(tempo! 180)
+```
+
+在传统音乐符号中 通常会看到以每分钟节拍数描述的节奏 但是有的拍号不是以四分音符为一拍 例如 节奏可以用"每分钟二分音符"来表示 即 𝅗𝅥 = 100 这仍然是"每分钟节拍" 只是它是以二分音符为一拍的
+
+Alda的`tempo`功能非常灵活 它允许您指定以什么时值的音符为一拍
+
+```alda
+(tempo! 2 100)
+```
+
+在三拍子中 通常是以带附点的音符为一拍 例如在6/8拍下 每个小节通常表示为2拍 以附点四分音符(♩.)为一拍 这种情况下 用作为节拍的音符时值来表示节奏就很方便
+
+`tempo`属性的音符值参数必须是有效的数字或字符串 刚刚的例子中 `4.`不是有效数字 您需要用一对双引号将其声明为字符串
+
+```alda
+# ♩. = 100
+(tempo! "4." 100)
+```
+
+## 节拍转换
+
+您也可能通过[节拍转换](https://en.wikipedia.org/wiki/Metric_modulation)来表达节奏 即从一个节拍转换到另一个节拍
+
+例如 假设您在编写一个以9/8开头的乐谱--以附点四分音符为一拍 每小节3拍
+
+在乐曲中 您想要过渡到3/2拍--每小节仍然是3拍 但是现在以二分音符为一拍 您希望曲速保持不变(一拍的实际时长不变) 将现在每个节拍细分为4个八分音符 而不是3个 要怎么做呢
+
+在传统记谱法中 当乐谱的拍号发生变化时 通常会有"♩. = 𝅗𝅥 "这样的注释 在那之后 拍子保持不变 但过去表示附点四分音符的时间量现在表示二分音符 当管弦乐队演奏到乐谱中的那个地方时 指挥家继续以相同的"速度"指挥 但每位音乐家都会在心里调整自己跟拍子的思路 在心理上将每拍看作四个八分音符 而不是3个八分音符
+
+在Alda中 您可以将"♩. = 𝅗𝅥 "这样的节拍转换表示为:
+
+```alda
+(metric-modulation! "4." 2)
+```
+

doc/doc_zh_cn/voices_zh_cn.md

@@ -0,0 +1,31 @@
+# 声部
+
+*此页面翻译自[voice.md](../voice.md)*
+
+**Voices** provide a way to subdivide an instrument into its own separate parts,
+which play simultaneously. This can be useful for polyphonic instruments, that
+is, instruments that can play more than one [note](notes.md) at a time, e.g.
+guitar, piano.
+**声部**提供了一个...的方法 
+
+乐器可以同时奏响更多的音符 比如吉他 钢琴
+
+### 例子
+
+```alda
+piano:
+  V1: c d e f g1
+  V2: e f g a b1
+  V3: g a b > c d1
+
+  V0: c4 e g > c2.
+```
+
+Each voice is its own sequence of note events. The first note/[rest](rests.md)
+in each voice starts at the same time, like the notes in a [chord](chords.md).
+Whereas a chord bumps forward the current [offset](offset.md) by the shortest
+note duration in the chord, after a group of voices, the current offset is that
+of the longest voice in the group. `V0:` signals the end of a voice grouping and
+a return to using a single voice -- the first note placed after `V0:` will
+happen after all voices in the group have finished.
+

doc/tempo.md

@@ -55,7 +55,7 @@ measure, where each beat is a dotted quarter note.
 
 At a certain point in the piece, you want to transition into a 3/2 section --
 still 3 beats per measure, but now each beat is a half note. You want the
-"pulse" to stay the same, but now each beat is subdivided into 4 half notes
+"pulse" to stay the same, but now each beat is subdivided into 4 eighth notes
 instead of 3. How do you do it?
 
 In traditional notation, it is common to see annotations like "♩. = 𝅗𝅥 " at the