如何用 quarkdown doctor 检查安装环境的 JVM 与 PDF 浏览器是否就绪【免费下载链接】quarkdown Markdown with superpowers: from ideas to papers, presentations, websites, books, and knowledge bases.项目地址: https://gitcode.com/GitHub_Trending/qu/quarkdown装好 Quarkdown 后最常见的环境问题是JVM 是否可用、PDF 导出所依赖的 Chromium 系浏览器是否就位。Quarkdown 自带的quarkdown doctor命令组专门用来报告当前安装的环境状态其中quarkdown doctor env会一次性检查这两个外部运行时。本文适用于已经通过任意方式安装 Quarkdown、需要在正式编译尤其是--pdf导出之前确认环境就绪的读者。先明确两类安装方式下的预期不同安装渠道对浏览器依赖的处理方式不同这决定了检查后你可能需要做什么见 README 安装章节安装脚本Linux/macOS、Windows、Homebrew、Scoop 等包管理器方式文档明确说明 Package managers and install scripts already take care of this dependency所需的无头 Chrome 会随安装自动装好doctor env通常直接全绿。手动安装从 release 下载quarkdown.zip解压或用gradlew installDist构建浏览器不会自动就位需要按下文步骤自行补齐。另外Quarkdown 发行版自带一个约 50MB 的 Java 运行时CLI 开箱即可运行无需系统单独安装 Java见 CHANGELOG Bundled Java runtime 条目。运行quarkdown doctor env查看运行时状态在 shell 中执行quarkdown doctor env该命令检查两个运行时说明见 docs/cli-doctor.qdJVMCLI 当前运行所在的 JVM报告java.home路径与 JVM 版本。由于 CLI 本身就运行在 JVM 上这一项总是 found。Chrome (PDF export)PDF 导出所用的 Chromium 系浏览器。检查基于默认路径chrome-headless-shell即--chrome-path选项的默认值报告浏览器可执行文件路径与版本。每个运行时的输出包含三项信息状态徽标✓ found或✗ missing、path:安装路径、version:版本号缺失项显示为—。渲染逻辑可参考 DoctorEnvCommand.kt。浏览器缺失时如何补齐只有 Chrome (PDF export) 显示✗ missing时才需要动手。按 PDF export 文档 给出的两条路径处理方式一运行官方安装脚本手动安装者# 在 Quarkdown 安装目录包含 bin/、lib/、docs/ 的根目录下执行 scripts/install-chrome.sh # Linux/macOS scripts\install-chrome.ps1 # Windows该脚本会下载官方推荐的浏览器版本chrome-headless-shell 与 install-chrome.ps1。方式二指向已有的 Chromium 系浏览器如果你机器上已有 Chrome、Chromium 或 Edge文档说明这三者均可用不必重新下载直接把 Quarkdown 指过去编译时选项--chrome-path pathpath替换为你的浏览器可执行文件路径例如quarkdown c main.qd --pdf --chrome-path /usr/bin/chromium环境变量QD_CHROME_PATH设置浏览器可执行文件路径在未使用--chrome-path时生效。复核与真实验证补齐浏览器后重新执行quarkdown doctor env两项均显示✓ found并带出路径与版本说明环境已就绪。最后用一个真实任务验证对任意一个.qd源文件执行 PDF 编译见 docs/pdf-export.qdquarkdown c main.qd --pdf生成 PDF 文件即完成整条路径的验证。PDF 内容与 HTML 输出在 Chrome 中的渲染一致HTML 目标支持的全部文档类型与特性在 PDF 目标下同样支持。限制与相关说明沙箱问题部分 Linux 发行版不支持 headless 沙箱此时文档给出了--pdf-no-sandbox选项用于在 PDF 生成期间禁用 Chromium 沙箱。文档提醒该选项存在安全风险should only be used when strictly needed。旧选项已废弃从旧版本迁移的注意--node-path、--npm-path选项以及QD_NPM_PREFIX、NODE_PATH环境变量已不再使用浏览器状态改由quarkdown doctor env报告见 CHANGELOG 中 PDF export without Node.js 迁移说明。脚本化取路径如果你在 shell 脚本中需要定位安装目录例如手动安装者找到scripts/install-chrome.sh所在根可以用单值 getter它们每行输出一个值适合 shell 替换INSTALL$(quarkdown doctor get install-dir) ls $INSTALL/docsinstall-dir输出包含bin/、lib/、docs/的分发包根目录绝对路径。【免费下载链接】quarkdown Markdown with superpowers: from ideas to papers, presentations, websites, books, and knowledge bases.项目地址: https://gitcode.com/GitHub_Trending/qu/quarkdown创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考