3.4调用百合装订本

百合装订本生成包含以下内容之一的文件扩展名:.tex码,.特西,.html格式.xml文件,取决于输出格式。所有.tex码,.特西.xml文件文件需要进一步处理。

特定于格式的说明

乳胶

有两种方法可以处理LaTeX文档以进行打印或发布:使用pdfLaTeX直接获取PDF文件(XeLaTeX、luaLaTeX)或获取通过DVI-to-PostScript转换器(如数字视频处理程序第一种方法更简单,建议使用6,以两者中的一个为准按照您的使用方式,您可以使用工具,如ps2pdf格式pdf2ps包含在中Ghostscript包。

要使用pdfLaTeX生成PDF文件,请使用:

lilypond-book--pdf yourfile.lytex格式pdflatex文件.tex

通过LaTeX生成PDF输出/数字视频处理程序/ps2pdf格式:

lilypond-book你的文件.lytex乳胶yourfile.texdvips-Ppdf您的文件.dvips2pdf yourfile.ps

这个.dvi此过程创建的文件将不包含注释头。这是正常的;如果你按照说明去做,它们将被包括在这个.ps(磅).pdf格式文件夹。

正在运行数字视频处理程序可能会产生一些关于字体的警告;这些是无害的,可能会被忽视。如果你在跑步乳胶在里面双列模式,记住添加-t横向数字视频处理程序选项。

环境,如

\开始{lilypond}…\end{lilybond}

LaTeX不解释。相反,百合装订本提取物这些“环境”会变成自己的文件,并在上面运行LilyPond。然后获取结果图形并创建.tex码文件其中\开始{lilypond}\结束{lilypond}被“图形包含”命令替换。就在这里LaTeX运行的时间(尽管LaTeX之前会运行,实际上,它会出现在“空”文档上,以便计算LilyPond片段的图纸尺寸和线宽)。

已知问题和警告

这个\分页符命令在\开始{lilypond}…\结束{lilypond}环境。

许多\纸张块变量在\开始{lilypond}…\end{lilybond}环境。使用\new命令具有\百合池系统之间在序言中。

\新命令{\betweenLilyPondSystem}[1]{\vspace{36mm}\linebreak}

特辛福

要生成Texinfo文档(以任何输出格式),请按照常规Texinfo程序;也就是说,要么打电话texi2pdf格式texi2dvi公司texi2any公司,取决于输出格式您想要创建。默认情况下,texi2pdf格式使用pdftex公司用于处理,可以在控制台输出中进行验证。在这种情况下,运行百合装订本使用--pdf格式选项,以便创建.pdf格式片段,而不是.eps(.eps)文件夹。pdftex公司无法包含后一个,将输出错误消息否则。

有关更多详细信息,请参阅Texinfo的文档。

命令行选项

百合装订本接受以下命令行选项。

-(f)格式
--格式=格式

指定要处理的文档类型:html格式,乳胶,特西语(默认设置),texi-html公司,或文档簿.如果该选项缺失,lilypond书尝试自动检测格式,请参阅文件扩展名目前,texi-html公司与相同特西语.

-F类滤波器
--过滤器=滤波器

管道片段通过滤波器。使用此选项,百合装订本不创建代码段文件;相反,它修改输入文档中嵌入代码段的代码并发出结果文件,然后可以对其进行处理通过另一次跑步百合装订本(没有--过滤器选项)。示例:

lilybond-book--filter='convert-ly--from=2.0.0-'我的book.tely

百合装订本不接受选项--过滤器--过程同时。

-小时
--帮助

打印简短的帮助消息。

-我目录
--包括=目录

添加目录到包含路径。百合装订本还有外观对于包含路径中已编译的代码段,不写入它们返回到输出目录,在某些情况下需要调用进一步的处理命令,例如texi2any公司乳胶用同样的-我目录选项。

-我对数电平
--对数电平=对数电平

将输出详细程度设置为对数电平。可能的值为,错误,警告,进展(默认),以及调试.如果未使用此选项,且环境变量LILYPOND_BOOK_LOGLEVEL公司则其值用作日志级别。

-o个目录
--输出=目录

将生成的文件放入目录目录.正在运行百合装订本生成许多LilyPond将要生成的小文件过程。要避免源目录中的所有混乱,请使用--输出命令行选项,并更改为该目录在运行之前乳胶texi2any公司.

lilypond-book--output=输出您的文件.lytexcd输出
--跳过检查

如果找不到LilyPond输出,请不要失败。它用于生成LilyPond的Info文档没有图像。

--跳过png检查

如果没有为EPS文件找到PNG图像,请不要失败。它用于在没有图像的情况下生成LilyPond的Info文档。

--lily输出dir=目录

写入百合-XXX(XXX)文件到目录目录并链接到--输出目录。使用此选项可节省构建时间用于共享大量相同内容的不同目录中的文档代码段。

--百合木水平仪=对数电平

设置被调用的百合香命令到对数电平。可能的值为,错误,警告,基本,进展,信息(默认),以及调试。如果不使用此选项,并且环境变量LILYPOND_LOGLEVEL(脂池_液位)设置,则使用其值作为日志级别。

--信息-图像-目录=目录

格式化Texinfo输出,以便Info在中查找音乐图像目录目录.

--在线换档=变速换档

在LaTeX后端中,使用变速换档垂直移动所有内联图像。变速换档是图像高度的一个因素;默认值为-0.3,从而将图像向下移动约三分之一高度。可以使用内联snippet选项。

--最新节目=掠夺

运行可执行文件掠夺而不是乳胶。这是如果处理文档时使用X乳胶,用于例子。

--左路加法=数量

在左侧用空白填充LilyPond片段。

数量单位为毫米相对于起点员工人数。默认值为3.0mm。

紧剪裁系统的宽度可能因符号元素而异例如位于壁的开始。填充设置片段图像的左边距和开头(无凹痕)棒;这允许在主文档。

除了左侧填充外,此选项还缩短了每个员工的人数按行数量。因此,每一行都移动到视觉效果良好。

请注意数量,用于填充,向上取整为的整数倍重大问题(bp)单位PostScript和PDF输出(1 bp约为1/72英寸。0.353mm)。然而,这并不是在百合池一侧完成的缩短员工队伍。这可能会导致一个微小但员工长度的变化可能令人惊讶,而不是改变填充,如果数量不是bp单位的整数倍。

-P(P)命令
--过程=命令

使用处理LilyPond代码段命令。默认命令为百合香.百合装订本不接受选项--过滤器--过程同时。

--pdf格式

创建PDF代码段文件。如果未设置,则仅生成PNG和EPS文件。如果要将PDF文件直接嵌入LaTeX或Texinfo文件。

--重定向连接输出

默认情况下,日志输出显示在终端上。此选项将所有输出重定向到与源位于同一目录中的日志文件文件夹。

--使用源文件名

使用与源文件相同的基名称编写代码段输出文件。此选项仅适用于lilypondfile文件命令,并且仅当--输出直径--lily输出dir选项不同。

-V(V)
--冗长的

要详细。这相当于--loglevel=调试.

-v(v)
--版本

打印版本信息。

已知问题和警告

Texinfo命令@页面大小未解释。同样,更改前导码后边距和线宽的LaTeX命令被忽略。

只有第一个\分数处理LilyPond块。


脚注

(6)

注释pdfLaTeX和LaTeX可能不能同时用于编译任何LaTeX文件,这就是我们解释这两种方式的原因。


LilyPond应用程序使用v2.25.16(开发分支)。