GitHub上的Jupyter笔记本中的目录表

时间:2019-03-08 15:07:27

标签: python github jupyter-notebook

我在Jupyter笔记本中使用HTML锚来提供内部链接,例如目录和“返回首页”中使用的那些链接。这在我的计算机上工作得很好。但是,当我将笔记本上载到GitHub时,看不见的锚点变为可见,并且链接不再起作用。如何解决这个问题?

以下是GitHub上的一些笔记本电脑出现的问题:

https://github.com/mathyingzhou/linear_algebra_demos/blob/master/01-LinearSystems/Solving%20linear%20systems.ipynb

https://github.com/mathyingzhou/boston-crime/blob/master/Boston%20Crime.ipynb

3 个答案:

答案 0 :(得分:1)

根据github,您认为您不能对此做很多事情:

working-with-jupyter-notebook-files-on-github

答案 1 :(得分:0)

从2020年6月18日开始,对此有一些提示。

在您的

<a id = "1"></a>

在'='前后有一个空格。我已经对此进行了测试,并且在本地还可以(不可见),但是GitHub在解析时将其中断并使其可见。

您似乎已经采用了塞巴斯蒂安·拉施卡(Sebastian Raschka)的tip,即将锚定标记放在具有内容的标记上方的空白markdown单元格中。我发现这不是必需的。我一直无法通过打印预览或“以HTML格式下载”来重现Sebastian的问题。也许Jupyter的行为已经改变(六年前他发表了这篇文章!)。您应该会发现降价促销

# A content heading<a id='headingid'></a>

有效。当我对其进行测试时,这在本地和GitHub上都是不可见的。您也可以使用降价链接(例如

)链接到它
I want to refer to my [heading](#headingid) now

,这可以作为笔记本中本地的可单击链接。它在Github自己的渲染器中不能作为可点击链接运行。当您将笔记本的URL粘贴到nbviewer时,它可以作为可点击链接。我也在本地尝试过File |下载为| html,以获取ipynb的html版本,我的浏览器将按预期方式呈现此链接,并且该链接是可单击的并且可以正常工作。

这是我最近一直在研究的内容,以上是目前我最好的工作方法,即将锚标记附加到所需的markdown文本上,等号前后均不能有空格。在GitHub上看起来还可以,您只是没有可点击的链接。我不确定使用GitHub是否有解决办法。

如果有人认为此答案有用,我将不胜感激,因为这是我正在努力的工作,正在寻找自动化方法。赞成票不仅会鼓励我,而且我乐于接受评论,这些评论为我提供了一些功能方面的想法,这些功能包括在我为使之自动化而编写的任何内容中。

答案 2 :(得分:0)

您可以使用“ nbviewer”而不是GitHub的渲染器来渲染和服务您的笔记本。因此,您可以在存储库的ReadMe.md文件中提供指向笔记本的链接,例如:

https://nbviewer/github/<mygithubprofile>/<link2mynotebook>

请参阅@ martijn-pieters在此帖子上提供的答案: HTML anchors in a Jupyter notebook on Github

这为我解决了。