Zabránění zastarávání učebních materiálů

Stručně o situaci na vysokých školách (osobní zkušenost)

Pro začátek stojí za to uvést, že prezentovaný materiál je subjektivní, takříkajíc „pohled zevnitř“, ale zdá se, že informace jsou relevantní pro mnoho státních univerzit v postsovětském prostoru.

Vzhledem k poptávce po IT specialistech otevřelo mnoho vzdělávacích institucí příslušné vzdělávací oblasti. Navíc i studenti jiných než IT specializací získali mnoho předmětů souvisejících s IT, často Python, R, zatímco méně šťastní studenti musí ovládat „zaprášené“ akademické jazyky jako Pascal.

Pokud se podíváte hlouběji, vše není tak jednoduché. Ne všichni učitelé drží krok s „trendy“. Osobně jsem se při studiu „programátorské“ specializace potýkal s tím, že někteří učitelé nemají aktuální poznámky z přednášek. Přesněji řečeno, učitel poslal řediteli na flash disk fotografii poznámek, které ručně napsal nějaký student. Zcela mlčím o relevanci takových materiálů, jako jsou manuály k programování WEB (2010). Zbývá také hádat, co se děje na technických školách a nejhorší z nejhorších vzdělávací instituce.

V souhrnu:

• Tisknou mnoho irelevantních informací ve snaze získat kvantitativní akademické ukazatele;
• Uvolňování nových materiálů je neorganizované;
• „Trendy“ a aktuální detaily často chybí kvůli prosté neznalosti;
• Zpětná vazba k autorovi je obtížná;
• Aktualizovaná vydání vycházejí zřídka a nepravidelně.

"Pokud nesouhlasíte, kritizujte, pokud kritizujete, navrhněte..."

První věc, která vás napadne, je implementace systémů založených na motorech Mediální wiki. Ano, ano, každý slyšel o Wikipedii, ale má encyklopedickou povahu. Více nás zajímají vzdělávací materiály. Wikiknihy nám lépe vyhovuje. Mezi nevýhody patří:

• povinná otevřenost všech materiálů (citát: „Zde v prostředí wiki se společně píše výuková literatura, šíří se volně a je přístupná všem.“)
• přítomnost určité závislosti na pravidlech webu, vnitřní hierarchii uživatelů
  Ve veřejné doméně se pohybuje mnoho wiki engine, ale myslím, že o možnosti nasazení wiki systému v univerzitním měřítku není třeba ani začít mluvit. Ze zkušenosti řeknu, že: a) taková řešení s vlastním hostitelem trpí odolností proti chybám; b) na aktualizace systému můžete zapomenout (až na velmi vzácné výjimky).

Dlouho jsem marně přemýšlel, jak situaci zlepšit. A pak jednoho dne jeden známý řekl, že kdysi dávno vytiskl koncept knihy na A4, ale ztratil elektronickou verzi. Zajímalo mě, jak to celé převést do elektronické podoby.

Jednalo se o učebnici se značným množstvím vzorců a grafů, tak oblíbené OCR nástroje, kupř. abbyy finereader, pomohla jen polovina. Finereader produkoval kusy prostého textu, které jsme začali vkládat do běžných textových souborů, rozdělovat je do kapitol a označovat vše v MarkDown. Evidentně použité git pro usnadnění spolupráce. Jako vzdálené úložiště jsme použili BitBucket, důvodem byla možnost vytvářet soukromá úložiště s bezplatným tarifem (to platí i pro GitLab). Nalezeno pro vložky vzorců Mathpix. V této fázi jsme se konečně obrátili na „MarkDown + LaTeX“, protože vzorce byly převedeny na Latex. Pro převod do pdf jsme použili Pandoc.

Postupem času mi jednoduchý textový editor přestal stačit, a tak jsem začal hledat náhradu. Zkusil jsem to Typora a několik dalších podobných programů. Výsledkem bylo, že jsme došli k webovému řešení a začali jej používat stohovat, bylo tam vše, co jste potřebovali, od synchronizace s githubem po podporu LaTeXu a komentáře.

Abych byl konkrétní, ve výsledku vznikl jednoduchý skript, za který se stydím, který plnil úkol sestavit a převést napsaný text do WEBu. K tomu stačila jednoduchá HTML šablona.
Zde jsou příkazy pro převod na 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 {} ;

Nedělá nic chytrého, z toho, co lze poznamenat: shromažďuje záhlaví obsahu pro snadnou navigaci a převádí LaTeX.

V tuto chvíli existuje myšlenka automatizovat sestavení při provádění push na zástupce na githubu pomocí služeb kontinuální integrace (Circle CI, Travis CI..)

Nic není nového...

Když jsem se o tuto myšlenku začal zajímat, začal jsem hledat, jak je nyní populární.
Bylo zřejmé, že tato myšlenka není pro softwarovou dokumentaci nová. Viděl jsem několik příkladů vzdělávacích materiálů pro programátory, například: kurzy JS learn.javascript.ru. Také mě zaujala myšlenka wiki enginu založeného na git tzv Gollum

Viděl jsem docela dost repozitářů s knihami napsanými výhradně v LaTeXu.

Výkon

Mnoho studentů několikrát přepisuje poznámky, které předtím psali mnohokrát (nezpochybňuji přínos ručního psaní), pokaždé se informace ztratí a aktualizují se velmi pomalu, ne všechny poznámky, jak chápeme, jsou v elektronické podobě. V důsledku toho by bylo skvělé nahrát poznámky na github (převést do pdf, webové zobrazení) a nabídnout učitelům, aby udělali totéž. To by do jisté míry přilákalo studenty a učitele do „živé“ konkurenční komunity GitHub, nemluvě o zvýšení množství absorbovaných informací.

Například Nechám odkaz na první kapitolu knihy, o které jsem mluvil, tady to je a zde je na něj odkaz rap.

Zdroj: www.habr.com