[ Fourth attempt to send this to emacs-orgmode ; the first three attempts were made from an account using an SMTP server seemingly blacklisted, but no error message was sent back. Apologies if this turns out to be a duplicate ]

I wish to be able to reference (i. e cross-references, lists) both some

tables or figures AND the code producing the objects.

To this effect, I added (distinct) #+caption:s to the source blocks AND

to the results, adorned with (distinct) org-ref's labels. An example is

included in the enclosed file Min-Ref.org.

The comparison of this source, the LaTeX code obtained by org-latex

export-to latex (Min-Ref.tex) and the resultant PDF (Min-Ref exported

by org-latex-export-to-pdf.pdf) show that the labels attributed to

source blocks are mislabeled as figures. Furthermore, while the org

source requests a list of figure, a list of table and a list of

listings (in that order), the list of figures appears *after* the list

of tables.

I am tempted to conclude that there is some confusion between figures

and listings. Further attempts tend to show that the problem may live n

the core org's code, rather than any specific exporter :

The ODT "native" exporter (org-odt-export-to-odt) is much less capable,

as shown in Min-Ref exported by org-odt-export-to-odt.odt.

Attempts to export via Pandoc to PDF (Min-Ref exported by org-pandoc-

export-to-latex-pdf.pdf), ODT (Min-Ref exported by org-pandoc-export-

to-odt.odt) and DOCX (Min-Ref.docx) show that these exporters may need

some specific configurations in order to be even vaguely usable.

Previous trials, using #+names: rather than org-ref's labels, gave

similar failures. If needed, I can reproduce these trials.

So I have a couple questions :

1) Is the confusion of source blocks and figures a bug, or do I miss a

subtle point ?

2) Is there some introductory material to the care and feeding of ox-

pandoc demonstrating the use of this exporter's options to enable the

addition of the needed features (figure inclusion, tables of tables /

figures / listings, etc...) ? The "manual" available as a README is way

too terse to be usable without diving in the source code and pandoc's

documentation.

Sincerely,

Emmanuel Charpentier