R内核Jupyter Notebook中Plotly图表经nbconvert转HTML不渲染问题求助

一、让交互式Plotly图表正常渲染的方法 #

R版Plotly在nbconvert转换时，默认的widget输出可能无法正确嵌入所需JavaScript依赖，可通过以下方式修复：

1. 配置Plotly使用CDN加载依赖
   在代码中显式指定Plotly.js从CDN加载，确保转换后的HTML能在线获取渲染所需脚本：

library(plotly)
x = c(1,2,3,4,5)
y = c(5,6,7,8,9)
fig = plot_ly(x=x, y=y, type='scatter', mode='markers')
# 配置使用CDN资源
fig <- fig %>% config(
  plotlyServerURL = "https://cdn.plot.ly/"
)
fig

执行nbconvert命令时，建议增加超时参数避免执行中断：

jupyter nbconvert myNotebook.ipynb --to html --execute --ExecutePreprocessor.timeout=60

2. 将图表保存为独立HTML片段并嵌入Notebook
   先把Plotly图表导出为单独的HTML文件，再通过iframe嵌入Notebook，确保转换后能正常加载：

library(plotly)
library(htmlwidgets)
library(IRdisplay)

x = c(1,2,3,4,5)
y = c(5,6,7,8,9)
fig = plot_ly(x=x, y=y, type='scatter', mode='markers')

# 保存图表为独立HTML文件
saveWidget(fig, "plotly_chart.html", selfcontained = TRUE)
# 用iframe嵌入显示
display_html('<iframe src="plotly_chart.html" width="100%" height="450px" frameborder="0"></iframe>')

转换HTML时需确保plotly_chart.html与Notebook文件在同一目录下，转换后的HTML会通过iframe加载该文件。

二、替代方案：导出静态图表 #

如果不需要交互式功能，可将Plotly图表转为静态图片，确保转换后能稳定显示：

1. 使用plotly::export导出图片
   需要先安装webshot包及PhantomJS依赖：

library(plotly)
library(webshot)

# 首次运行需安装PhantomJS
# webshot::install_phantomjs()

x = c(1,2,3,4,5)
y = c(5,6,7,8,9)
fig = plot_ly(x=x, y=y, type='scatter', mode='markers')

# 导出为PNG图片
export(fig, "static_plot.png")
# 在Notebook中显示图片
IRdisplay::display_png(file = "static_plot.png")

转换后的HTML会直接嵌入或引用该静态图片，无需依赖外部脚本。

2. 转为ggplot对象后导出
   如果图表逻辑适合用ggplot实现，可将Plotly对象转为ggplot再导出，兼容性更好：

library(plotly)
library(ggplot2)
library(IRdisplay)

x = c(1,2,3,4,5)
y = c(5,6,7,8,9)
# 先创建ggplot对象
gg <- ggplot(data.frame(x,y), aes(x,y)) + geom_point()
# 转为Plotly对象（可选，若不需要交互可直接导出ggplot）
fig = ggplotly(gg)

# 导出ggplot为静态图片
ggsave("ggplot_static.png", gg)
display_png(file = "ggplot_static.png")

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