Mencegah bahan ajar menjadi usang

Secara singkat tentang situasi di universitas (pengalaman pribadi)

Pertama-tama, perlu ditetapkan bahwa materi yang disajikan bersifat subjektif, bisa dikatakan, “pandangan dari dalam”, tetapi informasi tersebut tampaknya relevan bagi banyak universitas negeri di era pasca-Soviet.

Karena kebutuhan akan spesialis TI, banyak lembaga pendidikan telah membuka bidang pelatihan yang relevan. Selain itu, bahkan siswa dengan spesialisasi non-IT telah menerima banyak mata pelajaran terkait TI, sering kali Python, R, sementara siswa yang kurang beruntung harus menguasai bahasa akademis yang “berdebu” seperti Pascal.

Jika Anda melihat lebih dalam, semuanya tidak sesederhana itu. Tidak semua guru mengikuti “tren”. Secara pribadi, saat mempelajari spesialisasi “pemrograman”, saya dihadapkan pada kenyataan bahwa beberapa guru tidak memiliki catatan kuliah terkini. Lebih tepatnya, guru mengirimkan kepada kepala sekolah foto catatan tulisan tangan beberapa siswa ke dalam flash drive. Saya sama sekali diam tentang relevansi materi seperti manual pemrograman WEB (2010). Tinggal menebak apa yang terjadi di sekolah teknik dan yang terburuk dari yang terburuk lembaga pendidikan.

Singkatnya:

• Mereka mencetak banyak informasi yang tidak relevan untuk mengejar indikator akademik kuantitatif;
• Pelepasan materi baru tidak terorganisir;
• Detail yang “trendi” dan terkini sering kali terlewatkan karena ketidaktahuan belaka;
• Sulit untuk memberikan masukan kepada penulis;
• Edisi yang diperbarui jarang diterbitkan dan tidak teratur.

“Jika Anda tidak setuju, kritiklah, jika Anda mengkritik, sarankan…”

Hal pertama yang terlintas dalam pikiran adalah penerapan sistem berbasis mesin Wiki media. Ya, semua orang pernah mendengar tentang Wikipedia, tetapi Wikipedia bersifat referensi ensiklopedis. Kami lebih tertarik pada materi pendidikan. Buku Wiki lebih cocok untuk kita. Kerugiannya meliputi:

• keterbukaan wajib semua materi (kutipan: “Di sini, di lingkungan wiki, literatur pendidikan ditulis bersama, didistribusikan secara bebas dan dapat diakses oleh semua orang.”)
• adanya ketergantungan pada aturan situs, hierarki internal pengguna
  Ada banyak mesin wiki yang beredar di domain publik, namun menurut saya tidak perlu membicarakan kemungkinan penerapan sistem wiki pada skala universitas. Dari pengalaman saya akan mengatakan bahwa: a) solusi yang dihosting sendiri memiliki toleransi kesalahan; b) Anda bisa melupakan pembaruan sistem (dengan pengecualian yang sangat jarang).

Untuk waktu yang lama saya tidak memikirkan cara untuk memperbaiki situasi. Dan suatu hari seorang kenalan mengatakan bahwa dahulu kala dia mencetak draf buku dalam format A4, tetapi versi elektroniknya hilang. Saya tertarik dengan cara mengubah semuanya menjadi bentuk elektronik.

Ini adalah buku teks dengan banyak rumus dan grafik, sehingga alat OCR sangat populer, misalnya. abbyy pembaca halus, hanya setengah yang membantu. Finereader menghasilkan potongan teks biasa, yang mulai kami masukkan ke dalam file teks biasa, membaginya menjadi beberapa bab, dan menandai semuanya di MarkDown. Jelas digunakan git untuk kemudahan kerjasama. Sebagai repositori jarak jauh yang kami gunakan BitBucket, alasannya adalah kemampuan untuk membuat repositori pribadi dengan paket tarif gratis (ini juga berlaku untuk GitLab). Ditemukan untuk sisipan rumus Mathpix. Pada tahap ini, kami akhirnya beralih ke “MarkDown + LaTeX”, karena rumusnya telah diubah menjadi Getah. Untuk mengkonversi ke pdf kami menggunakan Pandoc.

Seiring waktu, editor teks sederhana tidak lagi cukup, jadi saya mulai mencari penggantinya. Mencobanya Typora dan beberapa program serupa lainnya. Hasilnya, kami menemukan solusi web dan mulai menggunakannya tumpukan, semua yang Anda butuhkan ada di sana, mulai dari sinkronisasi dengan github hingga dukungan dan komentar LaTeX.

Untuk lebih spesifiknya, sebagai hasilnya, sebuah skrip sederhana ditulis yang membuat saya malu, yang melakukan tugas merakit dan mengubah teks yang diketik menjadi WEB. Template HTML sederhana sudah cukup untuk ini.
Berikut adalah perintah untuk mengkonversi ke 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 {} ;

Itu tidak melakukan sesuatu yang cerdas, dari apa yang dapat dicatat: ia mengumpulkan header konten untuk navigasi yang mudah dan mengkonversi LaTeX.

Saat ini ada ide untuk mengotomatisasi pembangunan ketika melakukan push ke repetisi di github, menggunakan layanan Integrasi Berkelanjutan (Circle CI, Travis CI..)

Tidak ada yang baru...

Karena tertarik dengan ide ini, saya mulai mencari seberapa populernya ide ini sekarang.
Jelas sekali bahwa ide ini bukanlah hal baru untuk dokumentasi perangkat lunak. Saya sudah melihat cukup banyak contoh materi pendidikan untuk programmer, misalnya: kursus JS belajar.javascript.ru. Saya juga tertarik dengan ide mesin wiki berbasis git yang disebut Gollum

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

Keluaran

Banyak siswa menulis ulang catatan beberapa kali, yang telah mereka tulis berkali-kali sebelumnya (saya tidak mempertanyakan manfaat menulis dengan tangan), setiap kali informasi hilang dan diperbarui dengan sangat lambat, tidak semua catatan, seperti yang kita pahami, ada di bentuk elektronik. Hasilnya, akan menyenangkan jika mengunggah catatan ke github (dikonversi ke pdf, tampilan web), dan menawarkan guru untuk melakukan hal yang sama. Hal ini, sampai batas tertentu, akan menarik siswa dan guru ke komunitas GitHub yang kompetitif dan “langsung”, belum lagi meningkatkan jumlah informasi yang diserap.

Sebagai contoh Saya akan meninggalkan tautan ke bab pertama dari buku yang saya bicarakan, ini dia dan ini tautannya rap.

Sumber: www.habr.com