谱文混排之lilypond-book
Lilypond有自带的谱文混排的工具lilypond-book，但是作为外行，一直很难搞清楚这个操作是怎样做的。很久之前请教过别人，但介于我的个人能力，只有粗浅理解，操作不得要领。在许多信息的拼凑之后，终于掌握了lilypond-book的基本使用方法。虽然这个方法极度不方便，但也算对lilypond的了解多了一分，所以还是做了记录
-----------------------------------------------
lilypond-book的说明文档可以见
LilyPond Application Usage: 3. Running lilypond-book
里面全是英文，看着也晕了好久。工作原理大概是建立 lytex 文件-----> （经过lilypond-book的运行）建立 tex 文件-----> 由tex里的pdflatex指令编译成pdf文件
这个流程真的太劝退了……先不管这个，以下几个部件是必备的：
1 必备部件
1. lilypond本体，来自 LilyPond – 人人的乐谱软件: 下载
2. lilypond-book是python文件，所以最好装一个python；
3. tex的运行组件，我个人下载的是texlive，来自 Index of /CTAN/systems/texlive/Images/ | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror
有了这三项之后，开始部署：
2 部署
2.1 编辑系统环境变量
因为lilypond-book要在命令行模式下执行，而命令行模式默认的指令是不包括它的，所以需要先把lilypond-book设置到环境变量里
我知道对于没用过命令行的人来说这个表述看着就想死……直接讲设置方法吧。在开始菜单的空白处输入“编辑系统环境变量”
进入之后，按下图的顺序，跟着红色箭头走：
1. 进入“环境变量”
2. 点击Path，选择“编辑”
3. 编辑页面里选择“新建”
这时候就是要把lilypond的执行文件的所在文件夹的地址输进去。在lilypond的快捷方式那里点鼠标右键，选择“属性”，按红色箭头点开，这就是文件所在的文件夹。
注意：打开的文件夹先别关掉，一会儿要用
点击红色箭头所在位置，就得到文件夹的地址
把它复制到之前的“编辑环境变量”里，点“确定”就可以了
2.2 修改lilypond-book文件名
是的，lilypond-book 需要修改文件名……回到刚才的文件夹，右键 lilypond-book 这个文件，重命名为 lilypond-book.py
‘
接下来就是输入与编译
3 输入与编译
3.1 创建 lytex 文件
首先打开编辑器，这个就不用介绍了。输入lilypond官方提供的示例文件，来自 LilyPond Application Usage: 3.6 lilypond-book templates
下面是代码
\documentclass[]{article}
\begin{document}
Normal LaTeX text.
\begin{lilypond}
\relative {
a'4 b c d
}
\end{lilypond}
More LaTeX text, and options in square brackets.
\begin{lilypond}[fragment,relative=2,quote,staffsize=26,verbatim]
d4 c b a
\end{lilypond}
\end{document}
然后保存为 lilypond-book.lytex，保存地址最好要是英文地址，记得打开所在文件夹！
3.2 启动 lilypond-book 编译
不要退出这个文件夹，在空白处按住shift键，点右键会看到“在此处打开Powershell窗口”的字样，点开它就到了对应目录下的命令行窗口
接下来的操作就和lilypond官方教程里的一致了，参考下面地址的Processing一节
LilyPond Application Usage: 3.1 An example of a musicological document
进入文抄公时间：
3.2.1 编译tex文件
lilypond-book --output=out --pdf lilybook.lytex
然后就会弹出一坨执行的文字……执行后就发现原来的文件夹里多了一个叫out的文件夹，这是因为刚才输入的指令里，已经把输出的文件夹设置在了out这个文件夹里。
点开out这个文件夹，就能看到lilybook.tex已经生成完毕。这样就完成了从 lytex 到 tex 的转换。
3.2.2 编译pdf文件
现在进入out文件夹，在空白处再次施展shift+右键，启动这个文件夹下的Powershell窗口，输入
pdflatex lilybook
又是一坨文字之后，就可以看到文件夹里多了一堆文字，其中就包括了期待已久的lilybook.pdf！
点开之后就可以看到编译的结果
谱文混排的工序到此告一段落。
4 总结
1. 整个lilypond-book的配置中有若干对新手极不友好的操作，例如设置环境变量、在窗口下开启Powershell，还有命令行的输入。
除了设置环境变量外，每次生成一个lytex都要把步骤3成套重新操作一次，也是醉了，不知道有没有什么办法把这个操作集成起来。
2. 在3.2.2 中，编译pdf文件的代码时pdflatex，这就说明lytex依赖pdflatex这个编码器。而latex的编码器那么多，其他编码器是不是够用就不清楚了，还有待测试
3. 目前知道Latex里面也有集成lilypond代码一起编译pdf文件的宏包，叫 lyluatex，详见 CTAN: Package lyluatex 。但lyluatex的编译到现在我都还没实现……还是希望能直接在latex内部完成编译更好一点
4. 此路目前死路一条，谱文混排摸索未完待续……
