如何在Quarto网站中创建含Shiny交互功能的.qmd文档？

针对你遇到的Prerendered HTML file not found报错，以下是搭建带Shiny交互的Quarto网站必须的配置环节，也是你可能遗漏的步骤：

1. 配置网站启用Shiny支持 #

在网站根目录的_quarto.yml文件中，添加server配置项，明确告知Quarto当前网站包含需要动态运行的Shiny组件：

website:
  title: "你的网站标题"
  # 保留原有配置（如navigation、format等）
  server:
    type: shiny

2. 正确配置Shiny文档的页面路由 #

确保mini-app.qmd被正确添加到网站导航中（可在_quarto.yml的navigation节点，或单独的_navigation.yml文件里），直接链接.qmd文件而非生成的.html：

website:
  navigation:
    - text: "迷你交互应用"
      href: mini-app.qmd

Shiny页面依赖动态渲染，直接访问静态HTML文件会丢失交互能力，必须通过Quarto的Shiny服务器路由到原.qmd文件。

3. 使用正确的命令启动网站 #

不要用quarto render生成静态文件后直接打开，必须使用以下命令启动带Shiny支持的本地服务器：

quarto serve

quarto render仅生成静态内容，无法运行Shiny的后端逻辑；quarto serve会启动Shiny服务器，实时处理交互页面的渲染和运行请求。

4. 确认Shiny文档的YAML头配置 #

检查mini-app.qmd的开头YAML块，确保包含server: shiny声明（单独运行时可能自动识别，但加入网站后需要明确指定）：

---
title: "迷你Shiny应用"
format: html
server: shiny
---

这个声明会标记该文档需要Shiny服务器支持，确保Quarto在处理网站时为其分配对应的运行环境。

5. 排查路径与命名问题 #

• 确保mini-app.qmd的文件名无特殊字符（如中文、空格），避免路径解析错误；
• 运行quarto serve时，确保当前工作目录是网站根目录（即mysite文件夹内），避免路径查找失败。

内容的提问来源于stack exchange，提问作者kabr