Õppematerjalide vananemise vältimine

Lühidalt olukorrast ülikoolides (isiklik kogemus)

Alustuseks tasub sätestada, et esitatav materjal on subjektiivne, nii-öelda "vaade seestpoolt", kuid tundub, et teave on asjakohane paljudele postsovetliku ruumi riigiülikoolidele.

IT-spetsialistide nõudluse tõttu on paljud õppeasutused avanud vastavad koolitusalad. Veelgi enam, isegi mitte-IT-erialade üliõpilased on saanud palju IT-ga seotud aineid, sageli Python, R, samas kui vähem õnnelikud õpilased peavad valdama "tolmunud" akadeemilisi keeli, nagu Pascal.

Kui vaadata sügavamale, pole kõik nii lihtne. Mitte kõik õpetajad ei pea "trendidega" sammu. Isiklikult puutusin “programmeerimise” eriala õppides kokku tõsiasjaga, et mõnel õpetajal pole ajakohaseid loengukonspekte. Täpsemalt saatis õpetaja koolijuhile foto mõne õpilase käsitsi kirjutatud märkmetest mälupulgale. Ma olen täiesti vait selliste materjalide asjakohasusest nagu WEB-i programmeerimise käsiraamatud (2010). Jääb ka oletada, mis toimub tehnikumides ja halvimatest halvim õppeasutused.

Kokkuvõttes:

• Nad trükivad kvantitatiivsete akadeemiliste näitajate poole püüdlemiseks palju ebaolulist teavet;
• Uute materjalide väljaandmine on organiseerimata;
• “Trendikad” ja ajakohased detailid jäävad sageli vahele lihtsa teadmatuse tõttu;
• Tagasiside andmine autorile on raske;
• Uuendatud väljaandeid ilmub harva ja ebaregulaarselt.

"Kui te ei nõustu, kritiseerige, kui kritiseerite, siis soovitage..."

Esimene asi, mis meelde tuleb, on mootoripõhiste süsteemide rakendamine Meedia viki. Jah, jah, kõik on Vikipeediast kuulnud, kuid sellel on entsüklopeediline viide iseloom. Oleme rohkem huvitatud õppematerjalidest. Vikiraamatud sobib meile paremini. Puuduste hulka kuuluvad:

• kõigi materjalide kohustuslik avatus (tsitaat: "Siin vikikeskkonnas kirjutatakse õppekirjandust ühiselt, levitatakse vabalt ja kõigile kättesaadavaks.")
• teatud sõltuvuse olemasolu saidi reeglitest, kasutajate sisemisest hierarhiast
  Avalikus omandis on palju vikimootoreid, kuid ma arvan, et pole vaja isegi hakata rääkima vikisüsteemi ülikooli mastaabis kasutuselevõtu võimalusest. Kogemuse põhjal ütlen, et: a) sellised isehostitud lahendused kannatavad tõrketaluvuse all; b) võite unustada süsteemivärskendused (väga harvade eranditega).

Pikka aega mõtlesin tulutult, kuidas olukorda parandada. Ja siis ükspäev rääkis üks tuttav, et ammu trükkis ta A4-le ühe raamatu mustandi, aga kaotas elektroonilise versiooni. Mind huvitas, kuidas see kõik elektrooniliseks vormiks muuta.

See oli õpik, milles oli märkimisväärne hulk valemeid ja graafikuid, nii et populaarsed OCR-vahendid, nt. abbyy peenlugeja, ainult pool aitas. Finereader valmistas lihtteksti tükke, mida hakkasime sisestama tavalistesse tekstifailidesse, jagades need peatükkideks ja märkides kõik MarkDownis üles. Ilmselgelt kasutatud git koostöö hõlbustamiseks. Kaughoidlana kasutasime BitBucket, põhjuseks oli võimalus luua privaatseid hoidlaid tasuta tariifiplaaniga (see kehtib ka GitLab). Leitud valemi lisade jaoks Mathpix. Selles etapis pöördusime lõpuks "MarkDown + LaTeX" poole, kuna valemid teisendati LaTeX. Pdf-vormingusse teisendamiseks kasutasime pandoc.

Aja jooksul ei piisanud lihtsast tekstiredaktorist, nii et hakkasin otsima asendust. Proovis ära Typora ja mitmed teised sarnased programmid. Selle tulemusena jõudsime veebilahenduseni ja hakkasime kasutama virnastatud, oli seal kõik vajalik, alates githubiga sünkroonimisest kuni LaTeX-i toe ja kommentaarideni.

Kui täpsem olla, siis selle tulemusel sai kirjutatud lihtne skript, mille pärast mul on häbi, mis täitis trükitud teksti kokkupanemise ja WEB-i teisendamise ülesande. Selleks piisas lihtsast HTML-i mallist.
Siin on käsud WEB-i teisendamiseks:

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 {} ;

See ei tee midagi tarka, mida võib märkida: see kogub hõlpsaks navigeerimiseks sisupäiseid ja teisendab LaTeX-i.

Hetkel on idee koostamist automatiseerida githubis kordustele tõuke tegemisel, kasutades Continuous Integration teenuseid (Circle CI, Travis CI..)

Midagi uut pole...

Olles selle idee vastu huvi tundnud, hakkasin otsima, kui populaarne see praegu on.
Oli ilmne, et see idee ei ole tarkvara dokumentatsiooni jaoks uus. Olen näinud päris palju näiteid programmeerijatele mõeldud õppematerjalidest, näiteks: JS-i kursused learning.javascript.ru. Mind huvitas ka git-põhise wikimootori idee Gollum

Olen näinud üsna palju hoidlaid, kus on raamatud, mis on kirjutatud täielikult LaTeX-is.

Väljund

Paljud õpilased kirjutavad märkmeid mitu korda ümber, mida nad palju-mitu kordi varem kirjutasid (ma ei sea kahtluse alla käsitsi kirjutamise kasulikkust), iga kord, kui teave kaob ja uueneb väga aeglaselt, kõik märkmed, nagu me aru saame, pole elektrooniline vorm. Sellest tulenevalt oleks lahe märkmed githubi üles laadida (pdf-iks teisendada, veebivaade) ja pakkuda seda ka õpetajatele. See meelitaks teatud määral õpilasi ja õpetajaid konkureerivasse GitHubi kogukonda, rääkimata neelatava teabe hulga suurendamisest.

Näiteks Ma jätan lingi raamatu esimesele peatükile, millest ma rääkisin, siin ta on ja siin on link sellele rap.

Allikas: www.habr.com