如何为AsciiDoc警示块(admonitions)获取图标图片?
AsciiDoc扩展警示块图标配置方案
要实现PNG/SVG格式的警示块图标,确实需要手动复制图标文件:VS Code的AsciiDoc扩展自带的图标文件,一般存放在扩展安装目录的
resources/icons路径下(Windows路径示例:%USERPROFILE%\.vscode\extensions\asciidoctor.asciidoctor-vscode-x.x.x\resources\icons;macOS路径示例:~/.vscode/extensions/asciidoctor.asciidoctor-vscode-x.x.x/resources/icons)。你需要将这些图标文件复制到文档工作目录下的images/icons文件夹(需自行创建该路径)。目前该扩展没有内置的一键复制辅助功能,只能手动完成文件迁移。
复制完成后,在AsciiDoc文档头部添加配置:
:icons: image # 如果你的图标路径不是默认的images/icons,需额外指定 :icon-path: ./custom-icons/这样就能正常渲染带普通图片图标的警示块了。
你提出的「带可用文件的示例对新手更友好」的观点很合理,这类预设示例能大幅降低新手的入门成本,不过当前版本的扩展暂未提供该功能,你可以考虑向扩展开发者反馈这个需求。
内容的提问来源于stack exchange,提问作者LuC
相关产品推荐
相关产品推荐

