68 lines
2.1 KiB
Org Mode
68 lines
2.1 KiB
Org Mode
#+TITLE: tools/ein
|
|
#+DATE: April 11, 2018
|
|
#+SINCE: v2.0
|
|
#+STARTUP: inlineimages
|
|
|
|
* Table of Contents :TOC:
|
|
- [[Description][Description]]
|
|
- [[Module Flags][Module Flags]]
|
|
- [[Plugins][Plugins]]
|
|
- [[Prerequisites][Prerequisites]]
|
|
- [[Features][Features]]
|
|
- [[Interaction with a Jupyter server][Interaction with a Jupyter server]]
|
|
- [[Configuration][Configuration]]
|
|
- [[Setting the default location of your notebooks][Setting the default location of your notebooks]]
|
|
- [[Using hydra][Using hydra]]
|
|
|
|
|
|
* Description
|
|
Adds Jupyter notebook integration into emacs.
|
|
|
|
** Module Flags
|
|
This module provides no flags.
|
|
|
|
** Plugins
|
|
+ [[https://github.com/millejoh/emacs-ipython-notebook][ein]]
|
|
|
|
* Prerequisites
|
|
This module has no prereqisites.
|
|
|
|
* Features
|
|
** Interaction with a Jupyter server
|
|
Three functions are available to start EIN:
|
|
|
|
1. ~ein:jupyter-server-start~ --- Start a jupyter server within emacs
|
|
2. ~ein:notebooklist-login~ --- Login to an existing jupyter server
|
|
3. ~ein:notebooklist-open~ --- Open the list of jupyter notebooks
|
|
|
|
These functions do not have default key bindings.
|
|
|
|
When ~ein:jupyter-server-start~ is called, after successfully finishing,
|
|
~ein:notebooklist-login~ and ~ein:notebooklist-open~ will be automatically
|
|
called.
|
|
|
|
When in the ~Notebook List~ buffer, the key =o= calls ~ace-link~ to speed up the
|
|
process of selecting links in the buffer.
|
|
|
|
If ~company-mode~ is enabled as a module, ~company-ein~ will handle completion.
|
|
|
|
* Configuration
|
|
** Setting the default location of your notebooks
|
|
Change ~+ein-notebook-dir~ to tell ein where to find your Jupityr notebooks.
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(setq +ein-notebook-dir "~/my-notebooks")
|
|
#+END_SRC
|
|
|
|
** Using hydra
|
|
This module provides a batteries-included hydra - ~+ein-hydra~ - to make using ein
|
|
easier. Things like navigating between cells, workbook management etc, are greatly
|
|
simplified and are easily accessible. However, by default, it's not bound to any key.
|
|
Here's an example of how to bind it:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(map! :map ein:notebook-mode-map
|
|
:localleader
|
|
"," #'+ein-hydra/body)
|
|
#+END_SRC
|
|
|