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.
|
||||
|
||||
- [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
|
||||
|
|
Loading…
Reference in a new issue