LilyPond教程（1）——安装和运行（旧版）

LilyPond (荷花池) 是一个免费开源的打谱软件。它能完成很多精细的定制化操作，从而制作出非常精美的乐谱。

LilyPond不同于其它图形化界面的打谱软件，它仅通过文字就能完成操作：你甚至可以不用打开这个软件，只通过记事本等文本编辑器就能完成一份乐谱。所以，它对设备环境要求不高，能很好兼容各个平台。

在LilyPond系列教程的开始，我们先来看看它是如何安装和运行的。（这是面向小白的教程，可能会显得啰嗦，有些地方可以读者根据自己的理解能力略过）

1 安装

1.1 下载安装

Lilypond可以通过官方网站下载。在网站下载页找到自己系统对应的安装包，按照安装程序的指示一步步安装即可。
本篇适用于Windows用户（尤其是Windows 7/8的用户），Mac或者Linux用户的安装运行操作，可以到官网下载页查看（这里是Lilypond的Mac版本官方下载页）

安装过程中需要关注一下安装路径（比如我装在了E盘，路径就是E:\Program Files\LilyPond），后面会用到。

1.2 配置环境变量

安装结束后，先不急着打开。我们先去配置环境变量，以便后续使用。

打开控制面板→系统→高级系统设置，点击“环境变量…”按钮，在下方“系统变量”中找到"Path"。

双击“Path”打开编辑界面（或点击它，然后点击“编辑”），点击右侧的“新建”，在打开的框中输入：安装路径\usr\bin（比如按照我的就应该输入：E:\Program Files\LilyPond\usr\bin）（又：如果安装过程中没有关注安装路径，一般默认的安装路径可能是C:\Program Files\LilyPond，大家可以查看相应路径是否有对应的文件夹）

一路点击“确定”，保存所有修改，最后退出控制面板，就完成了环境变量的配置。

2 运行

LilyPond的运行方式跟普通图形界面的打谱软件有所不同。在此，我建议初学时，最好使用记事本来进行操作。 这样能更好地熟悉这个软件的运行方式。

首先打开记事本，输入如下代码

{
	a b c d e f g
}

保存为以ly为扩展名的文件。（比如MyFirstScore.ly）找到你刚保存的文件，它的图标应该会变为一个音符，这时候你的第一份乐谱就打好了。但它是代码，怎么进行编译呢？或者说，怎么把这些文字变成乐谱呢？下面介绍两种方式。

2.1 简单运行

双击你要编译的文件。或者右击你要编译的文件，选择"Generate PDF …"

稍等片刻，在同一个文件夹下面就会出现"MyFirstScore.log"和"MyFirstScore.pdf"两个文件了，这时候得到的PDF就是我们想要的乐谱了。

2.2 命令行运行

使用命令行运行能够比较好地控制导出文件的位置，同时也能看到编译错误，以便于调试。这种方式也是LilyPond推荐的一种编译方式。（如果一开始你直接点击LilyPond的图标打开它，会把命令行也一并打开）使用命令行来编译有以下步骤：

1. 打开命令行（使用快捷键win+R，输入cmd，然后回车）
2. 进入到你准备保存PDF文档的目录（比如我准备保存到"D:\LilyPond教程\PDF"下，就输入cd /d D:\LilyPond教程\PDF，键入回车）
3. 输入“lilypond+空格+文件名”，键入回车完成编译，编译好的乐谱PDF文档就会存到对应的位置了。注意如果你准备保存PDF档的位置与ly文件不同，则要输入对应的路径。（比如我准备编译"D:\LilyPond教程\Code"下的"MyFirstScore.ly"，就输入lilypond D:\LilyPond教程\Code\MyFirstScore.ly）

PS：其实上面提到的是一种比较麻烦的方法，不过这么做比较稳妥，便于小白操作。后面建议了解一下命令行中cd的用法，熟悉文件路径的操作，这样能大大提升效率。如果对命令行操作熟悉的话，只需要知道lilypond这一命令是用来编译的就可以了，路径可以根据自己的需求灵活处理。

需要注意的是，如果你对乐谱进行了修改，想重新编译文档。记得在编译开始前将你打开的PDF档关闭，否则新的乐谱将无法写入。

最后编辑出来的乐谱长这样：

3 总结

了解LilyPond的安装和运行是了解这款软件的第一步。我们可以看到，只要有ly文件，在任何一个安装了LilyPond的平台上都可以进行修改和编译，这便是这款软件的最重要优势。
当然LilyPond的优点还不只是这些，它还能帮助我们做到一些其他打谱软件不能做到的精细排版处理。
那么LilyPond的代码需要遵循什么样的语法？或者说ly文件里面究竟应该写些什么，来帮我们打出想要的乐谱呢？就在后面的教程中陆续介绍啦。

4 补充（2023年6月）

最新版LilyPond的安装流程已经完全不同，请查阅本系列最新安装教程。