Replies: 4 comments 7 replies
-
|
Pro:
|
Beta Was this translation helpful? Give feedback.
-
|
True that 👍🏻 @andre-dietrich Ich glaube, am meisten "schreckt" mich die Konfiguration per HTML-Kommentar ab - da ich viel mit Pandoc arbeite, bin ich sehr an YAML-Header und Markdown-Divs gewöhnt. Aber letztlich kann ich per Pandoc-Filter daraus auch wieder die LiaScript-Kommentare erzeugen ... Ein weiteres Pro ist:
|
Beta Was this translation helpful? Give feedback.
-
|
Die LiaScript-Webseite läuft jetzt auch mit hugo ... wir haben versucht alle Informationen zu bündeln und dort zusammenzutrage ... eigentlich würde ich es nicht als alternative sehen. Hugo ist für Blogs und Webseiten ideal aber mit LiaScript lassen sich einfacher Lehrinhalte erstellen und aktualisieren ... so langsam findet man dazu auch mehr Projekte auf GitHub ... |
Beta Was this translation helpful? Give feedback.
-
Sehe ich ganz genau so. Hugo ist (nur) so lange gut, wie man die vorgegebenen Strukturen nutzen kann (und möchte). In meinem Fall möchte ich aber eine bestimmte Struktur in den Lehrmaterialien haben, die auch ungerendert halbwegs menschenles- und -navigierbar ist - und ab da ist Hugo ein riesiges PITA. Ich habe mir Skripte (Pandoc-Filter plus Makefile-Magie) gebastelt, die aus meiner Vorlesungsstruktur alles in die nötige Hugo-Struktur übersetzen, bevor Hugo das Vorlesungsskript generiert und ich das Ergebnis manuell im ILIAS "deploye". Gut, das passiert fast alles automatisiert in der CI, aber zerbrechlich ist das trotzdem (und der manuelle Deploy-Schritt nervt auf Dauer). Ich glaube, mein nächster Schritt geht in die Richtung, dass ich die Inhalte per CI so in einem Hilfsbranch im Repo vorbereite, dass man sich das direkt in der GitHub-Preview ansehen kann. Da fehlt freilich alles "Bling-Bling", Navigationsmenüs sind praktisch die Ordner selbst ... Zusätzlich könnte es einen zweiten Hilfbranch (ebenfalls mit CI erzeugt) geben, der das selbe Zeugs in einem LiaScript-tauglichen Format enthält und wo ich im ILIAS nur mit einem Link hinzeige. Damit hätte ich am wenigsten administrative Arbeit (kein Update mehr im ILIAS o.ä.), die Hilfsbranches sind per CI immer aktuell und die Studis hätten eine persistierte Ansicht auf ihrem Gerät. Ich muss nur noch rauskriegen, wie ich einige liebgewonnene Strukturen nach LiaScript "übersetze", und wie ich alle Unterseiten sinnvoll in eine einzige große Markdown-Datei zusammenfüge, damit die Studis nicht 30..40 einzelne kleine Einheiten im Browser haben, sondern nur noch eine für die gesamte Lehrveranstaltung. Da kommt einiges Zeugs zusammen (beispielsweise hier: https://www.hsbi.de/elearning/goto.php?target=crs_1302203&client_id=FH-Bielefeld). Weiss auch gar nicht, ob LiaScript das "gefällt" bzw. ob die Browser auch in einfachen Handys da noch mitmachen, das müsste ich erstmal testen :) ...
Ja, es scheint Fahrt aufzunehmen. Finde ich spitze :) Sogar die TIB hat ein Tutorial: How to create OER using GitHub mit LiaScript herausgebracht! 👍🏻 |
Beta Was this translation helpful? Give feedback.
-
|
Das größte Dokument bis jetzt ist die Dokumentation, sonst haben wir versucht ein paar OpenBooks auf nach LiaScript zu portieren https://github.com/LiaBooks/C-Programming Das Parsen sollte kein Problem sein, die Doku kann man sich auch auf einem Nokia ansehen. Wir nutzen hierfür zwei Stufen für das Parsen. Zuerst wird nur versucht, die Überschriften und die Inhalte zu identifizieren. Das ist auch was im Inhaltsverzeichnis dargestellt wird. Erst danach wird der Inhalt für die aktuelle Darstellung/Slide geparsed. So muss nicht das ganze Dokument analysiert werden, wenn man nur zwei Folien sehen will... Des Weiteren wird, wenn das Dokument Version 1.0.0 erreicht hat, direkt die schon geparste Struktur aus IndexedDB geholt. Beim laden wird nur verglichen, ob die Version, die aus dem Netz geladen wurde eine höhere Version hat, dann wird nochmal geparsed, sonst wird direkt geladen und angezeigt, dass sollte eigentlich sehr schnell gehen ... Der Vorteil, den ich bei dem Compilerbau-Kurs sehe, ist dass man die Beispiele Interaktiv gestalten könnte. Entweder nutzt man direkt JavaScript oder eine andere Sprache, die nach JavaScript portiert wurde oder PyScript oder unseren Coderunner ... Der Vorteil von LiaScript ist dann, dass die editierten Programme auch im Browser gespeichert sind offline funktionieren (nur wenn reines JavaScript genutzt wird, bei einem externen Service geht das nicht so, die Ergebnisse bleiben jedoch erhalten) ... Kein Build-step nötig ... |
Beta Was this translation helpful? Give feedback.
-
|
Was definitiv auch für LiaScript spricht, ist die Vielzahl an verfügbaren Quiztypen. Damit kann man das Umleiten auf die separaten Quizzes im LMS (hier ILIAS) verzichten und hat alles in einer Hand. (Für Hugo und/oder Docsify habe ich bisher nur eine einzige Alternative gesehen (https://github.com/bonartm/quizdown-js), aber das Projekt ist nicht ansatzweise so weit (nur Singe- und Multiple-Choice) und scheinbar auch nicht mehr aktiv.) |
Beta Was this translation helpful? Give feedback.
-
|
LiaScript geht davon aus, dass jede Markdown-Datei eine eigene Einheit ist, die aufgerufen und gerendert wird. Das passt nicht so richtig zu meinem normalen Workflow: Ich habe eine zentrale Markdown-Datei mit Links auf die einzelnen Sessions. Diese würde ich gern als LiaScript-Link bereit stellen. Wenn man dann auf die internen Links klickt, bekommt man aber nur die "raw" Markdown-Files angezeigt. Links im Hauptdokument als LiaScript-Links öffnen: https://github.com/orgs/LiaScript/discussions/193#discussioncomment-10648961
Edit: Abbildungen und Code in den im Hauptdokument referenzierten Dokumenten werden gerendert. Quizzes in den lokalen Dateien gehen auch 👌 Edit: Jeder angeklickte Link führt aber immer noch zu einer eigenständigen Web-App im Browser. Das ist bei den Mini-Einheiten immer noch recht unübersichtlich. 🤔 |
Beta Was this translation helpful? Give feedback.
-
|
Meinst du sowas? Ich habe noch ein target eingefügt, das sollte dafür sorgen, dass der Link im gleichen Fenster geöffnet wird: <!--
@open
<script modify="false" run-once>
const origin = window.location.origin;
const pathname = window.location.pathname;
`LIASCRIPT: [@0](${origin + pathname}?@1)<!-- target="_self" -->`
</script>
@end
-->
# Course Main Title
This is a link to the first lesson of the course:
@[open(Title of the course)](course/lesson_1.md)Im Grund könnte man auch einen HTML-Link einfügen, das wäre das selbe: <!--
@open
<script modify="false" run-once>
const origin = window.location.origin;
const pathname = window.location.pathname;
`HTML: <a href="${origin + pathname}?@1" target="_self">@0</a>`
</script>
@end
-->
# Course Main Title
This is a link to the first lesson of the course:
@[open(Title of the course)](course/lesson_1.md) |
Beta Was this translation helpful? Give feedback.
-
|
@andre-dietrich Nicht direkt - wenn Du auf "home" gehst, werden ja alle geöffneten und lokal gespeicherten "Books" einzeln angezeigt. Mit der obigen Konfiguration schaffe ich es, dass ich meine zentrale Startdatei als ein solches "Book" verteilen kann und dass die Studis in diesem Book auf die Links zu den einzelnen Lektionen klicken können und dass diese anständig gerendert werden. Aber wenn Du dann auf "home" gehst, taucht jede einzelne Lektion dort auf. Das ist einerseits sinnvoll, da die Dinger ja im Cache liegen und auch offline nutzbar sind, andererseits ist das recht schnell ziemlich nervig, weil ich pro Modul so ca. 20..30 solcher Einheiten habe und die alle einzeln dort unter "home" auftauchen würden - man findet dann nicht mal mehr das Hauptfile :) Edit: Es scheint, als ob die Aufteilung der Vorlesungsinhalte auf 20-Minuten-Häppchen sich nicht so gut für die Verwendung mit-in Lia-Script eignen würde. |
Beta Was this translation helpful? Give feedback.
-
|
Ich weiß nicht, ob das hilft, aber wenn man den HOME-Button weg haben möchte, so könnte man auch mit sowas tricksen: <!--
@onload
document.getElementsByClassName("lia-toc__bottom")[0].style.display = "none"
@end
-->
# Title
...Der Code sorgt einfach dafür, dass das Inhaltsverzeichnis unsichtbar wird .... |
Beta Was this translation helpful? Give feedback.
-
|
@andre-dietrich ich meinte eher das hier: 
Ich habe ein Hauptdokument, welches auf die einzelnen Lektionen verlinkt. Mit dem obigen Makro kann ich erreichen, dass ich nur das Hauptdokument als LiaScript-Link teilen muss, und die Studis können von dort aus die Lektionen erreichen. Das passt alles wunderbar. Wenn ich dann aber im Browser meine Sammlung an LiaScript-"Apps" betrachte, bekommt halt jede einzelne Lektion ihre eigene Web-App. Macht auch Sinn, dann kann ich sie offline anschauen. In meinem Szenario reden wir aber über 20..30 solcher Lektionen, d.h. die Übersicht im Browser ist nicht mehr übersichtlich und vermutlich auch nicht mehr benutzbar. Aus Studi-Sicht wäre es gut, wenn sich diese ganzen Einzellektionen hinter der Web-App für die Hauptseite "verstecken" würden ... |
Beta Was this translation helpful? Give feedback.
-
LiaScript ist ein interessantes Projekt. Die Unterlagen werden in einer Art proprietären Markdown-Dialekt formatiert und auf GH o.ä. bereitgestellt. Durch Voranstellen der URL
https://liascript.github.io/course/?vor die URL der Markdowndatei wird eine PWA beim Herunterladen erzeugt, die lokal gespeichert ist und auch offline angezeigt werden kann.Zusammen mit #160 und #82 könnte der Gesamtworkflow deutlich vereinfacht werden:
Wenn die Dateien 1:1 transformiert werden, wäre jede Sitzung eine eigene PWA. Das ist komfortabel, aber wird schnell unübersichtlich für die Studis. Wenn die Dateien in der passenden Reihenfolge in eine Gesamtdatei gemergt werden (mit der passenden internen Verlinkung), dann brauchen die Studis nur einmal die Gesamt-App.
Zusätzlich zu passenden Lua-Filtern wird noch ein Markdown-Template benötigt, welches die aktuell genutzten Hugo-Archetypen ersetzt (Aufbau/Gliederung der VL-Einheiten).
Potentielle Vorteile:
Potentielle Nachteile:
siehe auch LiaScript/LiaScript#154 (comment) und
Beta Was this translation helpful? Give feedback.
All reactions