Wenn es das Institut/Lehrstuhl und das Fach bereits gibt könnt ihr den nächsten Abschnitt überspringen
Institute werden in src/config/institutes.ts
konfiguriert. Folgt hier einfach den bisherigen Lehrstühlen.
Nun könnt ihr das Template kopieren src/app/_%institutename%
den Namen des Lehrstuhls ersetzten und !!! _
entfernen !!!. Ändert nun noch umbedingt config.ts
und insgesamt alles wo CHANGE_ME
/CHANGE ME
vorkommt. Folgt nun dem nächsten Abschnitt um euer neues Fach zu konfigurieren.
Fächer werden in src/config/subjects.ts
konfiguriert. Folgt hier ebenso den bisherigen Fächern.
Nun könnt ihr das Fach im Template (src/app/_%institutename%/%subjectname%
) in euer Lehrstuhl kopieren, den Namen ändern und überall in dem Ordner nach CHANGE ME
suchen. Somit sollte das ein minimal funktionierendes Fach herauskommen und die Zusammenfassungen korrekt vom summaries Ordner gelesen werden. Zur Not schreibt mich einfach an und ich kann euch bestimmt helfen, oder macht ein Pull-Request und fragt dort nach.
Die neuen Seiten des Faches können natürlich nach belieben ausgeschmückt und erweitert werden.
Wenn ihr zu dem Repository geht und euch die Dateistruktur anschaut, werdet ihr ungefähr folgendes auffinden:
/
└── summaries/
└── cigol/
└── malo/
├── ASKompaktheitssatz.mdx
├── Axiomatisierbarkeit.mdx
├── EF_Spiele.mdx
├── Einführung_Aussagenlogik.mdx
├── Einführung_Prädikatenlogik.mdx
├── Resolution.mdx
├── Spieltheorie.mdx
├── TolleStrukturen.mdx
└── Wasdas.mdx
Alle Zusammenfassungen auf HTWR werden mittels .mdx
Datei geschrieben. Im Grunde einfach Markdown
wie ihr es aus z.B. Obsidian kennt,
bloß mit zusätzlichen features wie Javascript support und wichtiger für HTWR custom react component support.
HTWR erkennt für bestehende Fächer automatisch neue Dateien im entsprechenden Fach Ordner. Die Sortierung ist Einleuchtend summaries -> ( (umgekehrter) Lehrstuhlname ) -> ( Fachname ) -> (*.mdx )
HTWR unterstützt die GitHub Markdownsyntax inclusive
```haskell
main = putStrLn "Hello, World!"
```
wird zu
main = putStrLn "Hello, World!"
für Code-Highlighting
$ \sum_{k=1}^n k = \frac{n(n+1)}{2} $ wird zu für LaTex Mathe. Sobald es möglich wird möchte ich auch typst einbinden, die sind aber gerade erst an einem HTML compile output dran.
Wie das Känguru aus Känguru-Chroniken bereits sagte:
Witzig oder nicht Witzig
Eine Zusammenfassung ist für den Author ein leeres Gemälde. Sie sollte irgendwo Inhalt haben, aber Kreativität und Humor ist auch gerne gesehen. Es ist eher eine Frage der Zeit und des Einfallsreichtum des Erstellers.