获取html'处理jupyter笔记本电脑,而不是重组文本
我与其他许多人一起工作的GitHub存储库包含许多Python文件和大约十个Jupyter笔记本。 “ Make HTML”当前假设降级JN细胞是静止的,这会产生毫无意义且丑陋的结果。是否可以配置狮身人面像(或nbsphinx ??),以便使用Markdown(最好是在JN风味中)渲染JN Markdown细胞的读取图?
有一个网站 https://gist.github.com/dupuy/1855764 通过讨论降级和休息的构造,但文档至少有10年的历史来解决问题。例如,它缺少以两种标记语言起作用的“单击此处”链接构造:
[单击此处](urlName)。
我们的JNS结构中仍然存在着似乎没有共同的语法,这些语法在Markdown和Rest中都会产生不错的渲染,或者至少我没有成功地寻找一个。一个示例(可能还有其他)正在列出嵌套列表,特别是没有数字或子弹的列表。
一种替代方法是让JN文本单元通过静止渲染。有一个网站 https://nbsphinx.readthedocs.io/en/en/en/ 0.8.8/raw-cells.html 解释了如何在JN中使用静止。我有两个问题。首先,我们环境中的JNS并不像本网站所解释的那样行事,我不知道如何更改我们的环境(JNS的配置文件??),以使它们以网站声称的方式行为。其次,我们的JN旨在被幼稚的用户使用(甚至比我更天真),因此当天真用户在其“开箱即用”配置中使用JN时,JN必须工作。
The github repo on which I work with many others contains many python files and about ten jupyter notebooks. 'make html' currently assumes that the markdown JN cells are written in reST, which can produce meaningless and ugly results. Is it possible to configure sphinx (or maybe nbsphinx??) so that readthedocs for the JN markdown cells is rendered using markdown (preferably in the JN flavour)?
There is a website https://gist.github.com/dupuy/1855764 that addresses this problem by discussing constructs that are common to markdown and reST, but the document is at least 10 years old. For example, it lacks the "click here" link construct that works in both markup languages, namely:
[click here](urlname).
There remain in our JNs constructs that do not seem to have a common syntax that produces decent rendering in both markdown and reST, or at least I have not been successful in searching for one. An example (and there may be others) is making nested lists, specially lists without numbers or bullets.
An alternative would be for the JN text cells to be rendered by reST. There is a website https://nbsphinx.readthedocs.io/en/0.8.8/raw-cells.html that explains how to use reST in a JN. I have two problems with that. Firstly, JNs in our environment do not behave as this website explains, and I do not know how to change our environment (configuration files for JNs??) to make them behave in the way claimed by the website. Secondly, our JNs are designed to be used by naive users (even more naive than I am), and so the JN must work when the naive user uses JN in its "out of the box" configuration.
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论