Course materials for the CodeFirstGirls Sheffield Introduction to Python Course
To run the Jupyter Notebook slides, you need:
- Python 3
- The
jupyterPython package - The
RISEPython package
Install Python 3 with the link above. Then, open a terminal and run the following commands to install the jupyter and RISE package:
pip install jupyter RISEIf you also have Python 2 installed on your computer (i.e. if you are working on a Mac/Linux machine), you may have to replace pip with
pip3 in the command above.
In the terminal, change to the directory containing the Jupyter Notebook slides, then run the following commands to start the Jupyter Notebook server needed to run the slides:
jupyter notebookAlternatively, if your machine can run Docker (Windows 10 Pro, MacOS or any Linux distro), you can run the Jupyter Notebook server inside a Docker container.
To begin, install Docker and the Docker Compose command line tool. If you are on Windows or MacOS, Docker Compose will have already come with your Docker installation.
Then, at the root of the repository, type this single command to start the Jupyter Notebook server:
docker-compose upYou should see output similar to the following:
Starting jupyter-notebook ... done
Attaching to jupyter-notebook
jupyter-notebook | Executing the command: jupyter notebook
jupyter-notebook | [I 20:38:44.343 NotebookApp] JupyterLab extension loaded from /opt/conda/lib/python3.7/site-packages/jupyterlab
jupyter-notebook | [I 20:38:44.343 NotebookApp] JupyterLab application directory is /opt/conda/share/jupyter/lab
jupyter-notebook | [I 20:38:45.348 NotebookApp] Serving notebooks from local directory: /home/jovyan
jupyter-notebook | [I 20:38:45.348 NotebookApp] The Jupyter Notebook is running at:
jupyter-notebook | [I 20:38:45.349 NotebookApp] http://47e3a7c93868:8888/?token=c5abd1bcdfbb9f70d26eed5a045eb3a58dd7c1d9e8627b29
jupyter-notebook | [I 20:38:45.349 NotebookApp] or http://127.0.0.1:8888/?token=c5abd1bcdfbb9f70d26eed5a045eb3a58dd7c1d9e8627b29
jupyter-notebook | [I 20:38:45.349 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
jupyter-notebook | [C 20:38:45.354 NotebookApp]
jupyter-notebook |
jupyter-notebook | To access the notebook, open this file in a browser:
jupyter-notebook | file:///home/jovyan/.local/share/jupyter/runtime/nbserver-6-open.html
jupyter-notebook | Or copy and paste one of these URLs:
jupyter-notebook | http://47e3a7c93868:8888/?token=c5abd1bcdfbb9f70d26eed5a045eb3a58dd7c1d9e8627b29
jupyter-notebook | or http://127.0.0.1:8888/?token=c5abd1bcdfbb9f70d26eed5a045eb3a58dd7c1d9e8627b29Unlike Method 1 which opens a browser automatically, you need to copy the URL beginning with http://127.0.0.1:8888 in your browser instead
to see the same Jupyter user interface.
Using nbconvert (from https://rise.readthedocs.io/en/stable/exportpdf.html)
Generate the slides and serve them using nbconvert:
jupyter nbconvert --to slides your_talk.ipynb --post serveIt opens up a webpage in the browser at http://127.0.0.1:8000/your_talk.slides.html#/
Add ?print-pdf to the query string as http://127.0.0.1:8000/your_talk.slides.html?print-pdf Note that you need to remove the # at the end. The page will render the slides vertically.
Save to PDF in Chrome using the print option:
Open the in-browser print dialog (Cmd/Ctrl + P).
Change the Destination setting to Save as PDF.
Change the Layout to Landscape.
Change the Margins to None.
Enable the Background graphics option.
Click Save.
Download pandoc & wkhtmltopdf (need to add wkgtmltopdf to path)
navigate to folder where the file is located
pandoc -t html --css stylesheet.css {filename}.md -o {output filename}.pdf -V margin-top=20 -V margin-left=20 -V margin-right=20 -V margin-bottom=20