Secara ringkas tentang situasi di universiti (pengalaman peribadi)
Sebagai permulaan, adalah wajar untuk menetapkan bahawa bahan yang dibentangkan adalah subjektif, boleh dikatakan, "pandangan dalam", tetapi maklumat itu dirasakan relevan kepada banyak universiti negeri di ruang pasca-Soviet.
Disebabkan permintaan untuk pakar IT, banyak institusi pendidikan telah melancarkan program latihan yang sepadan. Lebih-lebih lagi, walaupun pelajar dengan jurusan bukan IT kini mengambil banyak kursus berkaitan IT, selalunya termasuk Python dan R. Mereka yang kurang bernasib baik terpaksa menguasai lebih banyak bahasa akademik esoterik seperti Pascal.
Jika anda melihat lebih dalam, perkara tidak begitu mudah. Tidak semua guru mengikuti trend terkini. Secara peribadi, semasa belajar pengaturcaraan, saya menghadapi masalah bahawa sesetengah guru tidak mempunyai nota kuliah yang terkini. Lebih khusus lagi, seorang guru menghantar foto nota tulisan tangan beberapa pelajar ke pemacu kilat monitor kelas. Saya tidak akan menyebut perkaitan bahan seperti manual pengaturcaraan web (dari 2010). Seseorang juga hanya boleh meneka apa yang berlaku di sekolah teknik dan yang paling teruk daripada yang paling teruk institusi pendidikan.
Secara ringkasnya:
- Mereka menerbitkan banyak maklumat yang tidak relevan dalam mengejar petunjuk akademik kuantitatif;
- Pengeluaran bahan baharu tidak teratur;
- Selalunya, butiran "trending" dan semasa 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, buat cadangan."
Perkara pertama yang terlintas di fikiran ialah pelaksanaan sistem berasaskan enjin Ya, semua orang pernah mendengar tentang Wikipedia, tetapi kebanyakannya adalah ensiklopedia rujukan. Kami lebih berminat dengan bahan pendidikan. Ia lebih sesuai dengan kita. Kelemahannya termasuk:
- keterbukaan mandatori semua bahan (petikan: "Di sini dalam persekitaran wiki, kesusasteraan pendidikan ditulis secara kolaboratif, diedarkan secara bebas dan boleh diakses oleh semua orang.")
- kehadiran pergantungan tertentu pada peraturan tapak dan hierarki pengguna dalaman
Terdapat banyak enjin wiki sumber terbuka yang tersedia, tetapi saya rasa ia tidak berbaloi untuk membincangkan kemungkinan menggunakan sistem wiki pada skala seluruh universiti. Daripada pengalaman, saya boleh memberitahu anda bahawa: a) penyelesaian yang dihoskan sendiri mengalami toleransi kesalahan; b) kemas kini sistem adalah tidak perlu (dengan sedikit pengecualian).
Untuk masa yang lama, saya memikirkan sia-sia bagaimana untuk memperbaiki keadaan. Kemudian pada suatu hari, seorang kawan memberitahu saya bahawa dia telah mencetak draf buku di atas kertas A4 lama dahulu dan kehilangan versi elektronik. Dia tertanya-tanya bagaimana untuk menukar semuanya kepada format elektronik.
Ia adalah buku teks dengan sejumlah besar formula dan graf, alat OCR yang begitu popular seperti , hanya membantu separuh. Finereader menghasilkan ketulan teks biasa, yang kami mula masukkan ke dalam fail teks biasa, membahagikannya kepada bab, dan menanda semuanya dalam MarkDown. Jelas sekali, kami menggunakan untuk kemudahan kerjasama. Kami digunakan sebagai repositori jauh , sebabnya ialah keupayaan untuk mencipta repositori persendirian dengan pelan tarif percuma (ini juga berlaku untuk ). Untuk sisipan formula ditemui Pada peringkat ini, kami akhirnya beralih ke arah "MarkDown + LaTeX", kerana formula telah ditukar menjadi . Untuk penukaran kepada pdf yang kami gunakan .
Lama kelamaan, editor teks mudah menjadi tidak mencukupi, dan saya mula mencari pengganti. saya cuba dan beberapa program lain yang serupa. Akhirnya, kami datang ke penyelesaian web dan mula menggunakannya. , ia mempunyai semua yang anda perlukan, daripada penyegerakan dengan GitHub kepada sokongan dan ulasan LaTeX.
Secara khusus, saya akhirnya menulis skrip mudah, yang saya malu, yang melaksanakan tugas memasang dan menukar teks yang ditaip menjadi aplikasi web. Templat HTML mudah sahaja yang diperlukan.
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 "${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 {} ;Ia tidak melakukan apa-apa yang bijak, kecuali ia mengumpul tajuk kandungan untuk navigasi mudah dan menukar LaTeX.
Pada masa ini, terdapat idea untuk mengautomasikan binaan apabila menolak ke repo pada GitHub, menggunakan perkhidmatan Integrasi Berterusan (Circle CI, Travis CI, dll.)
Tiada yang baru…
Setelah berminat dengan idea ini, saya mula melihat sejauh mana ia popular sekarang.
Jelas sekali bahawa idea ini bukanlah sesuatu yang baru dalam dokumentasi perisian. Saya telah melihat banyak contoh bahan latihan untuk pengaturcara, seperti kursus JS. Saya juga berminat dengan idea enjin wiki berdasarkan git dipanggil
Saya telah melihat beberapa repositori dengan buku yang ditulis sepenuhnya dalam LaTeX.
Output
Ramai pelajar menulis semula nota yang telah ditulis berkali-kali sebelum ini (saya tidak mempersoalkan faedah tulisan tangan), tetapi maklumat akan hilang dan kemas kini sangat perlahan setiap kali. Tidak semua nota, seperti yang kita fahami, tersedia secara elektronik. Akhirnya, adalah bagus untuk memuat naik nota ke GitHub (menukarnya kepada PDF atau format web), dan menggalakkan guru 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 mereka serap.
Contohnya Saya meninggalkan pautan ke bab pertama buku yang saya bincangkan, dan inilah pautan kepadanya .
Sumber: www.habr.com
