Ngăn chặn tài liệu học tập trở nên lỗi thời

Sơ lược về tình hình ở các trường đại học (kinh nghiệm cá nhân)

Đầu tiên, cần quy định rằng tài liệu được trình bày mang tính chủ quan, có thể nói là “một cái nhìn từ bên trong”, nhưng có vẻ như thông tin này phù hợp với nhiều trường đại học nhà nước trong không gian hậu Xô Viết.

Do nhu cầu về chuyên gia CNTT, nhiều cơ sở giáo dục đã mở các lĩnh vực đào tạo liên quan. Hơn nữa, ngay cả những sinh viên không chuyên ngành CNTT cũng được nhận nhiều môn liên quan đến CNTT, thường là Python, R, trong khi những sinh viên kém may mắn hơn phải thành thạo những ngôn ngữ học thuật “bụi bặm” như Pascal.

Nếu bạn nhìn sâu hơn, mọi thứ không đơn giản như vậy. Không phải giáo viên nào cũng theo kịp “xu hướng”. Cá nhân tôi, khi học chuyên ngành “lập trình”, tôi đã phải đối mặt với thực tế là một số giáo viên không có bài giảng cập nhật. Nói chính xác hơn, giáo viên đã gửi cho hiệu trưởng một bức ảnh ghi chú của một học sinh nào đó viết tay vào ổ đĩa flash. Tôi hoàn toàn im lặng về sự liên quan của những tài liệu như sách hướng dẫn lập trình WEB (2010). Người ta cũng phải đoán xem điều gì đang xảy ra ở các trường kỹ thuật và điều tồi tệ nhất trong điều tồi tệ nhất các cơ sở giáo dục.

Tóm lại:

  • Họ in rất nhiều thông tin không liên quan để theo đuổi các chỉ số học thuật định lượng;
  • Việc phát hành các tài liệu mới không có tổ chức;
  • Những chi tiết “thời thượng” và hiện tại thường bị bỏ sót do thiếu hiểu biết;
  • Phản hồi cho tác giả rất khó khăn;
  • Các phiên bản cập nhật được xuất bản hiếm khi và không thường xuyên.

“Không đồng ý thì phê bình, phê bình thì đề nghị…”

Điều đầu tiên bạn nghĩ đến là việc triển khai các hệ thống dựa trên động cơ Wiki truyền thông. Vâng, vâng, mọi người đều đã nghe nói về Wikipedia, nhưng nó có tính chất tham khảo bách khoa toàn thư. Chúng tôi quan tâm nhiều hơn đến tài liệu giáo dục. Wikibooks phù hợp với chúng tôi hơn. Những nhược điểm bao gồm:

  • tính mở bắt buộc của tất cả các tài liệu (trích dẫn: “Ở đây trong môi trường wiki, tài liệu giáo dục được cùng nhau viết, phân phối miễn phí và mọi người đều có thể truy cập.”)
  • sự hiện diện của một số sự phụ thuộc vào các quy tắc của trang web, hệ thống phân cấp nội bộ của người dùng
    Có rất nhiều công cụ wiki trôi nổi trong phạm vi công cộng, nhưng tôi nghĩ thậm chí không cần thiết phải bắt đầu nói về khả năng triển khai hệ thống wiki ở quy mô đại học. Từ kinh nghiệm, tôi sẽ nói rằng: a) các giải pháp tự lưu trữ như vậy có khả năng chịu lỗi; b) bạn có thể quên cập nhật hệ thống (với những trường hợp ngoại lệ rất hiếm).

Trong một thời gian dài tôi đã suy nghĩ không có cách nào cải thiện được tình hình. Rồi một ngày, một người quen kể rằng cách đây rất lâu ông đã in bản thảo một cuốn sách trên khổ A4 nhưng làm mất bản điện tử. Tôi quan tâm đến việc làm thế nào để chuyển đổi tất cả sang dạng điện tử.

Đây là một cuốn sách giáo khoa có số lượng công thức và đồ thị đáng kể, vì vậy các công cụ OCR phổ biến, ví dụ: Abbyy finereader, chỉ giúp được một nửa. Finereader tạo ra các đoạn văn bản thuần túy mà chúng tôi bắt đầu nhập vào các tệp văn bản thông thường, chia chúng thành các chương và đánh dấu mọi thứ trong MarkDown. Rõ ràng là đã sử dụng git để dễ dàng hợp tác. Là một kho lưu trữ từ xa, chúng tôi đã sử dụng Cai Xô nhỏ, lý do là khả năng tạo các kho riêng với gói thuế quan miễn phí (điều này cũng đúng với GitLab). Tìm thấy để chèn công thức Toán học. Ở giai đoạn này, cuối cùng chúng tôi đã chuyển sang “MarkDown + LaTeX”, vì các công thức đã được chuyển đổi thành Mủ cao su. Để chuyển đổi sang pdf chúng tôi đã sử dụng bác học.

Theo thời gian, một trình soạn thảo văn bản đơn giản trở nên không đủ, vì vậy tôi bắt đầu tìm kiếm một trình soạn thảo thay thế. Thử nó Typora và một số chương trình tương tự khác. Kết quả là chúng tôi đã tìm ra giải pháp web và bắt đầu sử dụng xếp chồng lên nhau, mọi thứ bạn cần đều có ở đó, từ đồng bộ hóa với github đến hỗ trợ và nhận xét LaTeX.

Cụ thể hơn, kết quả là, một đoạn script đơn giản đã được viết ra mà tôi thấy xấu hổ, nó thực hiện nhiệm vụ tập hợp và chuyển đổi văn bản đã đánh máy thành WEB. Một mẫu HTML đơn giản là đủ cho việc này.
Dưới đây là các lệnh để chuyển đổi sang 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 {} ;

Nó không làm được điều gì thông minh cả, từ những gì có thể lưu ý: nó thu thập các tiêu đề nội dung để dễ dàng điều hướng và chuyển đổi LaTeX.

Hiện tại, có một ý tưởng để tự động hóa quá trình xây dựng khi thực hiện các lần đẩy tới đại diện trên github, sử dụng các dịch vụ Tích hợp liên tục (Circle CI, Travis CI..)

Không có gì mới...

Bắt đầu quan tâm đến ý tưởng này, tôi bắt đầu tìm hiểu mức độ phổ biến của nó hiện nay.
Rõ ràng là ý tưởng này không mới đối với tài liệu phần mềm. Tôi đã thấy khá nhiều ví dụ về tài liệu đào tạo dành cho lập trình viên, ví dụ: các khóa học về JS tìm hiểu.javascript.ru. Tôi cũng quan tâm đến ý tưởng về một công cụ wiki dựa trên git có tên là Gollum

Tôi đã thấy khá nhiều kho lưu trữ sách được viết hoàn toàn bằng LaTeX.

Đầu ra

Nhiều sinh viên viết lại các ghi chú nhiều lần, điều mà trước đây họ đã viết rất nhiều lần (tôi không đặt câu hỏi về lợi ích của việc viết bằng tay), mỗi lần thông tin bị mất và được cập nhật rất chậm, không phải tất cả các ghi chú, như chúng ta hiểu, đều ở trong Dạng điện tử. Do đó, sẽ thật tuyệt nếu tải các ghi chú lên github (chuyển đổi sang pdf, xem web) và đề nghị giáo viên làm điều tương tự. Ở một mức độ nhất định, điều này sẽ thu hút sinh viên và giáo viên đến với cộng đồng GitHub cạnh tranh “trực tiếp”, chưa kể đến việc tăng lượng thông tin được tiếp thu.

Ví dụ Tôi sẽ để lại liên kết đến chương đầu tiên của cuốn sách mà tôi đang nói đến, cô ấy đây rồi và đây là liên kết đến nó rap.

Nguồn: www.habr.com

Thêm một lời nhận xét