Update Docs to include alternative method for building Jekyll locally.

[krinsman]

This follows up on the discussion in the GitHub issue thread for another project, see here.

In particular, there is now a Conda Forge package for installing GitHub Pages (and with it Jekyll, Ruby, etc.) with no need for C++ compilers or other sources of hair-pulling (at least on Mac OS X). So I also updated the Makefile to run gem install bundler only if Bundler is not already installed.

It took me many hours today getting all of this sorted out, so I hope these changes help others.

[sodre]

I would like to add that I am trying to get jupyter-book included in conda-forge directly. There is an open issue for that, but I ended up getting pulled in other directions before I finished all the work.

If there is desire from the Jupyte-Book team to have it in conda-forge, I will devote more time to finish the conda-recipe sooner rather than later.

[choldgraf]

I had no idea that the github pages conda-forge recipe existed, but that is super cool. I'm out of the office until next monday...I wonder if @emdupre or @psychemedia might be able to demo these installation instructions to see how they work? Otherwise I'll try when I'm back to reliable internet.

[sodre]

I'll add that I have been trying to get jupyter-book into conda-forge already, c.f. conda-forge/staged-recipes#9315.

It would be very helpful to close that issue if #315 is fixed on your side first.

[choldgraf]

hey @sodre - thanks for the information! #315 has been merged, but I'm unsure what is the best next-step. Let me know if you need action from the jupyter book team!

[choldgraf]

Note that now that #324 is passed, we use the rb-github-pages recipe in the tests! It works really nicely :-)

[choldgraf]

OK, the instructions work (see #315) and I think we'll be revamping the installation section soon anyway, so I'm gonna merge this and we can iterate later!

[sodre]

@choldgraf, the next step from the conda-forge side is to wait for the next PyPi release. Once that is available we can try to create the conda-forge package.

[choldgraf]

@sodre sounds good - I wanna make a release soon, just closing up a few nagging bugs and quality of life things first.

[sodre]

I started watching the release for jupyter-books, but feel free to ping me when that is available.

[emdupre]

@sodre jupyter-book version 0.6 was just released ! https://pypi.org/project/jupyter-book/