gerard.vermeu...@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 > 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? > 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. -- Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92>
