zynaddsubfx / user-manual

User manual (this may or may not get merged into zynaddsubfx/zynaddsubfx's doc dir)
30 stars 10 forks source link

Using Asciidoc callouts for screenshots? #8

Open unfa opened 6 years ago

unfa commented 6 years ago

I've found a feature called callouts:

https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#source-code

image

I wonder if we could use this for screenshots? I guess we could reskin it with a custom CSS file to suit our look later. This could make annotating screenshots much easier and less destructive.

fundamental commented 6 years ago

Perhaps?

I'm not sure if there would be any problem with using them with images or not.

unfa commented 6 years ago

I think they would be great as they would provide uniform and skinnable way of annotating different parts of a screenshot, however I have no idea how to place these callouts on an image within an document.

MathieuR-Iolas commented 1 year ago

Looking for a way to reuse screenshots with differents highlithings, I found your post. And this link to an aspect of SVG that could be usefull : Other content in SVG

I'm still testing it in real use cases (using Inkscape), but 'wrapping' a screenshot into an SVG file, that can be rendered by asciidoctor could be a kind of workarround to this problematic (no image edit, just add elements in svg, one screenshot can be used multiple times in differents svg files).