繁体   English   中英

Github 上 Jupyter 笔记本中的 HTML 锚点

[英]HTML anchors in a Jupyter notebook on Github

因此,有很多关于在 Markdown 中创建锚点以及在笔记本中创建内部目录类型锚点的方法。 不过,我需要的是能够从外部来源访问我在 Github 上的笔记本中的锚点,例如:

https://github.com/.../mynotebook.ipynb#thiscell

我有许多以这种方式托管的交互式教程,以及我希望能够链接到笔记本部分的单个手册。 我可以使用以下方法将锚标记添加到 Markdown 单元格中:

<a id='thiscell'></a> 

但是当我尝试使用我上面写的链接时,它只是在顶部加载笔记本,好像没有引用锚点。

GitHub 使用单独的域 render.githubusercontent.com 呈现笔记本,并将输出集成到嵌套框架中 这意味着 GitHub URL 上的任何锚点都不起作用,因为框架文档是完全不同的 URL。

此外,框架内容不容易重复使用,结果是笔记本的缓存渲染具有有限的生命周期。 你不能指望它留下来供以后链接!

因此,如果您需要能够链接到笔记本中的部分,则最好使用 Jupyter 笔记本查看器服务https://nbviewer.jupyter.org/ 它支持显示来自任何公共 URL 的笔记本,包括 GitHub 托管的存储库和 GitHub 要点。 您也可以只输入您的 GitHub 用户名(或username/repository )以进行快速访问。

这个笔记本查看器比 GitHub 使用的功能丰富得多。 GitHub 杀死了所有嵌入的 JavaScript,并去除了几乎所有的 HTML 属性。 任何嵌入的动画都是正确的。 但是 Jupyter nbviewer 服务支持那些直接开箱即用的服务。

例如在 nbviewer 上比较这两个笔记本:

在 GitHub 上使用相同的笔记本:

第一个在最后包含一个动画,第二个有一个复杂的表格,通过使用一些 HTML 样式和锚链接更容易阅读。

我有同样的问题。 作为一种解决方法,我已将笔记本的渲染委托给http://nbviewer.jupyter.org 只需提供其 GitHub公共url 并单击 Go!

当然,内部链接在 GitHub 下仍然不起作用,但是我现在在网络上的某个地方有一个可以正常运行的笔记本,这正是我最初真正想要的。

我希望这也适用于您的情况。

暂无
暂无

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM