feat: add first 2 lessons
This commit is contained in:
parent
f4bd05cde3
commit
b2e82fccd6
5 changed files with 90 additions and 2 deletions
1
.gitignore
vendored
Normal file
1
.gitignore
vendored
Normal file
|
@ -0,0 +1 @@
|
||||||
|
*.pdf
|
39
01-install/lesson.typ
Normal file
39
01-install/lesson.typ
Normal 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
49
02-styling/lesson.typ
Normal 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
0
03-modes/lesson.typ
Normal file
|
@ -21,11 +21,10 @@ und direkt im Anschluss eine Aufgabe,
|
||||||
die zum Experimentieren mit diesem Konzept einlädt.
|
die zum Experimentieren mit diesem Konzept einlädt.
|
||||||
|
|
||||||
- [Installation](./01-install)
|
- [Installation](./01-install)
|
||||||
- [Basic markup](./02-markup)
|
- [Styling](./02-styling)
|
||||||
- [Die drei Modi](./03-modes)
|
- [Die drei Modi](./03-modes)
|
||||||
- [Code mode](./04-code)
|
- [Code mode](./04-code)
|
||||||
- [Mathematik](./05-math)
|
- [Mathematik](./05-math)
|
||||||
- [Styling](./06-styling)
|
|
||||||
|
|
||||||
[EH21]: https://eh21.easterhegg.eu/
|
[EH21]: https://eh21.easterhegg.eu/
|
||||||
[typst]: https://typst.app
|
[typst]: https://typst.app
|
||||||
|
|
Loading…
Reference in a new issue