GitHub 上 Jupyter 笔记本中的目录

Question

我在 Jupyter 笔记本中使用 HTML 锚点来提供内部链接，例如在目录和“返回顶部”中使用的链接。这在我的电脑上运行良好。但是，当我将笔记本上传到 GitHub 时，不可见的锚点变得可见并且链接不再有效。如何解决这个问题呢？以下是 GitHub 上的一些存在此问题的笔记本：https://github.com/mathyingzhou/linear_algebra_demos/blob/master/01-LinearSystems/Solving%20linear%20systems.ipynbhttps://github.com/mathyingzhou/boston-crime/blob/master/Boston%20Crime.ipynb

Answer 1

根据 github，不要认为你可以做很多事情：

与 jupyter-notebook-files-on-github 一起工作

Answer 2

你可以使用“nbviewer”来渲染和提供你的笔记本，而不是 GitHub 的渲染器。因此，您需要在存储库的 ReadMe.md 文件中提供指向笔记本的链接，例如，如下所示：

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

查看@martijn-pieters 在这篇文章中提供的答案： Github 上 Jupyter notebook 中的 HTML 锚点

这为我解决了。

Answer 3

在你的

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

在“=”之前和之后都有一个空格。我已经对此进行了测试，并且在本地没问题（不可见），但是 GitHub 在解析它时会中断并使其可见。

您似乎已经采用了 Sebastian Raschka 的技巧，即将锚标记放在带有内容的标记上方的空降价单元格中。我觉得这没有必要。我一直无法通过打印预览或“下载为”HTML 重现 Sebastian 的问题。也许 Jupyter 的行为已经改变了（他在六年前发布了那篇文章！）。你应该发现降价

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

作品。当我测试它时，这在本地和 GitHub 上都是不可见的。您还可以使用降价链接到它，例如

I want to refer to my [heading](#headingid) now

这在您的笔记本中用作本地可点击链接。它不能作为 Github 自己的渲染器中的可点击链接。当您将笔记本的 URL 粘贴到nbviewer时，它确实可以作为可点击的链接使用。我也试过，在本地，文件 | 下载为 | html，以获得 ipynb 的 html 版本，我的浏览器按预期呈现它，并且链接是可点击的并且可以工作。

这是我最近一直在研究的东西，上面是目前我最好的工作方法，即将锚标记附加到您想要的降价文本中，等号之前/之后没有空格。它在 GitHub 中看起来没问题，只是没有可点击的链接。我不确定是否有使用 GitHub 的方法。

如果有人觉得这个答案有用，我将不胜感激，因为这是我正在研究并寻找自动化方法的事情。Upvotes 既会鼓励我，我也愿意接受评论，这些评论给了我关于功能的想法，这些功能包含在我为自动化而编写的任何内容中。