From f0461daa0b6bba9fb05263f2cd44a77a32fed9b4 Mon Sep 17 00:00:00 2001 From: Nicholas Miklaucic Date: Fri, 15 Dec 2017 13:22:51 -0500 Subject: [PATCH] Added documentation re: json-readtable-error to help debug it Fixed syntax error affecting code display Quoted to escape in verbatim string Trial and error on Github Markdown syntax and org export Just give up Oops Added documentation to errors reading JSON that explains how to find the root cause of the error --- README.org | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.org b/README.org index b61f3e6..ba5b896 100644 --- a/README.org +++ b/README.org @@ -302,6 +302,18 @@ Essentially the instructions boil down to quick fix. Otherwise feel free to cut an issue - I'll do my best to help. +*** When I start Emacs or initialize =ob-ipython=, I get =json-readtable-error= + + If you get this error, there's most likely a problem with Emacs talking to =jupyter= or + =ipython=. Try running ~M-! jupyter --version~ and see what you get. If you get a message indicating + that it didn't recognize =jupyter=, then try making sure you've configured your PATH correctly with + something like [[https://github.com/purcell/exec-path-from-shell][exec-path-from-shell]]. + + If this doesn't work, get exactly what is going wrong by invoking ~M-x debug-on-entry RET + json-read~ followed by triggering the bug. This should help narrow down what exactly is going + wrong. Check your virtualenv and make sure that the ~M-! jupyter --version~ command from earlier + isn't returning garbled text. + ** Alternatives *** Why not use IPython notebook?