Hi Jakub, as I was going through trying to think how to add information about lyluatex, I realized you're correct. It's really more of a parallel toolchain than a different starting option, so if there could be a separate section, I agree that that would be preferable.
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 18:21, Jakub Pavlík <[email protected]> wrote: > Hi, > please don't mix lyluatex usage instructions with lilypond-book > documentation, regardless possible similarities between the two. It would be > only confusing for the reader. lyluatex may deserve a brief "See also" > mention in the introduction to lilypond-book, but any details should go to > https://lilypond.org/doc/v2.24/Documentation/usage/luatex > > Regards, > Jakub > > čt 30. 7. 2026 v 11:19 odesílatel N. Andrew Walsh <[email protected]> > napsal: > >> 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
