谱文混排之lilypond-book

2021年11月25日 阅读数:3
这篇文章主要向大家介绍谱文混排之lilypond-book,主要内容包括基础应用、实用技巧、原理机制等方面,希望对大家有所帮助。

Lilypond有自带的谱文混排的工具lilypond-book,可是做为外行,一直很难搞清楚这个操做是怎样作的。好久以前请教过别人,但介于个人我的能力,只有粗浅理解,操做不得要领。在许多信息的拼凑以后,终于掌握了lilypond-book的基本使用方法。虽然这个方法极度不方便,但也算对lilypond的了解多了一分,因此仍是作了记录html

 

-----------------------------------------------python

 

lilypond-book的说明文档能够见shell

LilyPond Application Usage: 3. Running lilypond-book编辑器

里面全是英文,看着也晕了很久。工做原理大概是创建 lytex 文件-----> (通过lilypond-book的运行)创建 tex 文件-----> 由tex里的pdflatex指令编译成pdf文件工具

这个流程真的太劝退了……先无论这个,如下几个部件是必备的:测试

1 必备部件

1. lilypond本体,来自 LilyPond – 人人的曲谱软件: 下载编码

2. lilypond-book是python文件,因此最好装一个python;lua

3. tex的运行组件,我我的下载的是texlive,来自 Index of /CTAN/systems/texlive/Images/ | 清华大学开源软件镜像站 | Tsinghua Open Source Mirrorspa

 

有了这三项以后,开始部署:命令行

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. 此路目前死路一条,谱文混排摸索未完待续……