Display imges like org-mode

[FernandoBasso]

Would it be possible to implement image display/preview like in Org-mode? For example, whenever we have some markup like this:

image:./assets/example.png[Example Image]

Then it would somehow hide the text and in place of that display the image itself?

It seems Emacs has the ability to hide characters and display some other thing instead. Org-mode does this for markers with org-hide-emphasis-markers, and also does something nice with links, etc.

So, Emacs should be able to support this. My question relates more to adoc-mode. Would it be feasible to implement this idea in this package? Would it be useful/interesting?

[ambihelical]

It's surely possible. It's not necessarily something adoc-mode needs to handle though. I'm using the excellent math-preview mode to get equations to show inline, and images are probably a bit easier. Mostly all that was required for that package was defining regex to match the block format used for inline stem and latexmath blocks (and a bug report to allow regex matching for that latter, but that's done). It would be ideal for a separate package to handle images, it can work for any markup not just asciidoc.

[ambihelical]

I did a little bit more digging. There's already such a mode in emacs, called iimage. I got it to work by defining a regex for image:: blocks and adding an image search path. It's pretty basic though, either display all images or not, and no control over positioning.

[FernandoBasso]

Will take a look. Thanks.

[TobiasZawada]

adoc-mode displays images now natively (master).

[FernandoBasso]

I am not able to preview the images, neither by issuing adoc-display-images, neither with adoc-toggle-images, and neither with “Generate preview at point” from the mouse context menu.

Basically, this is the syntax I have:

image:__assets/image.png[my image]

The image itself is readable in that directory. I tried opening emacs from the directory where my file.adoc file itself resides, and nothing I do causes the preview to show up.

If I generate the HTML or PDF, or even open the .adoc file itself on Firefox (with the asciidoctor preview extension), in all those cases, the image displays correctly. Therefore, I don't think it is a problem with the image path or something like that.

And by the way, I can open the images and seen them if I visit the image with Emacs, or on org-mode, for instance, so I don't think the problem is my Emacs build missing some feature or compilation flag.

The messages buffer shows no indication of a problem, and I see no errors whatsoever.

I'm running Emacs 29.4 from the official repos on Arch Linux. Any ideas what could be the problem or how I could debug this further?

[FernandoBasso]

Actually, I just found out that having underscores like __assets or _imgs cases the preview not to work. Renaming the directory to simply assets or imgs makes the image preview work just fine.