如何在DokuWiki中嵌入Jupyter Notebook并实现运行？

本地嵌入预览（无外部依赖） #

• 先把Jupyter Notebook导出成HTML格式：在Notebook里点「文件」→「下载为」→「HTML」
• 把导出的HTML文件放到DokuWiki的media目录下，然后在页面里用iframe嵌入：

  {{html}}
  <iframe src="media:your_notebook.html" width="100%" height="800" frameborder="0"></iframe>
  {{/html}}
  

• 提前确认DokuWiki允许HTML嵌入：在conf/local.php里加一行$conf['htmlok'] = 1;

结合GitHub仓库的动态方案 #

• 把.ipynb文件和相关数据上传到GitHub仓库
• 要是想在DokuWiki里渲染内容，自己写个简单的DokuWiki插件：解析GitHub上.ipynb的JSON结构，把代码块和文本提取出来，转换成DokuWiki支持的格式显示
• 要实现直接运行的话，插件里可以加个代码执行模块：把用户输入的代码传到本地或远程的Jupyter Kernel，拿到结果后返回页面显示

静态渲染+运行入口 #

• 用nbconvert把Notebook转成Markdown：

  jupyter nbconvert --to markdown your_notebook.ipynb
  

• 把转换后的Markdown直接粘到DokuWiki页面里，再加个提示：

  要运行这个Notebook的话，去仓库里拿原始文件，本地用Jupyter打开，或者用GitHub Codespaces在线启动

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