Asciidoctor Atom AsciiDoc 预览插件常见问题解决方案

Asciidoctor Atom AsciiDoc 预览插件常见问题解决方案

atom-asciidoc-preview ⚛ AsciiDoc preview for the Atom editor. 项目地址: https://gitcode.com/gh_mirrors/at/atom-asciidoc-preview

Asciidoctor的Atom AsciiDoc预览插件是一个专为Atom编辑器设计的工具，旨在提供AsciiDoc文档的实时预览功能。此项目采用JavaScript为主要编程语言，利用Asciidoctor.js库实现在编辑器内部渲染AsciiDoc内容为HTML。

新手使用注意事项及解决步骤

1. 配置环境以支持Markdown文件预览

问题描述: 初次使用者可能会发现该插件默认不支持.md（Markdown）文件预览，尽管它主要面向AsciiDoc格式。

解决步骤:

• 确保您的文档扩展名为.adoc或其他受支持的AsciiDoc扩展名。
• 如果您确实需要在Atom中预览Markdown，考虑安装专门针对Markdown的预览插件，如markdown-preview。

2. 活动生成预览与自动保存设置

问题描述: 用户可能遇到预览不更新或需手动触发更新的情况。

解决步骤:

• 在插件设置中，检查“Live Preview”选项是否已启用，以便预览随源码即时刷新。
• 若希望控制预览更新时间，可选择“preview on save”，这样每次保存文档时才会更新预览。

3. PDF导出失败的问题

问题描述: 尝试导出文档为PDF时，可能会因为系统找不到asciidoctor-pdf命令而失败。

解决步骤:

• 确保全局安装了asciidoctor-pdf。可以通过命令行运行gem install asciidoctor-pdf来安装。
• 添加Asciidoctor-PDF到系统的PATH环境变量，确保Atom可以找到该命令进行执行。
• 检查插件设置中PDF导出的相关配置，确认设置正确无误。

通过遵循以上解决步骤，初学者能够更顺利地使用Asciidoctor的Atom AsciiDoc预览插件，享受高效的文档编写与预览体验。记住，对于更细致的定制需求，深入探索插件的官方文档总是最佳实践。

atom-asciidoc-preview ⚛ AsciiDoc preview for the Atom editor. 项目地址: https://gitcode.com/gh_mirrors/at/atom-asciidoc-preview