stata_kernel icon indicating copy to clipboard operation
stata_kernel copied to clipboard

Document how to use stata_kernel and Emacs Org-Mode

Open roblem opened this issue 5 years ago • 5 comments

This is less of a bug report and more of a shout-out to the project that stata kernel works very well in Emacs Org-Mode, providing both a jupyter notebook-like and Repl-like experience (as in atom). In the link I do a short screencast and outline Emacs specific steps for getting this working. Thanks.

roblem avatar Jul 14 '20 10:07 roblem

Thanks, this is cool! I've never used emacs, but if you think there's a place for it in the docs, you're welcome to suggest an improvement to the docs. E.g. under Using Jupyter, there's a page for several different Jupyter frontends. If you'd like to write some short text of using with emacs, you're welcome to.

kylebarron avatar Jul 27 '20 16:07 kylebarron

You could probably just add a paragraph with a short description of what org mode is, and link to your blog post for more information. If you don't want to figure out how my docs work, you could just give me text and I could add a new page in the docs for you.

kylebarron avatar Jul 27 '20 17:07 kylebarron

I'll try to add it to your docs. It may take a few weeks, so I'll leave open and change title.

roblem avatar Jul 27 '20 17:07 roblem

No rush!

You can just add a new file named emacs.md in the using_jupyter directory, and then add an emacs section to the mkdocs configuration. You should be able to run pip install mkdocs mkdocs-material pygments then mkdocs serve to test the website locally.

If that doesn't work just ping me, because I think there was a new release of mkdocs-material since I last modified the site, and I have to change a thing or two in mkdocs.yml.

kylebarron avatar Jul 27 '20 17:07 kylebarron

I have finally finished a slightly better gif screencast attached here. I'll move on to the docs next. emacs-orgmode-jupyter-stata-demo

roblem avatar Apr 01 '21 21:04 roblem