asciidoctor-intellij-plugin icon indicating copy to clipboard operation
asciidoctor-intellij-plugin copied to clipboard

Published 20 hours ago • verified publisher icon asciidoctor

Improve usability for save-image-in-preview

Open ahus1 opened this issue 6 years ago • 4 comments
trafficstars

The plugin has the option to save-image-from-preview using right click (works at least on Windows OS) starting from version 0.28.5. It's been implemented for issue #245

This feature is difficult to discover for users: they will find it out by accident, although it is a common "gesture" on Windows OS.

The user should find this feature more easily. Other plugins like PlantUML offer a intermediate context menu with different options including copy to clipboard and open in external editor.

[plantuml,plantuml-seq,svg]
----
Foo -> Bar
----

ahus1 avatar Jun 26 '19 19:06 ahus1

Possible idea (brainstorming):

  1. icon in menu bar.
  2. when the user hovers with his or her mouse over the image, am icon could appear
  3. ...

(please comment with more ideas)

ad 1 / icon in menu bar: as a first step the user would probably need to select the image she/he wants to save from a list ad 2 / icon on hover: icon could appear next to the image that the user can click (maybe a save icon like a floppy disk?), or on top of the image?

ahus1 avatar Jun 26 '19 19:06 ahus1

I prefer 2 (github needs a poll feature 😞 ). It could define a common semantic for other features and it tells the user that there are features available without relying on a user action or OS specific idioms. For example, same hover could appear on code blocks with a button to copy code blocks content to clipboard.

Consideration: I think user should be able to disable this for 2 reasons (at least)

  1. Offer a clean preview without artifacts
  2. Diagnose/avoid issues with user defined asciidoctor extensions Where to put that option? top bar of preview pane?

abelsromero avatar Jun 26 '19 21:06 abelsromero

I would like to see a real context menu when right-clicking, like the plantuml plugin has. We could have explicit options to save as PNG or as SVG in the menu before the save dialog is shown. This would be especially helpful on macOS where you can't choose the file type like in the Windows save dialog.

The right-click is common enough I think that users will find it. We can also write a users guide (in Asciidoc of course :-) ) where we explain how to use the plugin? I am willing to help write it if we know how to host it.

wimdeblauwe avatar Jun 28 '19 06:06 wimdeblauwe

@wimdeblauwe - the one thing closest to a user guide there is currently is the features list: https://github.com/asciidoctor/asciidoctor-intellij-plugin/blob/master/FEATURES.adoc

ahus1 avatar Jun 28 '19 06:06 ahus1