nbviewer 是一个 Web 应用程序,允许你输入 Jupyter Notebook 文件的 URL,将该 Notebook 呈现为静态 HTML Web 页面,并提供一个稳定的链接,你可以与他人共享。nbviewer 也支持浏览 Notebook 集合(例如在 GitHub 存储库中)和呈现其他格式的 Notebook(例如幻灯片、脚本)。
nbviewer 是 Jupyter 项目的一部分,是一个开源项目,包括其他项目,如 Jupyter Notebook、JupyterLab 和 JupyterHub。
本站即是基于 nbviewer 进行构建的。
你可以使用它来呈现 Jupyter Notebook 或浏览 GitHub 上的 Notebook 集合。相比于 nbviewer.org 主站,我们替换了国内访问不畅的链接,如 cloudflare、unpkg 等资源,由于笔记本格式的开放,部分在笔记本中展现的图片引用的站外资源我们无法保证它们能够正常呈现。
nbviewer 是用 Python 和 JavaScript 编写的,使用 nbconvert 呈现 Notebook,并使用 Tornado 作为其 Web 服务器。
你可以 安装 nbconvert 并运行 jupyter nbconvert
来获得相同的功能(以及更多功能)。请参见 nbconvert 文档 获取详细信息。
nbviewer 不执行 Notebook。它只将保存在 Notebook 文档中的输入和输出呈现为 Web 页面。
mybinder.org 是一个单独的 Web 服务,可以让你在可执行环境中打开 Notebook,使你的代码能够立即被任何人在任何地方复制。nbviewer 在其导航栏中显示一个 在 Binder 上执行 图标,其中
nbviewer 仅支持在 GitHub 或作为 Binder 上的 Gist 存储的 Notebook。Binder 可以在 mybinder.org 网站上直接支持其他提供程序。
Binder 尝试构建包含笔记本和在 git 存储库中声明的要求的 Docker 镜像。如果存储库具有 Dockerfile
、requirements.txt
、environment.yaml
等问题,则构建将失败。我们建议让存储库决问题。
Binder 尝试构建包含 git 存储库中的笔记本和要求的 Docker 镜像。这些笔记本可能具有运行正确所需的要求,例如库和数据文件。如果 git 存储库以受支持的方式 声明这些先决条件,Binder 可以在其构建过程中安装这些先决条件。
如果 Notebook 在其 Binder 环境中无法正确运行,则建议让存储库所有者知道问题或提交拉取请求以帮助解决问题。
是的。本站允许来自 plot.ly、Bokeh 和 Altair 的绘图保持交互。例如,当你访问页面时,任何页面上的任意 JavaScript 也可能被执行,与你在互联网上访问的任何页面一样。
ipynb.cn 只能呈现它可以访问公共互联网上的 Notebook。如果你在本地计算机上的 Notebook 上工作,你需要在公共 URL 上发布该 Notebook(例如在 GitHub 存储库、作为 gist)以便 ipynb.cn 可以呈现它。
托管自己的 nbviewer 服务器可以打开呈现私人 Notebook 的其他途径。例如,你的大学网络上的 nbviewer 服务器可以呈现通过该网络上的 URL 访问的笔记本文件。有关说明和选项,请参见 GitHub 上的 nbviewer 存储库中的 README。
你正在访问的 URL 很可能指向已移动或已删除的 Notebook。如果你单击了导致 404 错误页面的站点上的链接,我们建议你联系站点所有者报告损坏的链接。如果 Notebook 作者为你提供了 URL,则建议向他们询问更新后的链接。
如果你注意到 ipynb.cn 上的链接之一,请在 nbviewer 问题跟踪器中报告它。
nbviewer 从上游提供者(如 GitHub、GitHub gist、公共 Web 服务器)中获取 Notebook 文件。如果提供者未响应、nbviewer 收到的文件无效、文件无法公开访问等,则会显示 4xx 错误。
如果你认为 nbviewer 对可访问的、有效的 Notebook URL 错误地显示了 4xx 错误,请在 nbviewer 问题跟踪器 中提交错误报告。
5xx 错误或 Fastly 的错误页面可能表示公共 ipynb.cn 网站正在重新部署或已关闭。如果问题持续超过几分钟,请在 GitHub 上的 nbviewer 问题跟踪器 中打开错误报告,包括你正在访问的 URL 和你收到的错误。
为了缩短流行 Notebook 的呈现时间,nbviewer 缓存呈现的 Notebook。ipynb.cn 上的缓存持续时间约为 10 分钟。要使缓存无效并强制 nbviewer 重新呈现 Notebook 页面,请将 ?flush_cache=true
添加到 URL 中。
nbviewer 不存储任何 Notebook,它仅在给定其 URL 的情况下呈现在 Web 上存储的 Notebook。如果你发现了一个应该从 Web 上删除的 Notebook,则需要找到它托管的位置(例如 GitHub),以更新或删除它。
不能。但是,你可以在本地安装 nbconvert,并运行 jupyter nbconvert
将 Notebook 文件转换为各种格式。有关详细信息,请参见 nbconvert 文档。
我们服务器站源托管在境外,方便无障碍获取网络上的 Notebook 资源,通过阿里云全球 CDN 提供高速访问。
可以。请使用 https。
当然可以。请参阅 nbviewer 存储库 中的 README 文件,以获取指令和选项。
请在 nbviewer 问题跟踪器 GitHub 页面 中选择适当的问题模板。
请在 Jupyter Community Forum 或 Jupyter Google Group 上发布有关使用 nbviewer 的问题。如果你想提出 nbviewer 的增强功能或文件错误报告,请在 jupyter/nbviewer 项目的问题页面 中开启一个 issue。