Kort over de situatie op universiteiten (persoonlijke ervaring)
Om te beginnen is het de moeite waard om vast te stellen dat het gepresenteerde materiaal subjectief is, om zo te zeggen, ‘een blik van binnenuit’, maar het voelt alsof de informatie relevant is voor veel staatsuniversiteiten in de post-Sovjet-ruimte.
Vanwege de vraag naar IT-specialisten hebben veel onderwijsinstellingen relevante opleidingsruimtes geopend. Bovendien hebben zelfs studenten van niet-IT-specialiteiten veel IT-gerelateerde vakken gevolgd, vaak Python, R, terwijl minder fortuinlijke studenten ‘stoffige’ academische talen zoals Pascal moeten beheersen.
Als je dieper kijkt, is alles niet zo eenvoudig. Niet alle leraren volgen de ‘trends’. Persoonlijk werd ik tijdens het studeren van een specialiteit 'programmeren' geconfronteerd met het feit dat sommige docenten niet over actuele collegeaantekeningen beschikken. Om preciezer te zijn: de leraar stuurde de schooldirecteur een foto van aantekeningen die door een leerling met de hand waren geschreven, op een flashstation. Ik zwijg volledig over de relevantie van materialen als handleidingen over WEB-programmering (2010). Het blijft ook raden wat er gebeurt op technische scholen en het ergste van het ergste onderwijsinstellingen.
In het kort:
- Ze printen veel irrelevante informatie op zoek naar kwantitatieve academische indicatoren;
- De release van nieuwe materialen is ongeorganiseerd;
- “Trendy” en actuele details worden vaak over het hoofd gezien door simpele onwetendheid;
- Feedback aan de auteur is moeilijk;
- Bijgewerkte edities worden zelden en onregelmatig gepubliceerd.
“Als je het er niet mee eens bent, bekritiseer dan, als je kritiek hebt, stel dan voor...”
Het eerste dat in je opkomt is de implementatie van op motoren gebaseerde systemen . Ja, ja, iedereen heeft wel eens van Wikipedia gehoord, maar het heeft een encyclopedisch referentiekarakter. Wij zijn meer geïnteresseerd in educatief materiaal. past beter bij ons. De nadelen zijn onder meer:
- verplichte openheid van alle materialen (citaat: “Hier in de wiki-omgeving wordt educatieve literatuur gezamenlijk geschreven, vrij verspreid en voor iedereen toegankelijk.”)
- de aanwezigheid van enige afhankelijkheid van de regels van de site, de interne hiërarchie van gebruikers
Er zweven veel wiki-engines in het publieke domein, maar ik denk dat het niet nodig is om zelfs maar te praten over de mogelijkheid om een wiki-systeem op universitaire schaal in te zetten. Uit ervaring kan ik zeggen dat: a) dergelijke zelfgehoste oplossingen last hebben van fouttolerantie; b) u kunt systeemupdates vergeten (op zeer zeldzame uitzonderingen na).
Lange tijd heb ik tevergeefs nagedacht over hoe ik de situatie kon verbeteren. En toen zei een kennis op een dag dat hij lang geleden een concept van een boek op A4 had afgedrukt, maar de elektronische versie was kwijtgeraakt. Ik was geïnteresseerd in hoe ik dit allemaal in elektronische vorm kon omzetten.
Dit was een leerboek met een aanzienlijke hoeveelheid formules en grafieken, dus populaire OCR-tools, b.v. , slechts de helft hielp. Finereader produceerde stukjes platte tekst, die we in gewone tekstbestanden begonnen in te voeren, ze in hoofdstukken verdeelden en alles in MarkDown markeerden. Duidelijk gebruikt voor een gemakkelijke samenwerking. Als externe opslagplaats gebruikten we , de reden was de mogelijkheid om privérepository's te creëren met een gratis tariefplan (dit geldt ook voor ). Gevonden voor formule-inserts . In dit stadium hebben we ons uiteindelijk gericht op “MarkDown + LaTeX”, aangezien de formules zijn omgezet in . Om naar pdf te converteren hebben we gebruikt .
Na verloop van tijd werd een eenvoudige teksteditor niet genoeg, dus ging ik op zoek naar een vervanger. Ik heb het geprobeerd en verschillende andere soortgelijke programma's. Het resultaat was dat we tot een weboplossing kwamen en deze gingen gebruiken , alles wat je nodig had was aanwezig, van synchroniseren met github tot LaTeX-ondersteuning en opmerkingen.
Om specifiek te zijn: als resultaat is er een eenvoudig script geschreven waarvoor ik me schaam, dat de taak vervulde van het samenstellen en converteren van de getypte tekst naar WEB. Hiervoor was een eenvoudig HTML-sjabloon voldoende.
Hier zijn de opdrachten voor het converteren naar 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 {} ;Het doet niets slims, zoals kan worden opgemerkt: het verzamelt inhoudskoppen voor eenvoudige navigatie en converteert LaTeX.
Op dit moment is er een idee om de build te automatiseren bij het pushen naar vertegenwoordigers op github, met behulp van Continuous Integration-services (Circle CI, Travis CI..)
Niets is nieuw...
Omdat ik geïnteresseerd raakte in dit idee, begon ik te zoeken naar hoe populair het nu is.
Het was duidelijk dat dit idee niet nieuw is voor softwaredocumentatie. Ik heb nogal wat voorbeelden gezien van educatief materiaal voor programmeurs, bijvoorbeeld: JS-cursussen . Ik was ook geïnteresseerd in het idee van een op git gebaseerde wiki-engine genaamd
Ik heb nogal wat repositories gezien met boeken die volledig in LaTeX zijn geschreven.
Uitgang
Veel studenten herschrijven aantekeningen verschillende keren, die ze al vele malen eerder hebben geschreven (ik twijfel niet aan het voordeel van met de hand schrijven). Elke keer dat de informatie verloren gaat en heel langzaam wordt bijgewerkt, zijn niet alle aantekeningen, zoals we begrijpen, in orde. elektronische vorm. Als gevolg hiervan zou het cool zijn om de aantekeningen naar github te uploaden (converteren naar pdf, webweergave) en de docenten aan te bieden hetzelfde te doen. Dit zou tot op zekere hoogte studenten en docenten naar de “live” competitieve GitHub-gemeenschap lokken, om nog maar te zwijgen van het vergroten van de hoeveelheid geabsorbeerde informatie.
Bijvoorbeeld Ik laat een link achter naar het eerste hoofdstuk van het boek waar ik het over had, en hier is de link ernaartoe .
Bron: www.habr.com