Zabránenie zastaraniu učebných materiálov

Stručne o situácii na univerzitách (osobná skúsenosť)

Na začiatok stojí za to uviesť, že prezentovaný materiál je subjektívny, takpovediac „pohľad zvnútra“, no zdá sa, že informácie sú relevantné pre mnohé štátne univerzity v postsovietskom priestore.

Kvôli dopytu po IT špecialistoch mnohé vzdelávacie inštitúcie otvorili príslušné vzdelávacie oblasti. Navyše, dokonca aj študenti neinformačných špecialít dostali veľa predmetov súvisiacich s IT, často Python, R, zatiaľ čo menej šťastní študenti musia ovládať „zaprášené“ akademické jazyky ako Pascal.

Ak sa pozriete hlbšie, všetko nie je také jednoduché. Nie všetci učitelia držia krok s „trendami“. Osobne som sa pri štúdiu odboru „programovanie“ stretol s tým, že niektorí učitelia nemajú aktuálne poznámky z prednášok. Presnejšie povedané, učiteľ poslal riaditeľovi na flash disk fotografiu poznámok, ktoré vlastnoručne napísal nejaký študent. Úplne mlčím o relevantnosti materiálov, ako sú príručky o programovaní WEB (2010). Zostáva tiež hádať, čo sa deje na technických školách a najhorší z najhorších vzdelávacie inštitúcie.

V súhrne:

• Tlačia veľa irelevantných informácií v snahe získať kvantitatívne akademické ukazovatele;
• Uvoľňovanie nových materiálov je neorganizované;
• „Trendy“ a aktuálne detaily často chýbajú kvôli jednoduchej neznalosti;
• Spätná väzba k autorovi je ťažká;
• Aktualizované vydania vychádzajú zriedkavo a nepravidelne.

"Ak nesúhlasíte, kritizujte, ak kritizujete, navrhnite..."

Prvá vec, ktorá príde na myseľ, je implementácia systémov založených na motoroch Mediálna wiki. Áno, áno, každý počul o Wikipédii, ale má encyklopedický charakter. Viac nás zaujímajú vzdelávacie materiály. Wikiknihy nám to vyhovuje viac. Medzi nevýhody patrí:

• povinná otvorenosť všetkých materiálov (citát: „Tu v prostredí wiki sa vzdelávacia literatúra píše spoločne, šíri sa voľne a je prístupná každému.“)
• prítomnosť určitej závislosti od pravidiel stránky, vnútornej hierarchie používateľov
  Vo verejnej doméne pláva veľa wiki motorov, ale myslím si, že o možnosti nasadenia wiki systému v univerzitnom meradle nie je potrebné ani začať hovoriť. Zo skúsenosti poviem, že: a) takéto riešenia s vlastným hosťovaním trpia odolnosťou voči chybám; b) na aktualizácie systému môžete zabudnúť (až na veľmi zriedkavé výnimky).

Dlho som bezvýsledne rozmýšľal, ako situáciu zlepšiť. A potom jedného dňa jeden známy povedal, že už dávno vytlačil koncept knihy na A4, ale stratil elektronickú verziu. Zaujímalo ma, ako to celé previesť do elektronickej podoby.

Išlo o učebnicu so značným množstvom vzorcov a grafov, tak populárnych OCR nástrojov, napr. abbyy finereader, pomohla len polovica. Finereader vytvoril časti obyčajného textu, ktoré sme začali zadávať do bežných textových súborov, rozdeľovali sme ich do kapitol a všetko sme označovali v MarkDown. Očividne použité ísť pre uľahčenie spolupráce. Ako vzdialené úložisko sme použili bitbucket, dôvodom bola možnosť vytvárať súkromné ​​úložiská s bezplatným tarifným plánom (to platí aj pre GitLab). Nájdené pre vložky vzorcov Mathpix. V tejto fáze sme sa konečne obrátili na „MarkDown + LaTeX“, pretože vzorce boli prevedené na LaTeX. Na prevod do pdf sme použili Pandoc.

Postupom času mi jednoduchý textový editor nestačil, a tak som začal hľadať náhradu. Vyskúšali ste to Typora a niekoľko ďalších podobných programov. Výsledkom bolo, že sme dospeli k webovému riešeniu a začali ho používať zložené, bolo tam všetko, čo ste potrebovali, od synchronizácie s githubom až po podporu LaTeXu a komentáre.

Aby som bol konkrétny, vo výsledku bol napísaný jednoduchý skript, za ktorý sa hanbím, ktorý plnil úlohu zostaviť a previesť napísaný text na WEB. Na to stačila jednoduchá HTML šablóna.
Tu sú príkazy na konverziu 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 {} ;

Nerobí nič inteligentné, z toho, čo možno poznamenať: zhromažďuje hlavičky obsahu pre jednoduchú navigáciu a konvertuje LaTeX.

Momentálne existuje myšlienka automatizovať zostavovanie pri vytváraní tlačív na zástupcov na github pomocou služieb nepretržitej integrácie (Circle CI, Travis CI..)

Nič nie je nové...

Keď som sa o túto myšlienku začal zaujímať, začal som hľadať, aký je teraz populárny.
Bolo zrejmé, že táto myšlienka nie je nová pre softvérovú dokumentáciu. Videl som niekoľko príkladov vzdelávacích materiálov pre programátorov, napríklad: kurzy JS learn.javascript.ru. Tiež ma zaujala myšlienka wiki enginu na báze git tzv Glum

Videl som pomerne veľa repozitárov s knihami napísanými výlučne v LaTeXu.

Výkon

Mnoho študentov niekoľkokrát prepisuje poznámky, ktoré predtým písali veľa, veľakrát (nespochybňujem výhodu písania rukou), zakaždým sa informácie stratia a aktualizujú sa veľmi pomaly, nie všetky poznámky, ako chápeme, sú v elektronickej forme. V dôsledku toho by bolo skvelé nahrať poznámky na github (previesť do pdf, webové zobrazenie) a ponúknuť učiteľom, aby urobili to isté. To by do určitej miery prilákalo študentov a učiteľov do „živej“ konkurenčnej komunity GitHub, nehovoriac o zvýšení množstva absorbovaných informácií.

Napríklad Nechám odkaz na prvú kapitolu knihy, o ktorej som hovoril, tu je a tu je naň odkaz rap.

Zdroj: hab.com