Initial commit

Author: hw0lff

.gitignore

@@ -0,0 +1,21 @@
+# Generated by Cargo
+# will have compiled files and executables
+**/target/
+
+# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
+# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
+Cargo.lock
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# Were the pdfs will be
+/out/
+
+# compiled
+test/lesson3_3_ref
+test/lesson5_destr_enum
+
+# ViM temp files
+*.swp
+*.swo

Makefile

@@ -0,0 +1,41 @@
+OUTDIR := out
+SRCDIR := src
+SRCS := $(wildcard src/lesson*.typ)
+# ∀%: src/lesson%.typ ⇒ out/lesson%.pdf
+OUTS := $(foreach lesson,$(SRCS:.typ=.pdf),$(subst $(SRCDIR)/,$(OUTDIR)/,$(lesson)))
+SLIDES = $(SRCDIR)/slides.typ
+SYNCDIR := ./
+REMOTE := kaki:public_html/rust-lessons
+# verbose, checksum, Progress
+RSYNCFLAGS := -vcP --exclude-from=rsync_exclude
+# tell typst where to look for fonts, equivalent to « --font-path fonts/ »
+TYPST_FONT_PATHS := fonts/
+
+# tell make that these are not supposed to be files
+.PHONY: all clean watch% lesson% rsync rsync-dryrun
+
+all: $(OUTS) Makefile
+
+clean:
+	rm -rf $(OUTDIR)/*.pdf
+
+watch%: $(SRCDIR)/lesson%.typ $(SLIDES) Makefile
+	TYPST_FONT_PATHS=$(TYPST_FONT_PATHS) \
+	typst watch $< $(subst $(SRCDIR),$(OUTDIR),$(subst .typ,.pdf,$<))
+
+lesson%: $(OUTDIR)/lesson%.pdf
+	@true
+
+# tell make that these files have no dependency
+$(SRCDIR)/lesson%.typ:
+	@true
+
+$(OUTDIR)/lesson%.pdf: $(SRCDIR)/lesson%.typ $(SLIDES) Makefile
+	TYPST_FONT_PATHS=$(TYPST_FONT_PATHS) \
+	typst compile $< $@
+
+rsync:
+	rsync -r $(RSYNCFLAGS) $(SYNCDIR) $(REMOTE)/
+
+rsync-dryrun:
+	rsync -rn $(RSYNCFLAGS) $(SYNCDIR) $(REMOTE)/

README.md

@@ -0,0 +1,51 @@
+# Rust Lessons
+
+## Compiling to pdf
+You need the [typst] typesetting system.
+
+To compile a specific lesson:
+```shell
+make lesson$number
+make lesson1
+```
+To compile all lessons:
+```shell
+make all -j $(nproc)
+```
+
+## Lesson notes
+How a specific lesson is planned
+
+### Lesson 1
+- 30 minutes installation of the toolchain
+- 60 minutes for the basics
+If someone does **not** have a working setup after 15 minutes,
+instruct them to use the computer in front of them (assuming you are in the computer pools).
+
+End with everyone trying out exercise 1
+
+### Lesson 2
+#### Funktionen
+Explain what functions look like.
+Order independent:
+`seven()` is defined after its first use in the file.
+Ask: Can anybody see an error?
+-> use meaningful variable names
+
+#### statements und expressions
+- backtrack to tuple -> empty tuple -> unit type
+
+#### Quiz 3 Fibonacci
+-> overflow checks
+- End: give many different input parameters without explicitly saying so
+-> loop
+
+#### loops
+- `loop` `continue`, `break`
+- with `if` + `else` we can exit loop
+
+- `while`: condition tied to loop
+
+
+
+[typst]: https://github.com/typst/typst