AsciidocFX 跨平台部署完整指南Windows、Mac 与 Linux 一步步安装配置【免费下载链接】AsciidocFXAsciidoc Editor and Toolchain written with JavaFX 21 (Build PDF, Epub, Mobi and HTML books, documents and slides)项目地址: https://gitcode.com/gh_mirrors/as/AsciidocFXAsciidocFX 是一款基于 JavaFX 的所见即所得WYSIWYGAsciidoc 编辑器可以帮你把 Asciidoc 标记语言写成 PDF、Epub、Mobi 和 HTML 格式的书籍、文档与演示文稿并且一次安装即可在 Windows、macOS、Linux 三平台使用。本文按清单核对 → 快速上手 → 分平台部署 → 验证配置 → 排错的顺序带零基础新手一步步完成部署。 项目速览AsciidocFX 能为你做什么简单说Asciidoc 是一种用纯文本写文档的标记语言而 AsciidocFX 让写作体验接近 Word左侧编辑、右侧实时预览。它还是 2015 年 Dukes Choice Award 的获奖项目核心亮点如下能力类别具体内容实时预览编辑 Asciidoc 内容时右侧预览窗口同步刷新渲染结果输出格式一键导出 PDF、HTML、Epub、Mobi、Docbook跨平台官方提供 Windows、Mac含 M1/M2、Linux 的独立安装包扩展能力PlantUML、Mermaid、ditaa 图表MathJax 公式JavaFX 图表演示文稿内置 Reveal.js 与 Deck.js 转换器可直接做幻灯片编辑体验基于 Ace.js 编辑器支持主题切换、文件历史、Epub 阅读器 部署前置清单系统要求与依赖快速核对动手安装前先对照下面清单确认环境缺什么补什么操作系统Windows 10/11、macOSIntel 与 Apple Silicon 芯片均可、主流 Linux 发行版Debian/Ubuntu、Fedora/RHEL 系列内存至少 2GB推荐 4GB 以上预览大文档更流畅磁盘空间预留至少 200MB不含你的文档与导出文件Java 环境官方安装包已内置 JRE一般无需手动装 Java若使用不含运行时的精简包则需自行安装 JDK/JREMicrosoft Core FontsLinux 必备否则 Linux 下 PDF 导出会出现乱码Graphviz可选PlantUML 生成部分 UML 图时需要安装后还需配置GRAPHVIZ_DOT环境变量KindleGen可选需要导出 Mobi 电子书时安装并在软件中指定可执行文件路径mermaid-cli可选使用 Mermaid 流程图扩展时需通过 npm 安装 快速上手路线最快跑通 AsciidocFX 的一条路想最短时间用起来直接下载你所在平台的官方安装包双击安装即可——安装程序内置 JRE不需要额外配置这是最省事的一条路平台推荐安装包一句话点评WindowsAsciidocFX_Windows.exe带向导的安装程序最省心macOSAsciidocFX_Mac.dmg或AsciidocFX_Mac_M1.dmg按芯片选择拖拽即装LinuxAsciidocFX_Linux_Deb.deb/AsciidocFX_Linux_Rpm.rpm用发行版包管理器卸载干净跑通后的验证方法见下文安装成功与否的验证技巧一节。如果你想要更多选择比如绿色解压版、Homebrew、tar.gz请看下面的分平台详解。 多平台详细部署按需选择安装方式Windows 系统一键安装步骤方法一使用安装程序推荐下载AsciidocFX_Windows.exe安装包双击运行按向导提示一路下一步即可安装完成后从开始菜单或桌面快捷方式启动 AsciidocFX适合首次安装、希望自动创建快捷方式和文件关联的用户缺点是安装位置由向导控制。方法二使用 ZIP 绿色版下载AsciidocFX_Windows.zip右键解压到目标文件夹例如C:\Program Files\AsciidocFX进入解压后的bin目录双击AsciidocFX.bat启动适合想解压即用、免安装直接拷贝到其他机器的场景缺点是需手动管理快捷方式。 macOS 系统安装步骤DMG 与 Homebrew方法一使用 DMG 镜像根据芯片类型选择安装包Intel 芯片用AsciidocFX_Mac.dmgApple SiliconM1/M2用AsciidocFX_Mac_M1.dmg双击 DMG 文件挂载镜像将 AsciidocFX 拖入 Applications 文件夹从启动台或应用程序文件夹启动适合喜欢传统安装方式、想保留安装包的用户缺点是需手动确认芯片类型。方法二使用 Homebrew推荐如果已安装 Homebrew一条命令即可完成brew install --cask asciidocfx之后在终端输入asciidocfx即可启动或从应用程序文件夹找到。适合命令行用户升级也方便缺点是需要先装好 Homebrew。 Linux 系统安装步骤Deb / Rpm / tar.gz方法一使用 tar.gz 通用压缩包tar -xvzf AsciidocFX_Linux.tar.gz cd AsciidocFX/bin chmod x ./AsciidocFX ./AsciidocFX依次完成解压、进入bin目录、赋予执行权限、启动程序。适合所有发行版无需 root 权限缺点是每次启动要进bin目录执行。方法二使用 DEB 包Debian/Ubuntu 系列sudo dpkg -i AsciidocFX_Linux_Deb.deb若提示缺少依赖再执行修复sudo apt-get install -f适合 Debian/Ubuntu 用户可被系统包管理器统一管理缺点是仅限 DEB 系发行版。方法三使用 RPM 包Fedora/RHEL 系列sudo rpm -ivh AsciidocFX_Linux_Rpm.rpm适合 Fedora/RHEL 系列用户安装后可正常注册到应用菜单缺点是仅限 RPM 系发行版。 进阶从源码构建运行如果你是开发者想自己编译最新代码可以这样操作git clone https://gitcode.com/gh_mirrors/as/AsciidocFX cd AsciidocFX mvn clean install构建完成后在target/appassembler/bin目录下会生成asciidocfx.shLinux/macOS与asciidocfx.batWindows直接执行即可启动。注意此方式需要先安装 JDK 与 Apache Maven 并配置环境变量。⚙️ 部署后配置与验证技巧按需补充的依赖配置Linux 安装 Microsoft Core FontsPDF 输出正常的前提# Ubuntu/Debian sudo apt-get install ttf-mscorefonts-installer # Fedora 需要安装 mscorefonts2 的 RPM 包安装 Graphviz 并配置环境变量PlantUML 使用sudo apt-get install graphviz # Ubuntu/Debian sudo dnf install graphviz # Fedora安装后把GRAPHVIZ_DOT环境变量指向 Graphviz 的dot可执行文件例如export GRAPHVIZ_DOT/usr/bin/dot。安装 mermaid-cliMermaid 流程图使用npm install mermaid-js/mermaid-cli安装 KindleGenMobi 导出使用下载 KindleGen 后在 AsciidocFX 设置中指定其可执行文件位置Mobi 导出服务即会启用。安装成功与否的验证技巧启动后能看到四个区域左侧文件浏览器、中央编辑器、右侧实时预览、顶部工具栏点击菜单File New新建一个 Document输入任意 Asciidoc 内容右侧应立即出现渲染效果点击顶部工具栏导出 HTML 或 PDF能成功生成文件即代表工具链正常按CtrlF4打开设置页说明配置系统可用所有配置文件位于安装目录的conf文件夹下 典型使用场景从文档到演示文稿场景一三分钟创建 Reveal.js 演示文稿点击菜单New Slide选择保存位置后编辑器中已生成幻灯片模板按如下格式编写内容 Slide Title include::_settings_reveal.adoc[] Slide 1 [quote,Rumi] Patience is the key to joy. Slide 2 Slide 2 Content右侧即可实时预览演示效果AsciidocFX 会通过 Asciidoctor Reveal.js 后端自动渲染且可在 Reveal.js 与 Deck.js 之间切换修改include行并编辑对应_settings_reveal.adoc或_settings_deck.adoc即可。场景二文档中直接插入图表与文件树AsciidocFX 支持用纯文本生成 JavaFX 图表例如面积图[chart,area,targetarea-chart] -- //April 1, 4 3, 10 6, 15 9, 8 12, 5 --文件树扩展则能把你拖拽进编辑器的文件夹结构可视化展示非常适合在技术文档里画项目结构。除图表外PlantUML、ditaa、MathJax 公式等扩展的写法均可参考仓库README.adoc中的示例。❗ 高频问题排查问题 1Linux 下 PDF 输出所有文字变成####原因系统缺少 Microsoft Core FontsPDF 渲染找不到可用字体。 解决安装核心字体后重启软件并重新导出sudo apt-get install ttf-mscorefonts-installer问题 2macOS 非 QWERTY 键盘布局下快捷键错乱原因JavaFX 存在已知 Bug会让所有键盘按 QWERTY 布局处理例如德语 QWERTZ 布局下撤销/重做快捷键互换。 解决这是软件层已知问题可在Settings Shortcut中自定义快捷键规避。问题 3文本出现彩虹色条纹或模糊原因字体渲染设置与系统不兼容导致显示伪影。 解决打开安装目录下的AsciidocFX.vmoptions添加以下两行后保存重启-Dprism.textt2k -Dprism.lcdtextfalse问题 4PlantUML 图无法生成原因部分 UML 图需要 Graphviz 参与布局。 解决按上文安装 Graphviz并确认GRAPHVIZ_DOT环境变量已指向dot可执行文件。 结语与延伸到这里你已经完成了 AsciidocFX 的部署、配置与验证可以开始用它写书、写文档、做幻灯片了。想深入了解每个扩展的写法可在仓库中查阅README.adoc与CHANGELOG.md遇到问题也欢迎在项目仓库的 Issues 区或社区讨论组寻求帮助祝你写作愉快。【免费下载链接】AsciidocFXAsciidoc Editor and Toolchain written with JavaFX 21 (Build PDF, Epub, Mobi and HTML books, documents and slides)项目地址: https://gitcode.com/gh_mirrors/as/AsciidocFX创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考