Koart oer de situaasje yn universiteiten (persoanlike ûnderfining)
Om te begjinnen, is it wurdich om te bepalen dat it presintearre materiaal subjektyf is, sa te sizzen, "in sicht fan binnen", mar it fielt as de ynformaasje relevant is foar in protte steatsuniversiteiten yn 'e post-Sovjetromte.
Fanwegen de fraach nei IT-spesjalisten hawwe in protte ûnderwiisynstellingen relevante opliedingsgebieten iepene. Boppedat hawwe sels studinten fan net-IT-spesjaliteiten in protte IT-relatearre fakken krigen, faak Python, R, wylst minder gelokkige studinten "stoffige" akademyske talen lykas Pascal moatte behearskje.
As jo djipper sjogge, is alles net sa ienfâldich. Net alle learkrêften hâlde de "trends" by. Persoanlik, wylst ik in spesjaliteit "programmearje" studearre, waard ik konfrontearre mei it feit dat guon learkrêften gjin aktuele lêzingsnotysjes hawwe. Om krekter te wêzen, stjoerde de learaar de haadman in foto fan notysjes mei de hân skreaun troch in studint op in flash drive. Ik bin folslein stil oer de relevânsje fan sokke materialen as hânboeken oer WEB-programmearring (2010). It is ek oerbleaun om te rieden wat der bart yn technyske skoallen en it slimste fan it slimste ûnderwiisynstellingen.
Yn gearfetting:
- Se printsje in protte irrelevante ynformaasje yn it stribjen nei kwantitative akademyske yndikatoaren;
- De frijlitting fan nije materialen is net organisearre;
- "Trendy" en aktuele details wurde faak mist troch ienfâldige ûnwittendheid;
- Feedback oan de skriuwer is dreech;
- Bywurke edysjes wurde komselden en ûnregelmjittich publisearre.
"As jo it net iens binne, kritearje, as jo kritearje, suggerearje ..."
It earste ding dat yn 't sin komt is de ymplemintaasje fan motor-basearre systemen . Ja, ja, elkenien hat fan Wikipedia heard, mar it hat in ensyklopedyske referinsjeaard. Wy binne mear ynteressearre yn edukative materialen. past ús better. De neidielen omfetsje:
- ferplichte iepenheid fan alle materialen (sitaat: "Hjir yn 'e wiki-omjouwing wurdt edukative literatuer mei-inoar skreaun, frij ferspraat en foar elkenien tagonklik.")
- de oanwêzigens fan wat ôfhinklikens fan 'e regels fan' e side, de ynterne hiërargy fan brûkers
D'r binne in protte wiki-motoren dy't yn it publike domein driuwe, mar ik tink dat it net nedich is om sels te praten oer de mooglikheid om in wiki-systeem op universitêre skaal yn te setten. Ut ûnderfining sil ik sizze dat: a) sokke sels-hoste oplossingen lêst hawwe fan fouttolerânsje; b) kinne jo ferjitte oer systeem updates (mei hiel seldsume útsûnderings).
Foar in lange tiid tocht ik te min oer hoe't ik de situaasje koe ferbetterje. En doe sei in kunde op in dei dat er lang lyn in ûntwerp fan in boek op A4 printe hat, mar de elektroanyske ferzje kwytrekke. Ik wie ynteressearre yn hoe't ik it allegear konvertearje yn elektroanyske foarm.
Dit wie in learboek mei in signifikant oantal formules en grafiken, sa populêr OCR-ark, bgl. , mar de helte holp. Finereader produsearre stikken platte tekst, dy't wy begûnen te fieren yn gewoane tekstbestannen, ferdield yn haadstikken en markearje alles yn MarkDown. Fansels brûkt foar gemak fan gearwurking. As remote repository brûkten wy , de reden wie de mooglikheid om privee repositories te meitsjen mei in fergees taryfplan (dit is ek wier foar ). Fûn foar formule-ynfoegingen . Op dit stadium kearden wy úteinlik nei "MarkDown + LaTeX", om't de formules waarden omboud ta . Om te konvertearjen nei pdf hawwe wy brûkt .
Nei ferrin fan tiid waard in ienfâldige tekstbewurker net genôch, dus ik begon te sykjen nei in ferfanger. It besocht en ferskate oare ferlykbere programma's. As gefolch, wy kamen ta in web oplossing en begûn te brûken , alles wat jo nedich wiene wie der, fan syngronisaasje mei github oant LaTeX-stipe en opmerkings.
Om spesifyk te wêzen, as resultaat waard in ienfâldich skript skreaun wêrfoar ik skamje, dat de taak útfierde fan it gearstallen en konvertearjen fan de typte tekst yn WEB. In ienfâldige HTML-sjabloan wie genôch foar dit.
Hjir binne de kommando's foar it konvertearjen nei 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 {} ;It docht neat tûk, fan wat kin wurde opmurken: it sammelt ynhâldkoppen foar maklike navigaasje en konvertearret LaTeX.
Op it stuit is d'r in idee om de build te automatisearjen by it meitsjen fan pushen nei reps op github, mei help fan tsjinsten foar trochgeande yntegraasje (Circle CI, Travis CI ..)
Neat is nij ...
Nei't ik ynteressearre waard yn dit idee, begon ik te sykjen nei hoe populêr it no is.
It wie dúdlik dat dit idee net nij is foar softwaredokumintaasje. Ik haw nochal wat foarbylden sjoen fan edukatyf materiaal foar programmeurs, bygelyks: JS-kursussen . Ik wie ek ynteressearre yn it idee fan in git-basearre wiki-motor neamd
Ik haw nochal wat repositories sjoen mei boeken dy't folslein skreaun binne yn LaTeX.
konklúzje
In protte studinten skriuwe notysjes ferskate kearen oer, dy't se in protte, in protte kearen earder skreaun hawwe (ik twifelje net oan it foardiel fan skriuwen mei de hân), elke kear as de ynformaasje ferlern is en heul stadich bywurke, binne net alle notysjes, lykas wy begripe, yn elektroanyske foarm. As resultaat soe it cool wêze om de notysjes te uploaden nei github (konvertearje nei pdf, webwerjefte), en de learkrêften oanbiede om itselde te dwaan. Dit soe, yn in bepaalde mate, studinten en learkrêften lûke nei de "live" kompetitive GitHub-mienskip, om net te sprekken fan it fergrutsjen fan de hoemannichte ynformaasje dy't opnommen is.
Bygelyks Ik lit in keppeling nei it earste haadstik fan it boek wêr't ik it oer hie, en hjir is de link nei it .
Boarne: www.habr.com