Self-Assessment einrichten
So aktivierst du die Self-Assessment-Funktion, mit der Besucher:innen interaktive Bewertungsfragen auf deiner Webseite beantworten können.
Funktion aktivieren
Easy Mode
Setze den Parameter in der .gitlab-ci.yml:
Developer Mode
Übergib die --selfassessment-Flag an die CLI:
Fragen in Markdown einbetten
Füge Bewertungsfragen als speziellen Kommentarblock in deine Markdown-Dateien ein. Der Block wird in der Web-Ansicht nicht als Text angezeigt, sondern als interaktives Formular verarbeitet.
Formatregeln
| Element | Syntax | Beschreibung |
|---|---|---|
| Kommentarblock | <!---Self Assessment: ... ---> | Umschließt den gesamten Fragenblock |
| Hauptfrage | ###### Frage? [Tag] ###### | Überschrift der Bewertung |
| Unterfrage | ·1. Frage? [Tag] (1 Space Einrückung) | Erste Ebene |
| Detailfrage | ·····1. Frage? [Tag] (5+ Spaces Einrückung) | Zweite Ebene |
| Tag | [Kategorie] | Klassifizierung der Frage, kann leer sein [] |
Hinweis
Die Fragen werden als questions.json extrahiert und auf einer eigenen Self-Assessment-Seite als interaktives Formular gerendert.
Ergebnis
Nach dem Build erscheint eine neue Seite Self Assessment in der Navigation. Sie enthält die Fragen aus allen Markdown-Dateien als interaktives Bewertungsformular.