s n h m r u
i

Einbindung und Arbeitsweise

Mit dem Modul "Typst-Editor" werden Arbeitsblätter auf einer inf-schule-Seite zum Download angeboten. Die PDF-Datei wird dabei lokal im Browser erzeugt.

Das Modul einbinden

Damit der Editor beziehungsweise die Herunterladen-Funktion zur Verfügung steht, muss das Modul über den Meta-Tag features eingebunden werden (siehe auch Abschnitt "Javascript"):

Beispielquelltext für die Einbindung des Moduls über das Meta-Tag features

Das Modul verwenden

Die Verwendung wird über einen HTML-Tag gesteuert:

<div class='typsteditor'
data-config='{
    "filenameTypst":"AB-Codierung/ab.typ",
    "showEditor" : false,
    "buttonText" : "Codierungstabelle herunterladen",
    "relativeContentPath" : "AB-Codierung",
    "filenamePDF" : "Codierungstabelle.pdf"
}'></div>

Konfigurationsmöglichkeiten

Innerhalb des Attributs data-config können folgende Angaben gemacht werden, die Reihenfolge ist beliebig:

filenameTypst – Übergabe einer Datei

  • Datei, aus der der Quelltext des Materials geladen wird.

showEditor – Verwendung als Editor oder Herunterladen-Funktion

  • Bei true wird der vollständige Editor angezeigt. Das sollte nur während der Entwicklung des Materials geschehen und vor dem Commit wieder auf false gesetzt werden.
  • Bei false erscheint nur die Download-Bedienung: der Button zum Herunterladen, die Vorschau und gegebenenfalls die Musterlösung (siehe Abschnitt "Darstellung der Download-Bedienung").

buttonText – Beschriftung des Herunterladen-Buttons

filenamePDF – Dateiname des heruntergeladenen PDFs

  • Unter diesem Namen wird das über den Button erzeugte PDF gespeichert.
  • Sinnvollerweise identisch mit Pdffilename aus der arbeitsblatt.txt.

relativeContentPath – Ort verwendeter Dateien

  • Alle im Material verwendeten Dateien (Bilder, eingebundene Typst-Dateien) werden relativ zu diesem Pfad gesucht.
  • Hier steht der Arbeitsblatt-Ordner – siehe Abschnitt "Ordnerstruktur eines Arbeitsblatts".

wissensspeicherInfo – Informationstext über Wissensspeicher einblenden

  • Bei true erscheint unter dem Download-Button eine aufklappbare Box, die das Konzept der Wissensspeicher erläutert.

zeigeLoesungsButton – Musterlösung anbieten

  • Steuert, ob der Button für die Musterlösung angeboten wird. Ohne Angabe wird geprüft, ob eine Anmeldung vorliegt.

darstellung – Aussehen der Download-Bedienung

  • "leiste" (Standard, kann weggelassen werden) oder "karte". Siehe Abschnitt "Darstellung der Download-Bedienung".

vorschau – Vorschau abschalten

  • Bei false entfällt das Auge in der Leiste bzw. das Vorschaubild in der Karte. Nur nötig, wenn sich ein Blatt im Browser nicht als Vorschau darstellen lässt.

kartenTitel – Überschrift der Karte

  • Nur bei "darstellung" : "karte". Ohne Angabe wird der buttonText ohne das Wort "herunterladen" verwendet, aus "Wissensspeicher herunterladen" wird also "Wissensspeicher".

buttonTextKarte – Beschriftung des Download-Knopfs in der Karte

  • Nur bei "darstellung" : "karte". Standard ist "Herunterladen".

Darstellung der Download-Bedienung

Herunterladen, Vorschau und Musterlösung bilden einen gemeinsamen Baustein. Über darstellung wird eine von zwei Formen gewählt:

Wert Aussehen Geeignet für
"leiste" (Standard) Eine blaue Leiste: Button mit buttonText, daneben ein Auge für die Vorschau und – falls das Blatt Lösungen enthält – ein Symbol für die Musterlösung. Den Normalfall, auch mitten im Text und bei mehreren Blättern auf einer Seite.
"karte" Eine Karte mit kleinem Bild der ersten Seite, Titel, Angabe "PDF · n Seiten", Knopf "Herunterladen" und dem Symbol für die Musterlösung. Ein Blatt, das im Mittelpunkt der Seite steht, etwa das Arbeitsblatt am Ende einer Lernstrecke.
<div class='typsteditor'
data-config='{
    "filenameTypst":"AB-Codierung/ab.typ",
    "showEditor" : false,
    "buttonText" : "Codierungstabelle herunterladen",
    "relativeContentPath" : "AB-Codierung",
    "filenamePDF" : "Codierungstabelle.pdf",
    "darstellung" : "karte"
}'></div>

Die Vorschau öffnet sich mit einem Klick auf das Auge bzw. auf das Bild in der Karte. Sie zeigt die erste Seite in einem Fenster, aus dem heraus man das Blatt auch direkt herunterladen kann.

Die Vorschau wird wie das PDF im Browser erzeugt. Bei der Leiste geschieht das erst beim Klick auf das Auge. Die Karte erzeugt ihr Vorschaubild dagegen von selbst, sobald sie ins Bild gescrollt wird – das kostet einige Sekunden Rechenzeit, auf älteren Tablets spürbar. Deshalb höchstens eine Karte pro Seite verwenden und auf Seiten mit mehreren Blättern bei der Leiste bleiben.

Ordnerstruktur eines Arbeitsblatts

Alles, was zu einem Arbeitsblatt gehört, liegt in genau einem Ordner – die Typst-Datei, alle Bilder, eingebundene Teildateien und die arbeitsblatt.txt. Querverweise nach außen sind nicht erlaubt: kein .. in Pfaden, keine Bilder aus dem Nachbarordner.

Die Faustregel dahinter: Ein Arbeitsblatt-Ordner muss sich verschieben lassen, ohne dass das Blatt kaputtgeht. Wer unsicher ist, verschiebt den Ordner testweise an eine andere Stelle und kompiliert erneut – klappt das nicht, ist noch ein Querverweis drin.

Ein typischer Ordner sieht so aus:

1_meine-daten/               <- Seite der Lernstrecke
├── lernstrecke.txt
└── AB-Daten/                <- Arbeitsblatt-Ordner
    ├── arbeitsblatt.txt     <- macht den Ordner referenzierbar
    ├── ab.typ               <- die Quelldatei
    ├── mika-selfie.svg      <- alle Bilder liegen daneben
    └── tablet.svg

Das zahlt sich mehrfach aus: Der Ordner lässt sich in ein anderes Kapitel verschieben oder als Vorlage kopieren, ohne dass Pfade brechen. Und beim Umbenennen einer Lernstrecke muss niemand nach verwaisten Bildverweisen suchen.

Die Datei arbeitsblatt.txt

Liegt im Arbeitsblatt-Ordner eine arbeitsblatt.txt, wird der Ordner zu einer eigenen Seite. Damit lässt sich das Blatt über einen Permalink direkt ansprechen – unabhängig davon, wo im Seitenbaum es gerade steht:

@/arbeitsblatt/67tyrib0sep4ih9q

Der Aufruf lädt das PDF unmittelbar herunter. Für angemeldete Nutzer erscheint dort zusätzlich der Button für die Musterlösung.

Die Datei enthält drei Felder:

Title: Meine Daten gehören mir!</section>

Suche

v
17.6.3.9.1 Einbindung und Arbeitsweise
Kopieren durch Anklicken

Rückmeldung geben