Jupyter Notebook, Reveal.js and Github Pages


Dheepak Krishnamurthy


December 5, 2015


ipython, ipython notebook, jupyter, jupyter notebook, reveal.js, github pages, presentations

Jupyter Notebook has the ability to convert an notebook ipynb to markdown, rst, html and interestingly slides. And these Reveal.js powered slides can be hosted on GitHub pages, like any other html page. The following steps works well for me to generate a static set of slides from a notebook that can be used as a presentation

ipython nbconvert index.ipynb --to slides --reveal-prefix ../reveal.js

If you did not Fork reveal.js and force update master to origin/gh-pages, and instead cloned reveal.js to this folder, you can add it as a submodule and use the following instead

ipython nbconvert index.ipynb --to slides --reveal-prefix reveal.js

You can find an example here and the original notebook here.



BibTeX citation:
  author = {Krishnamurthy, Dheepak},
  title = {Jupyter {Notebook,} {Reveal.js} and {Github} {Pages}},
  date = {2015-12-05},
  url = {https://kdheepak.com/blog/jupyter-notebook-revealjs-and-github-pages/},
  langid = {en}
For attribution, please cite this work as:
D. Krishnamurthy, “Jupyter Notebook, Reveal.js and Github Pages,” Dec. 05, 2015. https://kdheepak.com/blog/jupyter-notebook-revealjs-and-github-pages/.