Forhindre at læremateriell blir foreldet

Kort om situasjonen ved universiteter (personlig erfaring)

Til å begynne med er det verdt å fastslå at materialet som presenteres er subjektivt, så å si, "et syn fra innsiden", men det føles som om informasjonen er relevant for mange statlige universiteter i det post-sovjetiske rommet.

På grunn av etterspørselen etter IT-spesialister har mange utdanningsinstitusjoner åpnet relevante opplæringsområder. Dessuten har til og med studenter av ikke-IT-spesialiteter mottatt mange IT-relaterte fag, ofte Python, R, mens mindre heldige studenter må mestre "støvete" akademiske språk som Pascal.

Hvis du ser dypere, er ikke alt så enkelt. Ikke alle lærere følger med på «trendene». Personlig, mens jeg studerte en spesialitet "programmering", ble jeg møtt med det faktum at noen lærere ikke har oppdaterte forelesningsnotater. For å være mer presis sendte læreren rektor et bilde av notater håndskrevet av en elev på en flash-stasjon. Jeg er helt stille om relevansen av slike materialer som manualer om WEB-programmering (2010). Det er også overlatt å gjette hva som skjer på tekniske skoler og det verste av det verste utdanningsinstitusjoner.

Oppsummert:

  • De skriver ut mye irrelevant informasjon i jakten på kvantitative akademiske indikatorer;
  • Utgivelsen av nytt materiale er uorganisert;
  • "Trendy" og aktuelle detaljer blir ofte savnet på grunn av enkel uvitenhet;
  • Tilbakemelding til forfatteren er vanskelig;
  • Oppdaterte utgaver publiseres sjelden og uregelmessig.

"Hvis du ikke er enig, kritiser, hvis du kritiserer, foreslå..."

Det første du tenker på er implementeringen av motorbaserte systemer Media wiki. Ja, ja, alle har hørt om Wikipedia, men den har en encyklopedisk referansekarakter. Vi er mer interessert i undervisningsmateriell. Wikibøker passer oss bedre. Ulempene inkluderer:

  • obligatorisk åpenhet for alt materiale (sitat: "Her i wiki-miljøet er pedagogisk litteratur skrevet i fellesskap, distribuert fritt og tilgjengelig for alle.")
  • tilstedeværelsen av en viss avhengighet av reglene på nettstedet, det interne hierarkiet til brukere
    Det er mange wiki-motorer som flyter i det offentlige domene, men jeg tror det ikke er nødvendig å begynne å snakke om muligheten for å distribuere et wiki-system på universitetsskala. Av erfaring vil jeg si at: a) slike selvhostede løsninger lider av feiltoleranse; b) du kan glemme systemoppdateringer (med svært sjeldne unntak).

I lang tid tenkte jeg til ingen nytte på hvordan jeg skulle forbedre situasjonen. Og så en dag sa en bekjent at han for lenge siden trykket et utkast til en bok på A4, men mistet den elektroniske versjonen. Jeg var interessert i hvordan man konverterer det hele til elektronisk form.

Dette var en lærebok med en betydelig mengde formler og grafer, så populære OCR-verktøy, f.eks. abbyy finereader, bare halvparten hjalp. Finereader produserte biter av ren tekst, som vi begynte å legge inn i vanlige tekstfiler, dele dem inn i kapitler og markere alt i MarkDown. Tydelig brukt git for å lette samarbeidet. Som et eksternt depot brukte vi BitBucket, grunnen var muligheten til å opprette private depoter med en gratis tariffplan (dette gjelder også for GitLab). Funnet for formelinnlegg Mathpix. På dette stadiet vendte vi oss endelig mot "MarkDown + LaTeX", siden formlene ble konvertert til LaTeX. For å konvertere til pdf brukte vi pandoc.

Over tid ble en enkel tekstredigerer ikke nok, så jeg begynte å se etter en erstatning. Prøvde det typora og flere andre lignende programmer. Som et resultat kom vi til en nettløsning og begynte å bruke stackedit, alt du trengte var der, fra synkronisering med github til LaTeX-støtte og kommentarer.

For å være spesifikk, som et resultat ble det skrevet et enkelt skript som jeg skammer meg over, som utførte oppgaven med å sette sammen og konvertere den maskinskrevne teksten til WEB. En enkel HTML-mal var nok til dette.
Her er kommandoene for 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 {} ;

Den gjør ikke noe smart, fra det som kan bemerkes: den samler innholdsoverskrifter for enkel navigering og konverterer LaTeX.

For øyeblikket er det en ide om å automatisere byggingen når du trykker til representanter på github, ved å bruke Continuous Integration-tjenester (Circle CI, Travis CI..)

Ingenting er nytt...

Etter å ha blitt interessert i denne ideen, begynte jeg å se etter hvor populær den er nå.
Det var åpenbart at denne ideen ikke er ny for programvaredokumentasjon. Jeg har sett ganske mange eksempler på undervisningsmateriell for programmerere, for eksempel: JS-kurs learn.javascript.ru. Jeg var også interessert i ideen om en git-basert wiki-motor kalt Gollum

Jeg har sett ganske mange depoter med bøker skrevet utelukkende i LaTeX.

Utgang

Mange elever skriver om notater flere ganger, som de har skrevet mange, mange ganger før (jeg stiller ikke spørsmål ved fordelen med å skrive for hånd), hver gang informasjonen går tapt og oppdateres veldig sakte, er ikke alle notater, som vi forstår, i elektronisk skjema. Som et resultat ville det være kult å laste opp notatene til github (konvertere til pdf, webvisning), og tilby lærerne å gjøre det samme. Dette vil til en viss grad tiltrekke studenter og lærere til det "live" konkurransedyktige GitHub-fellesskapet, for ikke å snakke om å øke mengden informasjon som absorberes.

For eksempel Jeg legger igjen en lenke til det første kapittelet i boken jeg snakket om, her er hun og her er linken til den rap.

Kilde: www.habr.com

Legg til en kommentar