Verhindern, dass Lernmaterialien veraltet sind

Kurz zur Situation an den Universitäten (persönliche Erfahrung)

Zunächst ist festzuhalten, dass das präsentierte Material sozusagen subjektiv ist, „ein Blick von innen“, aber die Informationen scheinen für viele staatliche Universitäten im postsowjetischen Raum relevant zu sein.

Aufgrund des Bedarfs an IT-Fachkräften haben viele Bildungseinrichtungen entsprechende Ausbildungsbereiche eröffnet. Darüber hinaus haben selbst Studierende nicht-informatischer Fachrichtungen viele IT-bezogene Fächer erhalten, häufig Python und R, während weniger glückliche Studierende „verstaubte“ akademische Sprachen wie Pascal beherrschen müssen.

Wenn man genauer hinschaut, ist nicht alles so einfach. Nicht alle Lehrer halten mit den „Trends“ Schritt. Persönlich war ich während meines Studiums der Fachrichtung „Programmierung“ mit der Tatsache konfrontiert, dass einige Lehrer nicht über aktuelle Vorlesungsunterlagen verfügen. Genauer gesagt schickte der Lehrer dem Schulleiter ein Foto mit handschriftlichen Notizen eines Schülers auf einen USB-Stick. Über die Relevanz solcher Materialien wie Handbücher zur WEB-Programmierung (2010) schweige ich völlig. Es bleibt auch zu erraten, was in technischen Schulen passiert und das Schlimmste vom Schlimmsten Bildungsinstitutionen.

Zusammengefasst:

• Sie drucken viele irrelevante Informationen aus, um quantitative akademische Indikatoren zu ermitteln.
• Die Veröffentlichung neuer Materialien erfolgt unorganisiert;
• „Trendige“ und aktuelle Details werden oft aus schlichter Unwissenheit übersehen;
• Eine Rückmeldung an den Autor ist schwierig;
• Aktualisierte Ausgaben erscheinen selten und unregelmäßig.

„Wenn Sie nicht einverstanden sind, kritisieren Sie, wenn Sie kritisieren, schlagen Sie vor ...“

Das erste, was mir in den Sinn kommt, ist die Implementierung motorbasierter Systeme Medien-Wiki. Ja, ja, jeder hat von Wikipedia gehört, aber sie hat einen enzyklopädischen Referenzcharakter. Wir sind mehr an Lehrmaterialien interessiert. Wikibooks passt besser zu uns. Zu den Nachteilen zählen:

• verpflichtende Offenheit aller Materialien (Zitat: „Hier im Wiki-Umfeld wird pädagogische Literatur gemeinsam geschrieben, frei verteilt und für alle zugänglich.“)
• das Vorhandensein einer gewissen Abhängigkeit von den Regeln der Website, der internen Hierarchie der Benutzer
  Es gibt viele Wiki-Engines im öffentlichen Bereich, aber ich denke, dass es nicht nötig ist, überhaupt über die Möglichkeit der Einführung eines Wiki-Systems im universitären Maßstab zu sprechen. Aus Erfahrung kann ich sagen, dass: a) solche selbstgehosteten Lösungen unter Fehlertoleranz leiden; b) Sie können Systemaktualisierungen vergessen (mit sehr seltenen Ausnahmen).

Lange Zeit habe ich vergeblich darüber nachgedacht, wie ich die Situation verbessern könnte. Und dann erzählte mir eines Tages ein Bekannter, dass er vor langer Zeit den Entwurf eines Buches auf A4 gedruckt habe, die elektronische Version aber verloren gegangen sei. Mich interessierte, wie man das alles in elektronische Form umwandeln kann.

Dies war ein Lehrbuch mit einer beträchtlichen Menge an Formeln und Grafiken, sodass beliebte OCR-Tools, z. B. abbyy Feinschreiber, nur die Hälfte hat geholfen. Finereader erzeugte Klartextstücke, die wir in normale Textdateien eintrugen, sie in Kapitel unterteilten und alles in MarkDown markierten. Offensichtlich gebraucht git für eine einfachere Zusammenarbeit. Als Remote-Repository haben wir verwendet Bit BucketDer Grund war die Möglichkeit, private Repositories mit einem kostenlosen Tarifplan zu erstellen (dies gilt auch für Gitlab). Gefunden für Formeleinfügungen Mathpix. Zu diesem Zeitpunkt wandten wir uns schließlich „MarkDown + LaTeX“ zu, da die Formeln in konvertiert wurden Latex. Zum Konvertieren in PDF haben wir verwendet Pandak.

Mit der Zeit reichte ein einfacher Texteditor nicht mehr aus und ich begann, nach einem Ersatz zu suchen. Ich habe es versucht Typora und mehrere andere ähnliche Programme. Als Ergebnis kamen wir zu einer Weblösung und begannen mit deren Nutzung gestapeltAlles, was Sie brauchten, war da, von der Synchronisierung mit Github bis hin zur LaTeX-Unterstützung und Kommentaren.

Genauer gesagt wurde als Ergebnis ein einfaches Skript geschrieben, für das ich mich schäme, das die Aufgabe übernahm, den eingegebenen Text zusammenzustellen und in WEB zu konvertieren. Hierfür reichte eine einfache HTML-Vorlage aus.
Hier sind die Befehle zum Konvertieren in WEB:

find ./src -mindepth 1 -maxdepth 1 -exec cp -r -t ./dist {} +
find ./dist -iname "*.md" -type f -exec sh -c 'pandoc "
find ./src -mindepth 1 -maxdepth 1 -exec cp -r -t ./dist {} +
find ./dist -iname "*.md" -type f -exec sh -c 'pandoc "${0}" -s --katex -o "${0::-3}.html"  --template ./temp/template.html --toc --toc-depth 2 --highlight-style=kate --mathjax=https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML' {} ;
find ./dist -name "*.md" -type f -exec rm -f {} ;
" -s --katex -o "${0::-3}.html"  --template ./temp/template.html --toc --toc-depth 2 --highlight-style=kate --mathjax=https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML' {} ;
find ./dist -name "*.md" -type f -exec rm -f {} ;

Soweit man sehen kann, macht es nichts Intelligentes: Es sammelt Inhaltsüberschriften für eine einfache Navigation und konvertiert LaTeX.

Im Moment gibt es eine Idee, den Build zu automatisieren, wenn Pushs an Vertreter auf Github durchgeführt werden, und zwar mithilfe von Continuous Integration-Diensten (Circle CI, Travis CI …).

Nichts ist neu...

Da ich mich für diese Idee interessierte, begann ich herauszufinden, wie beliebt sie mittlerweile ist.
Es war offensichtlich, dass diese Idee für die Softwaredokumentation nicht neu ist. Ich habe einige Beispiele für Lehrmaterialien für Programmierer gesehen, zum Beispiel: JS-Kurse learn.javascript.ru. Ich war auch an der Idee einer Git-basierten Wiki-Engine namens interessiert Gollum

Ich habe einige Repositories mit vollständig in LaTeX geschriebenen Büchern gesehen.

Abschluss

Viele Schüler schreiben Notizen, die sie schon viele, viele Male zuvor geschrieben haben, mehrmals um (ich bezweifle nicht den Vorteil des Schreibens von Hand). Jedes Mal, wenn die Informationen verloren gehen und sehr langsam aktualisiert werden, sind, wie wir wissen, nicht alle Notizen vorhanden elektronisches Formular. Daher wäre es cool, die Notizen auf Github hochzuladen (in PDF konvertieren, Webansicht) und den Lehrern anzubieten, dasselbe zu tun. Dies würde Schüler und Lehrer bis zu einem gewissen Grad für die „lebende“, wettbewerbsorientierte GitHub-Community gewinnen, ganz zu schweigen von der Erhöhung der aufgenommenen Informationsmenge.

Beispielsweise Ich hinterlasse einen Link zum ersten Kapitel des Buches, über das ich gesprochen habe. da ist sie und hier ist der Link dazu Rap.

Source: habr.com