Re: [BUG] ox-latex produces broken references to src code listings without caption (was: [BUG] org-lint tells to move #+name to wrong place in results block)

[gerard . vermeulen]

On 25.01.2024 13:41, Ihor Radchenko wrote:
> gerard.vermeulen@posteo.net writes:
>
> > I have found that CAPTION keywords  in the "name-result-example" in 
> > the
> > manual are essential to produce correct links.
>
> It should not be essential. What you demonstrated is two bugs in Org 
> mode.
>
> > In case the relevant blocks have e.g. ":exports both", Org handles
> > this, but:
> > 1. HTML export requires captions to produce links with unequivocal
> >     "link texts" which are numbers in the HTML output.
>
> Fixed, on main.
> https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=ea529007d

I confirm that it is fixed.

> > 2. LaTeX export requires captions to produce captions with labels like
> >     =\caption{\label{path}desc}=.
>
> `org-latex-link' assumes that it is safe to use
> \ref{<org-latex--label ...>} in order to refer to an existing src 
> block.
> However, it is not true.
>
> `org-latex-src-block--engraved', `org-latex-src-block--minted',
> and `org-latex-src-block--listings' only produce a label when src block
> has a caption.
>
> We should generally not need to put a caption in order to refer to a
> source block listing. At least, it does not look like we need it from
> https://tex.stackexchange.com/questions/438260/referencing-without-captions-appearing-but-keeping-numbering
>
> Thoughts? Ideas?

I do not see how to put the LaTeX hypertarget inside listings where it 
is
needed, because those listings are not floating.

I looked at `org-latex-src-block--verbatim' that uses the LaTeX
captionof macro, by exporting
--- begin narrow lines below ---
#+caption: caption or comment
#+name: name
#+begin_src emacs-lisp
(+ 1 2)
#+end_src

Link \ref{name}.
--- end narrow lines above

But, I cannot get the captionof macro working after:
exporting the snippet above using `org-latex-src-block--listings'
without caption and adding the captionof macro by hand
(LuaLaTeX does not compile).

> > Tested on example below:
> > Produced by listing [[IN]].
> >
> > #+name: OUT
> > #+RESULTS: IN
> > #+begin_src emacs-lisp :exports code
> > 6
> > #+end_src
> >
> > #+header: :wrap "src emacs-lisp :exports code"
> > #+name: IN
> > #+begin_src emacs-lisp :exports both
> > 6
> > #+end_src
> >
> > Listing [[IN]] produces listing [[OUT]].
> >
> >  From inspecting HTML or LaTeX output using this example
> > for the difference between with and without captions it is
> > easy to see that only with captions the output is correct.

Regards -- Gerard