visual-studio-codeasciidoc

AsciiDoc: Stock images for admonitions?


I'm running AsciiDoc off the Visual Studio Code support extension, and I'm trying to get admonitions with an icon, as in the examples and documentation.

Just adding :icons: to the document header looks to be not enough, as in my working directory I have no images related. I'm not trying the :icons:font, as I read that it can have issues depending on the output format, so I just stick with plain simple images (PNG or even better SVG).

Shall I manually copy some example files from the extension directory? Is there any helper function for it?

I just feel like some working examples, with usable files, would be an additional help for first-time users.


Solution

  • I was directed to use :icons: font and everything worked as desired. I obtained some nice icons, without any other settings, and it resulted in compatibility both with HTML and PDF conversion.

    Note that I was at first reluctant to use the font mode, as the documentation warns about possible compatibility issues. Although, I found none of them! :D