Kort om situationen på universiteterne (personlig erfaring)
Til at begynde med er det værd at fastslå, at det præsenterede materiale er subjektivt, så at sige, "et syn fra indersiden", men det føles som om informationen er relevant for mange statsuniversiteter i det postsovjetiske rum.
På grund af efterspørgslen efter it-specialister har mange uddannelsesinstitutioner åbnet relevante uddannelsesområder. Desuden har selv studerende med ikke-IT-specialiteter modtaget mange IT-relaterede fag, ofte Python, R, mens mindre heldige studerende skal mestre "støvede" akademiske sprog som Pascal.
Hvis du ser dybere, er alt ikke så enkelt. Ikke alle lærere følger med "tendenserne". Personligt, mens jeg studerede et speciale i "programmering", blev jeg konfronteret med det faktum, at nogle lærere ikke har opdaterede forelæsningsnotater. For at være mere præcis sendte læreren rektor et foto af noter håndskrevne af en elev på et flashdrev. Jeg er fuldstændig tavs om relevansen af sådanne materialer som manualer om WEB-programmering (2010). Det er også overladt til at gætte, hvad der sker på tekniske skoler og det værste af det værste uddannelsesinstitutioner.
Sammenfattende:
- De udskriver en masse irrelevant information i jagten på kvantitative akademiske indikatorer;
- Frigivelsen af nye materialer er uorganiseret;
- "Trendy" og aktuelle detaljer savnes ofte på grund af simpel uvidenhed;
- Feedback til forfatteren er vanskelig;
- Opdaterede udgaver udgives sjældent og uregelmæssigt.
"Hvis du ikke er enig, kritiser, hvis du kritiserer, så foreslå..."
Det første, der kommer til at tænke på, er implementeringen af motorbaserede systemer . Ja, ja, alle har hørt om Wikipedia, men den har en encyklopædisk referencekarakter. Vi er mere interesserede i undervisningsmaterialer. passer os bedre. Ulemperne omfatter:
- obligatorisk åbenhed af alt materiale (citat: "Her i wiki-miljøet er undervisningslitteratur skrevet i fællesskab, distribueret frit og tilgængeligt for alle.")
- tilstedeværelsen af en vis afhængighed af reglerne på webstedet, det interne hierarki af brugere
Der er mange wiki-motorer, der flyder i det offentlige domæne, men jeg tror ikke, der er behov for overhovedet at begynde at tale om muligheden for at implementere et wiki-system på en universitetsskala. Af erfaring vil jeg sige, at: a) sådanne selvhostede løsninger lider af fejltolerance; b) du kan glemme alt om systemopdateringer (med meget sjældne undtagelser).
I lang tid tænkte jeg forgæves på, hvordan man kunne forbedre situationen. Og så en dag sagde en bekendt, at han for længe siden har trykt et udkast til en bog på A4, men mistede den elektroniske version. Jeg var interesseret i, hvordan man konverterer det hele til elektronisk form.
Dette var en lærebog med en betydelig mængde formler og grafer, så populære OCR-værktøjer, f.eks. , kun halvdelen hjalp. Finereader producerede stykker almindelig tekst, som vi begyndte at indtaste i almindelige tekstfiler, opdele dem i kapitler og markere alt i MarkDown. Tydeligvis brugt for at lette samarbejdet. Som et fjernlager brugte vi , grunden var muligheden for at oprette private arkiver med en gratis tarifplan (dette gælder også for ). Fundet til formelindlæg . På dette stadium vendte vi endelig mod "MarkDown + LaTeX", da formlerne blev konverteret til . For at konvertere til pdf brugte vi .
Med tiden blev en simpel teksteditor ikke nok, så jeg begyndte at lede efter en erstatning. Prøvede det og flere andre lignende programmer. Som et resultat kom vi frem til en webløsning og begyndte at bruge , alt hvad du havde brug for var der, fra synkronisering med github til LaTeX-understøttelse og kommentarer.
For at være specifik blev der som følge heraf skrevet et simpelt script, som jeg skammer mig over, som udførte opgaven med at samle og konvertere den maskinskrevne tekst til WEB. En simpel HTML-skabelon var nok til dette.
Her er kommandoerne til konvertering til 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 {} ;Det gør ikke noget smart, ud fra hvad der kan bemærkes: det indsamler indholdsoverskrifter for nem navigation og konverterer LaTeX.
I øjeblikket er der en idé om at automatisere opbygningen, når du laver push til reps på github ved hjælp af Continuous Integration-tjenester (Circle CI, Travis CI..)
Intet er nyt...
Da jeg var blevet interesseret i denne idé, begyndte jeg at se efter, hvor populær den er nu.
Det var indlysende, at denne idé ikke er ny for softwaredokumentation. Jeg har set en del eksempler på undervisningsmaterialer til programmører, for eksempel: JS-kurser . Jeg var også interesseret i ideen om en git-baseret wiki-motor kaldet
Jeg har set en del depoter med bøger skrevet udelukkende i LaTeX.
Output
Mange elever omskriver noter flere gange, som de har skrevet mange, mange gange før (jeg sætter ikke spørgsmålstegn ved fordelen ved at skrive i hånden), hver gang informationen går tabt og opdateres meget langsomt, er det ikke alle noter, som vi forstår, i elektronisk formular. Som et resultat ville det være fedt at uploade noterne til github (konverter til pdf, webvisning) og tilbyde lærerne at gøre det samme. Dette ville til en vis grad tiltrække studerende og lærere til det "live" konkurrencedygtige GitHub-fællesskab, for ikke at nævne at øge mængden af absorberet information.
For eksempel Jeg vil efterlade et link til det første kapitel i bogen, jeg talte om, og her er linket til den .
Kilde: www.habr.com