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 > >
