快速上手#

为了使用 Thebe,您必须在网页上执行以下步骤:

加载 thebe JavaScript 包#

Thebe JavaScript 最容易从 CDN 获取。您可以通过在页面上包含以下内容来从 CDN 加载 JavaScript 库:

<script src="https://unpkg.com/thebe@latest/lib/index.js"></script>

或者,也可以下载这个包,并包含在你的站点中。

在页面的HTML中配置Thebe#

Thebe 会在其配置时寻找特定的 HTML 块。这发生在 Thebe 被“引导”(即启动)的时候。

配置块具有以下结构:

<script type="text/x-thebe-config">
   {
       a: collection
       of: key
       val: pairs
   }
</script>

请参阅配置 Thebe以获取有关如何使用 Thebe 进行配置以及需要配置哪些信息的信息。

在页面上引导 Thebe#

如果已加载了 Thebe 的 Javascript 包,并且配置文件存在,你可以通过调用以下 Javascript 函数来引导(即启动)Thebe:

thebelab.bootstrap()

它将执行以下一个或多个操作:

  • 重新渲染代码单元格,使它们成为活动单元格。(渲染可以处理包含由提示符区分的输入和输出混合的单元格)

  • (可选)从 Binder 请求一个笔记本服务器

  • (可选)从一笔记本服务器请求一个Jupyter内核。

调用引导函数通常是通过将其连接到页面上按钮的“click”事件来完成的。

小技巧

如果在Thebe配置中设置了 bootstrap: true,则在页面加载时将自动触发此操作。