Update local install instructions

[mwcraig]

This PR fixes #123 by adding a couple conda-specific install steps and a mac-Mojave-specific step.

[emdupre]

This looks great to me !

The one thing I think that would be nice to add (in another PR !) is installation instructions specifically for windows. But I'm excited to see these incorporated, thank you 🎉

[choldgraf]

this looks great to me! I agree about windows-specific install, and also agree it should be in a different pr :-) thanks @mwcraig !

[phaustin]

@choldgraf -- following these directions for macos mojave with conda-forge works up to bundle's attempt to compile eventmachine. This fails with the message:

current directory: /Users/phil/repos/dj_pine_text/jupybook/pyscience/vendor/bundle/ruby/2.6.0/gems/eventmachine-1.2.7/ext
make "DESTDIR="
compiling binder.cpp
In file included from binder.cpp:20:
./project.h:119:10: fatal error: 'openssl/ssl.h' file not found
#include <openssl/ssl.h>
         ^~~~~~~~~~~~~~~
1 error generated.
make: *** [binder.o] Error 1

jekyll community silent here: https://talk.jekyllrb.com/t/macos-install-of-jekyll-with-conda-proving-tricky/3049

and in the referenced github issue: jekyll/jekyll#7739

but I can get make serve working with homebrew, so not sure what's really missing, or how others are making this work on macos.

[choldgraf]

gahh this problem keeps popping up. Have you tried installing gh-pages directly from conda-forge from the instructions here: https://jupyterbook.org/guide/publish/book-html.html#Using-the-conda-forge-recipe-rb-github-pages ?

and if worst comes to worst, try out the Docker instructions here: https://jupyterbook.org/guide/publish/book-html.html#Docker

[phaustin]

Had another run at this and I see my mistake -- I lost patience with the 5 minute wait to build the libsass wheel and installed that from conda-forge which created the openssl conflict. If I just rely on pip and the libsass wheel, I get a working build. (Once conda-forge/staged-recipes#9315 lands, someone at ruby hq should send numfocus a sizeable donation.)

[ma-sadeghi]

Is there a reason why jupyter-book is not on conda-forge yet?

[chrisjsewell]

laziness 😆
No I we/I had to get all the dependant packages on conda-forge first, which I believe is now done, and now there is just a few outstanding issues in conda-forge/staged-recipes#12516