Hi Werner,

Here are some brief fragments that can be added to the documentation. I'm going 
to send it as html-formatted text to enable linking. These are all additions to 
the text already in place; I'll leave it to you to decide where it should go in 
each section.

3 Running lilypond-book

However, users of LaTeX-based systems who compile their documents with LuaLaTeX 
have the option of using the [lyLuaTex](https://ctan.org/pkg/lyluatex) package, 
which offers seamless integration into preexisting TeX-based systems without 
having to compile the document separately through lilypond-book.

3.1 An example…

Users of lyLuaTex will need to add "\usepackage{lyluatex}" between the 
\documentclass and \begin{document} lines.

Input

(show the document content with the \usepackage{lyluatex} statement as 
described)

Processing

Save the code above to a file called lilybook.lytex (lilybook.tex if using 
lyluatex), then in a terminal run the following commands for lilypond-book, or 
compile as you would normally if using lyluatex.

3.2.1

lilypond-book and lyluatex both provide the following commands…

3.3

(I'm unsure whether lyluatex has all these same commands/options)

3.4.1 Invoking lyluatex

lyluatex requires the shell-escape option to be added to the lualatex command 
when compiling your document, but can otherwise be invoked directly from 
whatever editor you use for .tex files. See the lyluatex documentation for more 
options.

-----------

That's what I have so far. I'm sure there are other things I've missed, but 
reading through the documentation files it seems like a lot of it is due to 
lilypond-book operating as a separate compiler from the main TeX compiler.

Cheers,

N. Andrew Walsh
Blog: https://nandrewwalsh.substack.com
BlueSky: https://bsky.app/profile/themusicianspath.bsky.social
er/ihn/ihm/sein | he/him/his
Berlin
(neue Adresse | new address: [email protected])

On Thursday, July 30th, 2026 at 10:32, Werner LEMBERG [email protected] wrote:

>> There is, however, a LaTeX package for users of LuaLaTeX that works
>> within .tex files and seems to function seamlessly, called
>> "lyluatex." [...]
>>
>> I'd like to request that the usage manual part of the documentation
>> include this option, just so that users know that it's an option.
>> If you need something written with an explanation, I could probably
>> write something up.
>
> Yes, please contribute some text that I can then integrate into the
> manual!
>
> Werner

Reply via email to