feat: add first 2 lessons

This commit is contained in:
multisn8 2024-02-25 22:49:45 +01:00
parent f4bd05cde3
commit b2e82fccd6
Signed by untrusted user: multisamplednight
GPG key ID: C81EF9B053977241
5 changed files with 90 additions and 2 deletions

1
.gitignore vendored Normal file
View file

@ -0,0 +1 @@
*.pdf

39
01-install/lesson.typ Normal file
View file

@ -0,0 +1,39 @@
= Installation
Primär gibt es 3 Wege, um Typst zu verwenden:
+ Webapp von Typst selber,
welche man unter https://typst.app/ auch gleich erreichen kann.
Benötigt allerdings Login.
+ Texteditor deiner Wahl.
Typst hat ein #link("https://github.com/typst/typst")[Open-Source CLI],
aber je nach Editor kann das mehr oder weniger aufwendig aufzusetzen sein,
wenn man noch Hot Reloading und in die Richtung haben möchte.
- Netterweise hat das CLI auch den Befehl `typst watch`,
was die gegebene typst-Datei bei jeder gespeicherten Änderung
neu zu einem PDF kompiliert.
+ Einen dezidierten Editor für Typst.
- Derzeit ist uns nur #link("https://github.com/Cubxity/typstudio")[typstudio] bekannt.
== CLI
In Arch, Nixpkgs, SUSE, Void und macOS durch Homebrew ist typst schon packaged.
Ansonsten kann man sich die Assets
#link("https://github.com/typst/typst/releases/tag/v0.10.0")[vom letzten Release auf GitHub]
holen.
= Aufgabe
Kompiliere dieses Dokument hier
und zeige es in einem PDF-Viewer deiner Wahl an.
Mit dem CLI sollte das mithilfe von `typst compile` gehen.
= Nächste Lesson...
Schauen wir uns an,
wie wir zum Beispiel die Links hier im Dokument
etwas aufhübschen und vom eigentlichen Text unterscheidbar können.

49
02-styling/lesson.typ Normal file
View file

@ -0,0 +1,49 @@
= Styling
Jetzt, wo wir Dokumente auch komplieren können,
wollen wir doch mal sehen,
was diese so enthalten können.
Generell ist die Syntax sehr ähnlich zu Markdown,
die wichtigsten Unterschiede sind:
== Nummerierte Listen
+ Nummerierte Listen können auch mit `+` anstatt von expliziter Eintragsnummer
2. wie hier
+ gemacht werden. Beides ist äquivalent.
== Überschriften
Gehen mit `=` anstatt von `#`.
== Hervorhebung
Gibt es mit einmal `_` für _kursiv_
und einmal `*` für *fettgedruckt*.
Das ist auch _*kombinierbar*_.
== Links
Wie https://example.com/ sind zwar automatisch im PDF anklickbar,
aber werden farblich per default nicht unterschieden.
Das lässt sich allerdings mithilfe einer _show-rule_ ändern.
#show link: underline
Nach dieser show-rule sind alle Links,
direkt wie https://example.com/
oder indirekt wie #link("https://example.com")[der hier]
unterstrichen.
Show-rules und ihre Freunde set-rules ändern alles, was danach steht.
= Aufgabe
Nimm eine beliebige Markdown README aus einem beliebigen geklonten Git Repo
und schreib diese in typst um.
= Nächste Lesson...
Schauen wir uns an, was `#` überhaupt soll.

0
03-modes/lesson.typ Normal file
View file

View file

@ -21,11 +21,10 @@ und direkt im Anschluss eine Aufgabe,
die zum Experimentieren mit diesem Konzept einlädt.
- [Installation](./01-install)
- [Basic markup](./02-markup)
- [Styling](./02-styling)
- [Die drei Modi](./03-modes)
- [Code mode](./04-code)
- [Mathematik](./05-math)
- [Styling](./06-styling)
[EH21]: https://eh21.easterhegg.eu/
[typst]: https://typst.app