Skip to content

Commit

Permalink
docs&more (#51)
Browse files Browse the repository at this point in the history
* feat: shiki & next turbo

* a bunch of stuff
  • Loading branch information
jonsch318 authored Jun 23, 2024
1 parent 6e827bc commit e1261b6
Show file tree
Hide file tree
Showing 83 changed files with 6,032 additions and 10,855 deletions.
1 change: 1 addition & 0 deletions .eslintrc
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@
"project": "./tsconfig.json"
},
"rules": {
"no-restricted-syntax": "off",
"no-unused-vars": [
"warn",
{
Expand Down
3 changes: 0 additions & 3 deletions __mocks__/fs.js

This file was deleted.

3 changes: 3 additions & 0 deletions __mocks__/fs.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
import { fs } from "memfs";

export default fs;
3 changes: 0 additions & 3 deletions __mocks__/fs/promises.js

This file was deleted.

3 changes: 3 additions & 0 deletions __mocks__/fs/promises.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
import { fs } from "memfs";

export default fs.promises;
77 changes: 74 additions & 3 deletions blog/01.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,78 @@
---
title: schnell Reich werden
title: HTWR goes (semi) legal
---

# So geht es...
# HTWR goes (semi) legal

Also...
HTWR ist eine Grauzone (sehr dunkel grau :/) mit Folien, (keine Klausuren natürlich 🫣)...
Was wir/(ich mach die Webseite immernoch größtenteils alleine :/) in Zukunft machen ist unten beschrieben.

Aber erstmal ein kleiner Rant

## **Das sollte nicht so sein**

> Ich finde es einfach unfair Altklausuren als Lehrstuhl nicht zu veröffentlich, obwohl es praktisch ist Aufgaben zu wiederholen. Warum?
Es ist so, dass Altklausuren (selbst Gedächtnissprotokollen) eine erhebliche Hilfe und schlichtweg die beste Klausurvorbereitungen sind **Punkt**.
Ich glaube den Fakt zweifelt niemand an.

Auch das immer Altklausuren gesammelt und verteilt werden lässt sich nicht ganz verhindern.
Studierenden in Gruppen mit vielen Kontakten z.B. in frühere Semester haben einfach schlicht einen Vorteil.

> PS. Das war auch schon in der Schule so. Ich würde gerne mal Wissen wie viel besser Leute mit älteren Brüdern und Schwerstern bei dem gleichen Lehrer oder Lehrerinn im Durchschnitt sind.
## Warum so wenige Klausuren?

Warum so wenige Klausuren von den Lehrstühlen veröffentlicht werden:
1. Natürlich sind Klausuren viel Arbeit und Aufgaben zu wiederholen, direkt oder in abgewandelter Form ist dann natürlich simpler.


2. Lernt den Inhalt nicht die Übung.
![Ja aber Nein](https://media.tenor.com/CnV-C65z7iMAAAAi/theoretically-no.gif)

Das Problem an dem Argument:

_Learning by Doing_.

Außerdem in der Klausur wird ja auch nicht das pure Wissen an sich abgefragt, sondern in einer bestimmten Form (anhand der Übungen, Schemaaufgaben, etc.).
Es ergibt also schon Sinn diese zu Lernen um eine gute Klausur zu schreiben.

Niemand kann 1850 Seiten MaLe Folien auswendig und kann danach den InductiveMiner perfekt anwenden.
Hierfür braucht es Übung und eine Aufgabe auf dem Übungsblatt ohne Trickfragen reicht halt meistens nicht aus.

## Fachschaft!

Grundsätzlich sollte sich die Fachschaft drum kümmern ein faireren Umgang mit Altklausuren zu ermöglichen.
Sie können keinen Lehrstuhl zwingen, aber wenigstens als Represent der Studierendenschaft (auch der weniger Vernetzten)
die Lehrstühle nerven.

## Was machen wir jetzt

Ich habe keine Lust mehr im Impressum einer ähmm _kritischen_ Webseite zu stehen. Ich möchte legal, oder zumindest grauzonen legal werden.

> Noch habe ich keine Unterlassungserklärung bekommen, aber das soll so bleiben. Ich habe aktuell nur den Vorteil nicht kommerziell zu arbeiten (das soll auch so bleiben).
> Ich habe deswegen bereits die Klausurserver momentan abgeschaltet
Ich werde ein HTWR-Gedächtnissprotokolltemplate (`typst`, `latex`, `docx`, `odt`) erstellen. Das sollte gut genug aussehen, aber die genauen Formate der Klausuren sind ja eh egal
(das `typst` template ist bereits fast fertig im [exams repo](https://github.com/htwr-aachen/exams)).

Dann wird systematisch jede Klausur / ob schlechtes Gedächtnissprotokoll oder echte Altklausur in dieses Format übertragen und *variert*.
Wir werden nicht blank abkopieren, aber die Zahlen sollen weiterhin stimmen.

Das ist mehr Aufwand. Aber es wird sich lohnen. Nicht für umbedingt uns aber für spätere.


## *BITTE HELFT Mir*

Fragt gerne bei [[email protected]](mailto:[email protected])
nach. Ich sage euch, dann was und wie ihr mithelfen könnt.

Zum Beispiel einfach loslegen eine Klausur / oder ein neue Klausuren protokollieren.

## Apropro
Gleichzeitig zu diesem Blog, werde ich die erste so richtige Dokumentation von HTWR anfangen.

Ich werde vieles auf der Webseite ein bisschen umstrukturieren und neu designen.
Neue Features sind *immer* willkommen, Memepages, Stickersammlung, Catbots, etc...

Ihr müsst nur ein bisschen Mut mitbringen um neue Dinge (React, Typescript) zu lernen.
78 changes: 0 additions & 78 deletions blog/02.mdx

This file was deleted.

4 changes: 2 additions & 2 deletions cypress.config.js → cypress.config.mjs
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
/* eslint-disable import/no-extraneous-dependencies */
const { defineConfig } = require("cypress");
import { defineConfig } from "cypress";

module.exports = defineConfig({
export default defineConfig({
e2e: {
baseUrl: "http://localhost:3000",
},
Expand Down
19 changes: 14 additions & 5 deletions cypress/tsconfig.json
Original file line number Diff line number Diff line change
@@ -1,12 +1,21 @@
{
"extends": "../tsconfig.json",
"compilerOptions": {
"target": "es5",
"lib": ["es5", "dom"],
"types": ["node", "cypress", "@percy/cypress", "@testing-library/cypress"],

"target": "ES2022",
"lib": [
"ES2022",
"dom"
],
"types": [
"node",
"cypress",
"@percy/cypress",
"@testing-library/cypress"
],
"isolatedModules": false
},
"include": ["**/*.ts"],
"include": [
"**/*.ts"
],
"exclude": []
}
2 changes: 2 additions & 0 deletions docs/backend.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,5 @@ title: Backend Docs
---

# Gedult...

Ich versuche mich zu beeilen
159 changes: 19 additions & 140 deletions docs/exams.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,151 +4,30 @@ authors: ["Jonas Schneider"]
tag: ["exams"]
---

# Hierbei brauche ich definitiv Hilfe.
# Profs hassen diesen simplen Trick

Was muss gemacht werden?
Wie im Blog beschrieben, wurde es mir ein bisschen zu aufregend klare Urheberrechtsverstöße zu veröffentlichen.
Deshalb gibt es den simplen Trick _Prüfungsprotokolle_ zu erstellen. Ich meine ihr habt das _Recht_ eure Klausuren zu photographieren.
Wenn ihr euch dann von den Aufgabentype inspirieren lässt ist es eine eigene Leistung und somit deutlich komplizierter für die Rechtsabteilung.

- Systematische protokollierung neuer/(alter) Klausuren
- Upload service für neue Protokolle
- Latex Template für Protokolle
- ✅ Typst Template für Protokolle
Es gilt die Richtige Antwort auf die Antwort, ist objektiv und somit nicht wirklich geschützt ($2 \mod 2= 0$ ist nicht geschützt), die falschen [kreativen] Antworten allerdings schon. Somit muss eher bei den Falschen antworten aufgepasst werden.

<div className="inline">
Wie ihr helfen könnt hängt von euerer Motivation und Kenntniss stand ab. Neue
Protokolle erstellen, verläuft ähnlich zu neuen Panikzettel. Lest hierfür am
besten das README auf dem [Repository](https://github.com/htwr-aachen/exams).
Das Latex sollte sich stark/ganz an das Typst template halten. Beim Upload
backend können gerne Leute mit Motivation aufn bissle
</div>
## Wie helfe ich?

<svg
viewBox="-2.25 -11.450995445349342 50.845704678024305 83.0406802995173"
xmlns="http://www.w3.org/2000/svg"
width="30"
height="30"
className="inline"
>
<g transform="translate(8)">
<path
d="M.62 34.63c.09 1.89 2 1 2.83.42s1-.09 1.12-1.2a18.13 18.13 0 0 0 .09-2.18 5.35 5.35 0 0 0-3.57.91c-.52.38-1.49 1.58-.48 2"
fill="#f6d2a2"
/>
<path
d="M1.6 36a1.2 1.2 0 0 1-.54-.12 1.24 1.24 0 0 1-.62-1.1.82.82 0 0 1-.45-.65 2.3 2.3 0 0 1 1-1.66 5.5 5.5 0 0 1 3.69-.94h.15v.15a13 13 0 0 1-.05 1.71v.5c-.05.78-.2.9-.6 1a2.23 2.23 0 0 0-.6.29A4.09 4.09 0 0 1 1.6 36zm2.54-4.13a5 5 0 0 0-2.94.9 2 2 0 0 0-.84 1.34.5.5 0 0 0 .34.41h.1v.11a1 1 0 0 0 .42.9 2.62 2.62 0 0 0 2.13-.62 2.58 2.58 0 0 1 .68-.34c.26-.09.32-.11.36-.73v-.5a14 14 0 0 0 .06-1.5h-.31z"
fill="#010101"
/>
<path d="M.62 34.63a1.49 1.49 0 0 0 .75-.42" fill="#c7b199" />
<path
d="M.62 34.81a.183.183 0 0 1-.11-.35h.12a1.08 1.08 0 0 0 .55-.32.182.182 0 1 1 .29.22 1.4 1.4 0 0 1-.72.44H.62z"
fill="#010101"
/>
<path d="M4.98 12.14c-7.23-2-1.85-11.23 4-7.45z" fill="#74cddd" />
<path
d="M5.07 12.35h-.14c-2.06-.58-3.33-1.8-3.57-3.43A4.79 4.79 0 0 1 3.59 4.4a4.84 4.84 0 0 1 5.44.18l.14.09zm1-8.38a4.23 4.23 0 0 0-2.31.69 4.42 4.42 0 0 0-2.07 4.17c.22 1.45 1.34 2.55 3.17 3.1l3.8-7.17A5 5 0 0 0 6.1 4z"
fill="#010101"
/>
<path d="M37.1 4c5.72-4 10.89 5 4.24 7.33z" fill="#74cddd" />
<path
d="M41.26 11.55l-4.4-7.6.13-.09a4.72 4.72 0 0 1 5.25-.44 4.85 4.85 0 0 1 2.39 4.48c-.1 1-.64 2.71-3.23 3.6zm-3.92-7.5l4.08 7.06a3.91 3.91 0 0 0 2.85-3.24 4.48 4.48 0 0 0-2.21-4.15 4.25 4.25 0 0 0-4.72.33z"
fill="#010101"
/>
<path
d="M38.33 57.87c1.45.9 4.11 3.62 1.93 4.94-2.09 1.92-3.27-2.11-5.11-2.66a5.09 5.09 0 0 1 3.18-2.28z"
fill="#f6d2a2"
/>
<path
d="M39.15 63.5h-.08c-.83-.05-1.51-.86-2.17-1.63a4.66 4.66 0 0 0-1.8-1.55l-.24-.07.15-.25a5.31 5.31 0 0 1 3.29-2.35h.13c.93.58 2.85 2.26 2.84 3.78a1.67 1.67 0 0 1-.9 1.45 1.81 1.81 0 0 1-1.22.62zm-3.72-3.44a5.73 5.73 0 0 1 1.73 1.57 3.49 3.49 0 0 0 1.92 1.51 1.43 1.43 0 0 0 1-.47 1.32 1.32 0 0 0 .74-1.16c0-1.22-1.54-2.75-2.61-3.44a4.7 4.7 0 0 0-2.77 1.99z"
fill="#010101"
/>
<path
d="M40.26 63a.18.18 0 0 1-.16-.1 6.67 6.67 0 0 1-.28-.68 3 3 0 0 0-.66-1.22.18.18 0 1 1 .25-.26 3.31 3.31 0 0 1 .74 1.32 6.41 6.41 0 0 0 .27.64.18.18 0 0 1-.08.24z"
fill="#010101"
/>
<path
d="M12.36 60.94c-1.71.26-2.67 1.8-4.09 2.58a1.24 1.24 0 0 1-2-.47.65.65 0 0 1-.52-.24c-1.24-2 1.29-3.39 2.62-4.37 1.87-.36 3.02 1.23 3.99 2.5z"
fill="#f6d2a2"
/>
<path
d="M7.37 64a1.22 1.22 0 0 1-.32 0 1.48 1.48 0 0 1-.87-.75.6.6 0 0 1-.49-.26c-1.2-1.89.84-3.32 2.19-4.27l.47-.34c1.89-.38 3.09 1.18 4.05 2.44l.27.36h-.3a5.17 5.17 0 0 0-2.53 1.45 9.19 9.19 0 0 1-1.5 1.12 2 2 0 0 1-.97.25zm-1.2-1.16a.49.49 0 0 1 .21 0h.05l.08.16a1.16 1.16 0 0 0 .67.61 1.37 1.37 0 0 0 1-.24 8.93 8.93 0 0 0 1.45-1.08 6 6 0 0 1 2.41-1.47c-.92-1.2-2-2.5-3.57-2.2l-.45.32c-1.38 1-3.09 2.18-2.1 3.77a.29.29 0 0 0 .21.14z"
fill="#010101"
/>
<path
d="M6.3 63.24a.18.18 0 0 1-.18-.24 2.74 2.74 0 0 1 .58-1.31 4.22 4.22 0 0 0 .38-.63.181.181 0 0 1 .33.15 4.56 4.56 0 0 1-.41.69 2.43 2.43 0 0 0-.49 1.17.18.18 0 0 1-.21.17zM5.28 9.6c-1-.5-1.65-1.19-1.07-2.29s1.54-.91 2.5-.41zM39.83 8.64c1-.5 1.65-1.19 1.07-2.29s-1.54-.91-2.5-.41z"
fill="#010101"
/>
<path
d="M46.4 34.39c-.09 1.89-2 1-2.83.42s-1-.09-1.12-1.2a18.13 18.13 0 0 1-.09-2.18 5.35 5.35 0 0 1 3.57.91c.52.38 1.49 1.58.48 2"
fill="#f6d2a2"
/>
<path
d="M45.42 35.72a4.09 4.09 0 0 1-1.91-.72 2.23 2.23 0 0 0-.6-.29c-.4-.14-.55-.26-.6-1v-.5a13 13 0 0 1-.05-1.71v-.24h.15a5.5 5.5 0 0 1 3.69.94 2.3 2.3 0 0 1 1 1.66.82.82 0 0 1-.45.65 1.24 1.24 0 0 1-.62 1.1 1.21 1.21 0 0 1-.61.11zm-2.91-4.12a14.05 14.05 0 0 0 .06 1.5v.5c0 .61.09.63.36.73a2.58 2.58 0 0 1 .68.34 2.61 2.61 0 0 0 2.13.62 1 1 0 0 0 .42-.9v-.12h.1a.5.5 0 0 0 .34-.41 2 2 0 0 0-.84-1.34 5.1 5.1 0 0 0-3.25-.92z"
fill="#010101"
/>
<path d="M46.4 34.39a1.49 1.49 0 0 1-.75-.39" fill="#c7b199" />
<path
d="M46.4 34.57h-.19a1.4 1.4 0 0 1-.7-.5.182.182 0 1 1 .29-.22 1.08 1.08 0 0 0 .55.32h.12a.203.203 0 0 1-.07.4z"
fill="#010101"
/>
<path
d="M22.79.18c7.24 0 14 1 17.56 8 3.17 7.79 2 16.2 2.53 24.43.42 7.07 1.34 15.24-1.94 21.8-3.43 6.88-12.09 8.59-19.19 8.36-5.58-.2-12.32-2-15.47-7.12-3.7-6-1.95-14.88-1.68-21.53.32-7.88-2.14-15.79.45-23.51C7.74 2.61 14.98.8 22.78.18"
fill="#74cddd"
/>
<path
d="M22.98 63h-1.24a26.39 26.39 0 0 1-8.71-1.74 13.93 13.93 0 0 1-6.91-5.47c-3-4.84-2.46-11.52-2-17.42.12-1.48.23-2.89.28-4.21a67.83 67.83 0 0 0-.36-8.38c-.42-5-.86-10.17.82-15.18a13.28 13.28 0 0 1 7-8.09c2.7-1.32 6-2.08 10.85-2.46C29.85 0 36.89 1 40.51 8.09c2.32 5.7 2.35 11.82 2.39 17.74 0 2.22 0 4.51.16 6.75 0 .68.08 1.37.13 2.06.42 6.49.9 13.86-2.09 19.82C37.36 61.92 27.96 63 22.98 63zM22.79.36C15.26 1 7.92 2.62 5.22 10.67c-1.66 4.94-1.22 10.07-.81 15a68.09 68.09 0 0 1 .36 8.42c-.05 1.33-.17 2.74-.28 4.23-.46 5.84-1 12.47 1.93 17.2 1.23 2 5.19 6.67 15.33 7 4.39.16 15-.34 19-8.28 2.94-5.88 2.47-13.19 2.05-19.64 0-.7-.09-1.39-.13-2.06-.11-2.18-.16-4.48-.16-6.7 0-5.88-.06-12-2.36-17.6a12.87 12.87 0 0 0-7.29-6.51A29.9 29.9 0 0 0 22.79.36z"
fill="#010101"
/>
<path
d="M24.06 9.89c1.3 7.55 13.64 5.56 11.87-2.06C34.34 1 23.63 2.89 24.06 9.89"
fill="#fff"
/>
<path
d="M29.93 14.82a6.91 6.91 0 0 1-2.26-.37 5.59 5.59 0 0 1-3.78-4.53 5.76 5.76 0 0 1 1.56-4.44 6.81 6.81 0 0 1 4-2 6.4 6.4 0 0 1 4.06.7 5.45 5.45 0 0 1 2.59 3.61 5.28 5.28 0 0 1-1.54 5.36 7 7 0 0 1-4.63 1.67zm-5.69-4.95a5.25 5.25 0 0 0 3.55 4.25 6.83 6.83 0 0 0 6.55-1.24 5 5 0 0 0 1.43-5 5.34 5.34 0 0 0-6.26-4.06 5.77 5.77 0 0 0-5.27 6.05z"
fill="#010101"
/>
<path
d="M9.31 11.12c1.68 6.57 12.2 4.88 11.81-1.71C20.65 1.51 7.7 3 9.31 11.12"
fill="#fff"
/>
<path
d="M14.93 15.45a6.46 6.46 0 0 1-3.07-.75 5.45 5.45 0 0 1-2.71-3.55 5.51 5.51 0 0 1 1.88-5.65 7.1 7.1 0 0 1 7.06-.9 5.34 5.34 0 0 1 3.2 4.8c.21 3.5-2.57 5.54-5.23 6a7.31 7.31 0 0 1-1.13.05zm-5.42-4.37a5.46 5.46 0 0 0 6.53 4c2.52-.4 5.15-2.32 4.95-5.61a5 5 0 0 0-3-4.52 6.75 6.75 0 0 0-6.71.86 5.19 5.19 0 0 0-1.77 5.27z"
fill="#010101"
/>
<path
d="M25.51 19a17 17 0 0 1 0 3.13 2 2 0 0 1-1.17.72 1.72 1.72 0 0 1-1.31-1 22.22 22.22 0 0 1 .09-3.54z"
fill="#fff"
/>
<path
d="M24.45 23h-.05a1.89 1.89 0 0 1-1.45-1.13 11.88 11.88 0 0 1 0-2.43c0-.37.06-.76.07-1.14V18l2.7.83V19c0 .32 0 .66.05 1a8.57 8.57 0 0 1 0 2.15v.05a1.5 1.5 0 0 1-.95.68l-.31.12zm-1.16-1.26a1.53 1.53 0 0 0 1.12.89l.28-.11a1.2 1.2 0 0 0 .73-.52 8.43 8.43 0 0 0 0-2c0-.31 0-.61-.05-.91l-2-.61c0 .31 0 .62-.06.92a11.54 11.54 0 0 0-.03 2.33z"
fill="#010101"
/>
<ellipse cx="12.21" cy="10.04" fill="#010101" rx="1.78" ry="1.93" />
<ellipse cx="13.02" cy="10.48" fill="#fff" rx=".42" ry=".49" />
<ellipse cx="27.11" cy="9.56" fill="#010101" rx="1.75" ry="1.93" />
<ellipse cx="27.9" cy="10" fill="#fff" rx=".41" ry=".49" />
<path
d="M20.51 18.85c-.78 1.88.43 5.64 2.54 2.87a22.22 22.22 0 0 1 .09-3.54z"
fill="#fff"
/>
<path
d="M21.6 22.89a1 1 0 0 1-.52-.14c-.85-.49-1.38-2.5-.78-4v-.08l3-.76v.24c0 .39 0 .78-.07 1.15a11.43 11.43 0 0 0 0 2.36v.13a2.11 2.11 0 0 1-1.63 1.1zM20.61 19c-.43 1.17-.09 3 .66 3.43.54.31 1.14-.23 1.56-.77a12.23 12.23 0 0 1 0-2.36c0-.29 0-.6.06-.9z"
fill="#010101"
/>
<path
d="M20.74 15.23a2.29 2.29 0 0 0-1.88 3.2c1 1.8 3.22-.16 4.6 0 1.59 0 2.9 1.68 4.18.3 1.42-1.54-.61-3-2.2-3.71z"
fill="#f6d2a2"
/>
<path
d="M26.51 19.49a4 4 0 0 1-1.46-.41 4.41 4.41 0 0 0-1.58-.44 4 4 0 0 0-1.66.36c-1.12.39-2.39.83-3.11-.46a2.16 2.16 0 0 1 0-2.1 2.56 2.56 0 0 1 2-1.37l4.81-.21c1.18.5 2.53 1.41 2.76 2.47a1.91 1.91 0 0 1-1.76 2.16zm-3-1.21a4.7 4.7 0 0 1 1.7.47c.9.38 1.61.67 2.33-.11a1.33 1.33 0 0 0 .41-1.21c-.2-.92-1.47-1.76-2.51-2.2l-4.65.19a2.22 2.22 0 0 0-1.7 1.18 1.81 1.81 0 0 0 0 1.75c.57 1 1.59.67 2.68.3a4.24 4.24 0 0 1 1.74-.37z"
fill="#231f20"
/>
<path
d="M20.51 15.16c-.11-2.5 4.67-2.82 5.23-.72s-5 2.58-5.23.72z"
fill="#010101"
/>
</g>
</svg>
<div className="inline">`golang` Spaß mitmachen.</div>
Zunächst gucke auf [das Klausurrepo](https://github.com/htwr-aachen/exams). Gucke ob du ein Fach findest, zu welchem es wenige Altklausuren (im Umlauf) und noch keine Protokolle gibt.

Ihr könnt sonst auch auf die Issues schauen und z.B. Issues mit `good first issue` abarbeiten.

Das sind im Moment noch ziemlich viele.

## Ich bin LaTex Genie

Dann darfst du gerne das Typst template auf Latex übersetzten.
Es sollte gut und vor allem _einfach_ zu benutzten sein.

## Ich möchte Programmieren

Du kannst mir helfen ein Update service zu schreiben, wo automatisch Klausuren hochgeladen werden können. Dies kann in Verbindung mit einem Editor sein für eine einfach Protokollierung.
Für alles einfach

- entweder selbständig anfangen
Expand Down
Loading

0 comments on commit e1261b6

Please sign in to comment.