Mengelakkan bahan pembelajaran daripada menjadi usang

Secara ringkas tentang situasi di universiti (pengalaman peribadi)

Sebagai permulaan, adalah wajar untuk menetapkan bahawa bahan yang dibentangkan adalah subjektif, boleh dikatakan, "pandangan dari dalam," tetapi rasanya maklumat itu relevan untuk banyak universiti negeri di ruang pasca-Soviet.

Oleh kerana permintaan untuk pakar IT, banyak institusi pendidikan telah membuka bidang latihan yang berkaitan. Selain itu, walaupun pelajar kepakaran bukan IT telah menerima banyak subjek berkaitan IT, selalunya Python, R, manakala pelajar yang kurang bernasib baik perlu menguasai bahasa akademik "berdebu" seperti Pascal.

Jika anda melihat lebih dalam, semuanya tidak begitu mudah. Tidak semua guru mengikuti "trend". Secara peribadi, semasa mempelajari kepakaran "pengaturcaraan", saya berhadapan dengan hakikat bahawa sesetengah guru tidak mempunyai nota kuliah yang terkini. Untuk lebih tepat, guru menghantar kepada ketua sekeping gambar nota yang ditulis tangan oleh beberapa pelajar ke pemacu kilat. Saya benar-benar senyap tentang kaitan bahan tersebut sebagai manual pada pengaturcaraan WEB (2010). Ia juga dibiarkan meneka apa yang berlaku di sekolah teknik dan yang paling teruk daripada yang paling teruk institusi pendidikan.

Secara ringkasnya:

• Mereka mencetak banyak maklumat yang tidak relevan dalam mengejar petunjuk akademik kuantitatif;
• Pengeluaran bahan baru tidak teratur;
• Butiran "trendi" dan semasa sering terlepas kerana kejahilan mudah;
• Maklum balas kepada penulis adalah sukar;
• Edisi kemas kini diterbitkan jarang dan tidak teratur.

"Jika anda tidak bersetuju, kritik, jika anda mengkritik, cadangkan..."

Perkara pertama yang terlintas di fikiran ialah pelaksanaan sistem berasaskan enjin Media wiki. Ya, ya, semua orang pernah mendengar tentang Wikipedia, tetapi ia mempunyai sifat rujukan ensiklopedia. Kami lebih berminat dengan bahan pendidikan. Buku Wiki lebih sesuai dengan kita. Kelemahannya termasuk:

• keterbukaan mandatori semua bahan (petikan: "Di sini dalam persekitaran wiki, kesusasteraan pendidikan ditulis bersama, diedarkan secara bebas dan boleh diakses oleh semua orang.")
• kehadiran beberapa pergantungan pada peraturan tapak, hierarki dalaman pengguna
  Terdapat banyak enjin wiki terapung dalam domain awam, tetapi saya rasa tidak perlu untuk mula bercakap tentang kemungkinan menggunakan sistem wiki pada skala universiti. Daripada pengalaman saya akan mengatakan bahawa: a) penyelesaian yang dihoskan sendiri mengalami toleransi kesalahan; b) anda boleh melupakan kemas kini sistem (dengan pengecualian yang sangat jarang berlaku).

Untuk masa yang lama saya berfikir tidak berjaya tentang bagaimana untuk memperbaiki keadaan. Dan kemudian suatu hari seorang kenalan berkata bahawa lama dahulu dia mencetak draf buku pada A4, tetapi kehilangan versi elektronik. Saya berminat untuk menukar semuanya ke dalam bentuk elektronik.

Ini ialah buku teks dengan sejumlah besar formula dan graf, alat OCR yang begitu popular, mis. abbyy finereader, hanya separuh membantu. Finereader menghasilkan cebisan teks biasa, yang kami mula masukkan ke dalam fail teks biasa, membahagikannya kepada bab, dan menandakan semuanya dalam MarkDown. Jelas digunakan pergi untuk kemudahan kerjasama. Sebagai repositori jauh yang kami gunakan BitBucket, sebabnya ialah keupayaan untuk mencipta repositori persendirian dengan pelan tarif percuma (ini juga berlaku untuk GitLab). Ditemui untuk sisipan formula Mathpix. Pada peringkat ini, kami akhirnya beralih ke arah "MarkDown + LaTeX", kerana formula telah ditukar menjadi LaTeX. Untuk menukar kepada pdf yang kami gunakan Pandoc.

Lama kelamaan, editor teks mudah menjadi tidak mencukupi, jadi saya mula mencari pengganti. Dah cuba Typora dan beberapa program lain yang serupa. Akibatnya, kami datang ke penyelesaian web dan mula menggunakan bertumpuk, semua yang anda perlukan ada di sana, daripada menyegerakkan dengan github kepada sokongan dan ulasan LaTeX.

Secara khusus, sebagai hasilnya, skrip ringkas telah ditulis yang saya malu, yang melaksanakan tugas memasang dan menukar teks yang ditaip ke WEB. Templat HTML yang mudah sudah cukup untuk ini.
Berikut ialah arahan untuk menukar kepada 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 {} ;

Ia tidak melakukan apa-apa yang bijak, daripada apa yang boleh diperhatikan: ia mengumpul pengepala kandungan untuk navigasi mudah dan menukar LaTeX.

Pada masa ini terdapat idea untuk mengautomasikan binaan apabila membuat tolakan kepada wakil pada github, menggunakan perkhidmatan Integrasi Berterusan (Circle CI, Travis CI..)

Tiada yang baru...

Setelah berminat dengan idea ini, saya mula mencari betapa popularnya sekarang.
Jelas sekali bahawa idea ini bukan baru untuk dokumentasi perisian. Saya telah melihat beberapa contoh bahan pendidikan untuk pengaturcara, contohnya: kursus JS learn.javascript.ru. Saya juga berminat dengan idea enjin wiki berasaskan git yang dipanggil Gollum

Saya telah melihat beberapa repositori dengan buku yang ditulis sepenuhnya dalam LaTeX.

Output

Ramai pelajar menulis semula nota beberapa kali, yang mereka tulis banyak, banyak kali sebelum ini (saya tidak mempersoalkan faedah menulis dengan tangan), setiap kali maklumat itu hilang dan dikemas kini dengan sangat perlahan, tidak semua nota, seperti yang kita faham, berada dalam bentuk elektronik. Akibatnya, adalah bagus untuk memuat naik nota ke github (tukar kepada pdf, paparan web), dan menawarkan guru untuk melakukan perkara yang sama. Ini akan, pada tahap tertentu, menarik pelajar dan guru ke komuniti GitHub yang kompetitif "secara langsung", apatah lagi meningkatkan jumlah maklumat yang diserap.

Sebagai contoh Saya akan meninggalkan pautan ke bab pertama buku yang saya bincangkan, inilah dia dan inilah pautannya rap.

Sumber: www.habr.com