Re: [BUG] WORG example for ob-lilypond is no longer working as described (was: Moving some lisp/ob-*.el files to org-contrib - your advice?)

[Jonathan Gregory]

On 27 Jul 2023, Ihor Radchenko wrote:

> Jonathan Gregory <jgrg@autistici.org> writes:
>
> > > Ok. That fix has been already installed. 
> > > https://git.sr.ht/~bzg/worg/commit/6f69d212f41bc372426dc9b4df286638fe8f2a92
> >
> > To the extent of the lilypond.org file, yes, but only if the 
> > output is a PDF. My suggestion is to revert that commit and 
> > incorporate the changes into ob-lilypond.
>
> Then, may you elaborate what purpose the changes are going to 
> serve? Automatic page sizing? Automatic page settings?

Bug fix.

> > The purpose of the patch was to fix the problem described in 
> > https://masto.ai/@rfc1149/110674961710491363. I wasn't trying 
> > to introduce anything new.
>
> If we want to add boilerplate code to ob-lilypond, it does sound 
> like introducing something new. Again, I feel confused. Please, 
> explain in more details what you want to archive in terms of 
> functionality.

No, the patch is a bug fix. There are no changes for the user. 
Prior to the bug, we were able generate a "cropped" image when 
running:

#+begin_src lilypond :file myfile.pdf
\version "2.20"
\paper { tagline="" }
{
 c' e' g' e'
}
#+end_src

This is no longer the case, hence the patch.

> > No, the ob-lilypond patch is needed. It allows users to 
> > generate music fragments (as opposed to a full page) in basic 
> > mode using pdf, eps, and png.
>
> May your please explain what is "basic mode".

Basic mode is explained in 
https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-lilypond.html. 
In summary:

With basic-mode you can embed LilyPond snippets into an Org-mode 
file, compile and export them using typical Org-mode commands 
(such as C-c C-e l p for PDF export). This is useful if you want 
to mix blocks of LilyPond-generated score with text, and perhaps 
other images to export to LaTeX, Docbook, PDF, or HTML.

> And what about users who do want a full page?

In that case the user would use "arrange mode", which is also 
explained in the ob-doc-lilypond.html page. Try running the source 
block example above with arrange-mode enabled using M-x 
org-babel-lilypond-toggle-arrange-mode. To quote from that page:

With arrange-mode you can develop complete pieces of score whilst 
organizing sections of the piece using typical literate 
programming techniques. This allows you to assemble scores 
programatically by using tables to store information among other 
methods.

> Noweb and babel references are not allowed in header args. And 
> ob-emacs-lisp also does not support :prologue.

I see, so there's no built-in way to auto-insert a boilerplate 
without using the <<>> reference *inside* source blocks. Anyway, 
let's not worry about this for now.


--
Jonathan