From e4f2833f263496a2627559d06d3efa8d3d657bdd Mon Sep 17 00:00:00 2001 From: Henrik Lissner Date: Thu, 3 Jan 2019 01:39:23 -0500 Subject: [PATCH] tools/ein: rewrite README --- modules/tools/ein/README.org | 50 +++++++++++++++++++++++------------- 1 file changed, 32 insertions(+), 18 deletions(-) diff --git a/modules/tools/ein/README.org b/modules/tools/ein/README.org index bd54c8474..7f1c3147a 100644 --- a/modules/tools/ein/README.org +++ b/modules/tools/ein/README.org @@ -1,20 +1,34 @@ -#+TITLE: :tools ein - -* EIN -- Emacs IPython Notebook - -Tool to work with Jupyter notebooks within emacs. +#+TITLE: tools/ein +#+DATE: April 11, 2018 +#+SINCE: v2.0 +#+STARTUP: inlineimages * Table of Contents :TOC: -- [[EIN -- Emacs IPython Notebook][EIN -- Emacs IPython Notebook]] -- [[Install][Install]] -- [[Usage][Usage]] +- [[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]] -* Install -Add =:tool ein= to your ~doom!~ call in your private ~init.el~. +* Description +Adds Jupyter notebook integration into emacs. -* Usage +** 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 @@ -25,15 +39,15 @@ 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 +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 be used for -completion purposes. +If ~company-mode~ is enabled as a module, ~company-ein~ will handle completion. * Configuration -Specify the default directory where EIN searches for notebooks using: - -~(set! :ein-notebook-dir "~/my-notebooks")~ - +** 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