/python-lessons

🐍 Python lesson TeX source

Primary LanguageTeXOtherNOASSERTION

Python Lessons

This repository contains the Python Lesson sources for the free student courses, held at the TU Dresden.

Exercises to go along with the courses can be found on GitHub pages or on the gh-pages branch of this repository as Markdown sources.

Compiling the markdown sources

The slides in the md folder need to be compiled with reveal.js.

Therefore, pandoc has to be installed on your computer. You can find these Instructions here. Mac users can simply install it with homebrew: brew install pandoc

Before installing create a src/js/token.js from src/js/token.js.example and insert your repl.it API token.

Run ./install.sh to initialize the html folder with reveal.js and copy the ifsr.css this only have to be done once

To build the slides simply run ./build_reveal.py. The compiled html files are in the html folder and easily can be accessed via the index.html

If you add new slides don't forget to add them to reveal.json.

An online copy can be found here.

Instructions for teachers and contributors

If you want to contribute to these lessons, you should note that every topic exists as .tex file and as .md file because the tex files - rendered as PDF - offer a much more convenient way to look up something after a lesson while the rendered reveal.js slides are way better for presenting the slides in class. The black background and the few lines per slide improve readability and help to focus on the subject. Plus they look much better 😉

So if you are thinking about making some content-related changes, it would be nice if you apply those changes to both, the md and the tex slides.

For contributing to the tasks, have a look at the gh-pages branch of this repository.

Teaching

As stated above, you should rely on the rendered Markdown slides for presenting. The tex files are automatically rendered and can be found at:
http://fsr.github.io/python-lessons/materials.html

Almost every task is linked to a lesson. The corresponding PDF is linked automatically at the beginning of every task.

Solutions for all tasks on this page can be found at this repository.

These lessons are created and maintained by @h4llow3En, @justusadam and @feliix42.