About this repository

This repository contains both the source code of the Python Programming course's webpage and the source for the content of the course. The codelabs are located in the site/codelabs folder and everything else is for the website. The exercise files link via submodules in the exercise_files directory.

Contributing to the content

If you spot a mistake, feel free to open an issue in this repo.

If you'd like to help us making the correction, you can open a pull request with your proposed changes. You may find these resources helpful for doing this:

• About pull requests
• Markdown tutorial
• Markdown specification

Development environment

The instructions for serving the landing page and the codelabs themselves are in the README.md file in the site directory.

Prerequisites:

• node and npm
• gulp

The best way to install node is via nvm. Detailed instructions are here but if you know what you're doing, it boils down to running

curl -o- 
https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

and updating the PATH. Then use

nvm install node

and (probably)

sudo apt-get install curl wget git build-essential libssl-dev

Once you have node (and hence npm) installed, you can run the following commands to install gulp:

npm install
npm install --global gulp-cli
npm install --save-dev gulp

The codelabs can be deployed from the site directory using the commands:

./claat_export.sh -o local # deploys codelabs only locally on http://localhost:9090
./claat_export.sh -o landing # deploys codelabs and landing page locally on http://localhost:8000
./claat_export.sh -o deploy # deploys to Github pages

NB: Be sure to read the deployment instructions in the site directory before running these commands.

Authors

Primary material created for Java by Henrik Nygren and Antti Leinonen.

Python adaptations by Scott Morgan.