NOTE The tools here require IPython 1.0, they do not work with IPython 0.13.2.
You should only need to run this notebook once.
It will install the slideshow tools in your IPython profile from github. It's done in steps so you can debug it more easily if things go wrong.
Start by getting the location of your current profile:
profile_dir = get_ipython().profile_dir.location profile_dir
Clone the Github repo with IPython extensions, including the slideshow support, into the right location:
import os tgt = os.path.join( profile_dir, 'static', 'custom') !git clone https://github.com/ipython-contrib/IPython-notebook-extensions.git $tgt
Cloning into '/home/fperez/.ipython/profile_default/static/custom'... remote: Counting objects: 311, done. remote: Compressing objects: 100% (170/170), done. remote: Total 311 (delta 127), reused 309 (delta 125) Receiving objects: 100% (311/311), 92.63 KiB, done. Resolving deltas: 100% (127/127), done.
cd into that directory and check that the contents look right:
%cd $tgt !ls
/home/fperez/.ipython/profile_default/static/custom autosavetime.js custom.example.js nbviewer_theme slidemode autoscroll.js custom.js no_exec_dunder.js slideshow.js breakpoint.js gist_it.js noscroll.js split-combine.js clean_start.js history.js python toggle_all_line_number.js codefolding.js hotkeys.js README.md comment-uncomment.js init_cell read-only.js css_selector linenumbers.js shift-tab.js
Finally, write out a
custom.js file that has activated the slideshow extension. This is simply the provided
custom.example.js file, with two lines commented out. Feel free to add more to activate other extensions, as explained in the
That's it! You should now restart your notebook server and reload the pages just to make sure you get fresh CSS. If everything went well, your toolbar should look like this, with a new button highlighted here in red:
That new button is the toggle to enter live slideshow mode, which you can use to switch between the normal editing mode (with the whole notebook as one long scrolling document) and the presentation mode.
Now that you've read this, look at the accompanying
notebook-slideshow-example notebook as a starting illustration of how you can write a presentation-oriented notebook.