Re: Doc request: TeX integration with lyLuaTeX

--000000000000c131e70657d6756d
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

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

=C4=8Dt 30. 7. 2026 v 11:19 odes=C3=ADlatel N. Andrew Walsh <n.andrew.walsh=
@proton.me>
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=E2=80=A6
>
> 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 usin=
g
> lyluatex), then in a terminal run the following commands for lilypond-boo=
k,
> or compile as you would normally if using lyluatex.
>
> 3.2.1
>
> lilypond-book and lyluatex both provide the following commands=E2=80=A6
>
> 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 direct=
ly
> from whatever editor you use for .tex files. See the lyluatex documentati=
on
> 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
>
>

--000000000000c131e70657d6756d
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr">Hi,<div>please don&#39;t mix lyluatex usage instructions w=
ith lilypond-book documentation, regardless possible similarities between t=
he two. It would be only confusing for the reader. lyluatex may deserve a b=
rief &quot;See also&quot; mention in the introduction to lilypond-book, but=
 any details should go to=C2=A0<span style=3D"background-color:transparent"=
><a href=3D"https://lilypond.org/doc/v2.24/Documentation/usage/luatex">http=
s://lilypond.org/doc/v2.24/Documentation/usage/luatex</a></span></div><div>=
<br></div><div>Regards,</div><div>Jakub</div></div><br><div class=3D"gmail_=
quote gmail_quote_container"><div dir=3D"ltr" class=3D"gmail_attr">=C4=8Dt =
30. 7. 2026 v=C2=A011:19 odes=C3=ADlatel N. Andrew Walsh &lt;<a href=3D"mai=
lto:[email protected]">[email protected]</a>&gt; napsal:<br><=
/div><blockquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;bo=
rder-left:1px solid rgb(204,204,204);padding-left:1ex"><div style=3D"font-f=
amily:Arial,sans-serif;font-size:14px"><p>Hi Werner,<br>
<br>
Here are some brief fragments that can be added to the documentation. I&#39=
;m going to send it as html-formatted text to enable linking. These are all=
 additions to the text already in place; I&#39;ll leave it to you to decide=
 where it should go in each section.</p><p>3 Running lilypond-book</p><p>Ho=
wever, users of LaTeX-based systems who compile their documents with LuaLaT=
eX have the option of using the <a href=3D"https://ctan.org/pkg/lyluatex" t=
itle=3D"lyLuaTex" target=3D"_blank">lyLuaTex</a> package, which offers seam=
less integration into preexisting TeX-based systems without having to compi=
le the document separately through lilypond-book.</p><p>3.1 An example=E2=
=80=A6</p><p>Users of lyLuaTex will need to add &quot;\usepackage{lyluatex}=
&quot; between the \documentclass and \begin{document} lines.</p><p>Input</=
p><p>(show the document content with the \usepackage{lyluatex} statement as=
 described)</p><p>Processing</p><p>Save the code above to a file called lil=
ybook.lytex (lilybook.tex if using lyluatex), then in a terminal run the fo=
llowing commands for lilypond-book, or compile as you would normally if usi=
ng lyluatex.=C2=A0</p><p>3.2.1</p><p>lilypond-book and lyluatex both provid=
e the following commands=E2=80=A6</p><p>3.3</p><p>(I&#39;m unsure whether l=
yluatex has all these same commands/options)</p><p>3.4.1 Invoking lyluatex<=
/p><p>lyluatex requires the shell-escape option to be added to the lualatex=
 command when compiling your document, but can otherwise be invoked directl=
y from whatever editor you use for .tex files. See the lyluatex documentati=
on for more options.</p><p>-----------</p><p>That&#39;s what I have so far.=
 I&#39;m sure there are other things I&#39;ve missed, but reading through t=
he documentation files it seems like a lot of it is due to lilypond-book op=
erating as a separate compiler from the main TeX compiler.=C2=A0</p><p><br>=
</p><p>Cheers,<br>
<br>

</p><div style=3D"font-family:Arial,sans-serif;font-size:14px">
    <div>
        <div style=3D"font-family:Arial,sans-serif;font-size:14px;color:rgb=
(0,0,0)">N. Andrew Walsh</div><div style=3D"font-family:Arial,sans-serif;fo=
nt-size:14px;color:rgb(0,0,0)">Blog:=C2=A0<span><a rel=3D"noreferrer nofoll=
ow noopener" href=3D"https://nandrewwalsh.substack.com" target=3D"_blank">h=
ttps://nandrewwalsh.substack.com</a></span></div><div style=3D"font-family:=
Arial,sans-serif;font-size:14px;color:rgb(0,0,0)">BlueSky:=C2=A0<span><a re=
l=3D"noreferrer nofollow noopener" href=3D"https://bsky.app/profile/themusi=
cianspath.bsky.social" target=3D"_blank">https://bsky.app/profile/themusici=
anspath.bsky.social</a></span></div><div style=3D"font-family:Arial,sans-se=
rif;font-size:14px;color:rgb(0,0,0)"><span>er/ihn/ihm/sein | he/him/his</sp=
an><br><span>Berlin</span><br></div><div style=3D"font-family:Arial,sans-se=
rif;font-size:14px;color:rgb(0,0,0)"><span>(neue Adresse | new address: <a =
href=3D"mailto:[email protected]" target=3D"_blank">n.andrew.walsh@p=
roton.me</a>)</span></div>
    </div>
   =20
            <div>
       =20
            </div>
</div>
<br>
<br>
On Thursday, July 30th, 2026 at 10:32, Werner LEMBERG <a href=3D"mailto:wl@=
gnu.org" target=3D"_blank">[email protected]</a> wrote:<p></p>
<p></p>
<blockquote>
<blockquote>
<p>There is, however, a LaTeX package for users of LuaLaTeX that works<br>
within .tex files and seems to function seamlessly, called<br>
&quot;lyluatex.&quot;  [...]</p>
<p>I&#39;d like to request that the usage manual part of the documentation<=
br>
include this option, just so that users know that it&#39;s an option.<br>
If you need something written with an explanation, I could probably<br>
write something up.</p>
</blockquote>
<p>Yes, please contribute some text that I can then integrate into the<br>
manual!</p>
<p>Werner</p>
</blockquote></div></blockquote></div>

--000000000000c131e70657d6756d--