如何将 Jupyter Notebook 转换为适用的 Wordpress HTML

How to Convert Jupyter Notebook to Wordpress suitable HTML

这周我制作了一个 Jupyter notebook,非常适合 post 我的博客。我已经发现您可以将此笔记本导出为简化的 HTML 格式,该格式可以使用以下命令嵌入到网页中:

jupyter nbconvert mynotebook.ipynb --to html --template basic

但是,我想改变一些简单的东西。例如:现在每个标题都以 "end of line character" 结尾,并且输入和输出之间没有明显的区别。

在 Jupyter 的 NBConvert 文档页面上,我找不到任何关于更改模板的信息 (https://ipython.org/ipython-doc/3/notebook/nbconvert.html)。他们只说

"IPython provides a few templates for some output formats, and these can be specified via an additional --template argument."

是否可以指定自己的模板?在哪里可以找到我要调整的 "basic" 模板?

您必须在 wordpress 中安装以下插件:"oEmbed Gist"

然后只需完成这些步骤:

1/将您的笔记本粘贴到 github 的要点中(不要忘记添加 .ipynb 扩展名)。

2/只需将 link 粘贴到您的要点,wordpress 就会为您正确完成所有工作

只有您是 wordpress 的高级会员才能安装 oEmbed Gist 插件。但是,插入

[gist linkToYouGist]

进入 wordpress post,将完成工作!

我制作了一个笔记本 Wordpress 插件,适用于托管笔记本的任何 URL!我很快会将其公开添加到 Wordpress。

https://www.andrewchallis.co.uk/portfolio/php-nbconvert-a-wordpress-plugin-for-jupyter-notebooks/

除了名为 nbconvert

外,它的使用方式与 gist 插件相同

[nbconvert url=“Www.example.co.uk/path/to/some/notebook.ipynb”

您还可以使用 nbconvert – 用于 Jupyter 笔记本的 wordpress 插件。关注这个详细的博客 (https://www.andrewchallis.co.uk/portfolio/php-nbconvert-a-wordpress-plugin-for-jupyter-notebooks/ ),其中作者解释了要遵循的步骤、优缺点。

对于那些希望将 HTML 加载到 Wordpress(而不是通过 Gist 嵌入它)的人,您可以使用 nb2wp 工具将笔记本转换为普通 HTML不需要插件、CSS 和任何脚本。将提取图像并将 Latex 指令转换为 WP latex 指令。

该实用程序的作用如下:

  • 使用所选模板(完整、基本或自定义)使用 nbconvert 将 .ipynb 转换为 HTML
  • 使用 pynliner 将 CSS 转换为内联样式,以便 Wordpress 支持该样式。默认情况下,它将 nbconvert 给出的 CSS 替换为可以由 pynliner 内联的自定义和更简单的 style.css。
  • 提取内嵌图片(比如Matplotlib生成的图片)和本地图片到img目录。您需要将此 img 目录上传到某处并为图像提供 URL 前缀。
  • 将 Latex 指令转换为 Wordpress.com Latex 指令。

然后你需要做一些手工工作:

  • 将 HTML 复制粘贴到 Wordpress HTML 编辑器中
  • 上传图片目录。

这远非理想,结果也不是很好,但我想这是一个开始和替代方案。 (免责声明:我是作者)