Emacs Jupyter 使用教程

1. 项目介绍

emacs-jupyter 是一个开源项目，旨在为 Emacs 编辑器提供一个与 Jupyter 内核通信的接口。通过这个接口，用户可以在 Emacs 中使用 Jupyter 内核的交互式功能，如 REPL（读-执行-打印-循环）和 org-mode 源代码块。

2. 项目快速启动

以下是在 Emacs 中安装和配置 emacs-jupyter 的步骤：

首先，确保你的 Emacs 支持 MELPA 仓库：

(add-to-list 'package-archives ('("melpa" . "https://melpa.org/packages/")))
(package-refresh-contents)

然后安装 emacs-jupyter 包：

(M-x package-install RET jupyter RET)

如果你选择手动安装，需要将项目目录添加到 Emacs 的 load-path 并确保安装了所有依赖：

(add-to-list 'load-path "~/path/to/jupyter")
(require 'jupyter)

3. 应用案例和最佳实践

使用 REPL

启动 Jupyter 内核并在 Emacs 中打开 REPL：

(M-x jupyter-run-repl)

使用 org-mode 源代码块

在 org-mode 文档中，你可以插入源代码块并执行它们以与 Jupyter 内核交互。

#+BEGIN_SRC python :session :exports both
print("Hello, Jupyter!")
#+END_SRC

代码补全和帮助

emacs-jupyter 支持代码补全和符号查看功能，这可以通过以下方式实现：

• 代码补全：使用 completion-at-point 接口。
• 查看符号信息：将光标放在符号上，然后使用 help-go-forward。

4. 典型生态项目

• ob-ipython：一个与 emacs-jupyter 类似的 org-mode 源代码块前端。
• emacs-ipython-notebook（ein）：一个完整的 Jupyter 笔记本界面，提供了许多针对 Python 内核的强大功能。

以上就是 emacs-jupyter 的使用教程，希望对您的学习和使用有所帮助。