학습 자료가 쓸모없어지는 것을 방지

대학 상황에 대해 간략히 설명 (개인 경험)

우선, 제시된 자료가 주관적, 즉 "내부에서 본 모습"이라고 명시할 가치가 있지만, 이 정보는 소비에트 이후 공간의 많은 주립 대학과 관련이 있는 것처럼 느껴집니다.

IT 전문가에 대한 수요로 인해 많은 교육 기관에서 관련 교육 분야를 개설했습니다. 게다가 IT 전공이 아닌 학생들도 Python, R 등 IT 관련 과목을 많이 이수한 반면, 운이 좋지 않은 학생들은 Pascal과 같은 "먼지 많은" 학술 언어를 마스터해야 합니다.

더 깊이 살펴보면 모든 것이 그렇게 간단하지 않습니다. 모든 교사가 "트렌드"를 따라가는 것은 아닙니다. 개인적으로 "프로그래밍" 전문 분야를 공부하면서 일부 교사들은 최신 강의 노트를 가지고 있지 않다는 사실에 직면했습니다. 좀 더 정확하게 말하면, 교사는 어떤 학생이 손으로 쓴 메모 사진을 플래시 드라이브에 담아 교장에게 보냈습니다. 나는 웹 프로그래밍 매뉴얼(2010)과 같은 자료의 관련성에 대해 완전히 침묵합니다. 기술 학교와 학교에서 무슨 일이 일어나고 있는지 추측하는 것도 남아 있습니다. 최악 중의 최악 교육 기관.

결과 :

• 그들은 정량적 학술 지표를 추구하기 위해 관련 없는 정보를 많이 인쇄합니다.
• 새로운 자료의 출시는 체계적이지 않습니다.
• 단순한 무지로 인해 "트렌디한" 최신 세부 정보를 놓치는 경우가 많습니다.
• 작성자에게 피드백을 주기는 어렵습니다.
• 업데이트된 판은 드물게, 비정기적으로 출판됩니다.

“동의하지 않으면 비판하고, 비판하면 제안하세요.”

가장 먼저 떠오르는 것은 엔진 기반 시스템의 구현이다. 미디어 위키. 예, 예, 모든 사람이 Wikipedia에 대해 들어본 적이 있지만 그것은 백과사전적 참조 특성을 가지고 있습니다. 우리는 교육 자료에 더 관심이 있습니다. 위키북 우리에게 더 잘 어울려요. 단점은 다음과 같습니다.

• 모든 자료의 의무적 개방성(인용: "여기 위키 환경에서는 교육 문헌이 공동으로 작성되고, 자유롭게 배포되며 모든 사람이 접근할 수 있습니다.")
• 사이트 규칙, 사용자의 내부 계층 구조에 대한 일부 의존성의 존재
  퍼블릭 도메인에는 수많은 위키 엔진이 떠돌고 있지만 대학 규모의 위키 시스템 구축 가능성에 대해서는 굳이 이야기할 필요도 없을 것 같습니다. 경험상 다음과 같이 말할 수 있습니다. a) 이러한 자체 호스팅 솔루션은 내결함성 문제가 있습니다. b) 시스템 업데이트를 잊어버릴 수 있습니다(매우 드문 경우 제외).

오랫동안 나는 상황을 개선하는 방법에 대해 아무 소용이 없다고 생각했습니다. 그러던 어느 날 지인이 오래 전에 A4에 책 초안을 인쇄했지만 전자 버전을 잃어 버렸다고 말했습니다. 나는 그것을 모두 전자 형식으로 변환하는 방법에 관심이 있었습니다.

이것은 상당한 양의 공식과 그래프가 포함된 교과서였기 때문에 널리 사용되는 OCR 도구(예: 애비 파인 리더, 절반만 도움이 되었습니다. Finereader는 일반 텍스트 조각을 생성하여 일반 텍스트 파일에 입력하고 장으로 나누고 모든 것을 MarkDown에 표시하기 시작했습니다. 분명히 사용됨 자식 협력의 용이성을 위해. 우리가 사용한 원격 저장소로 BitBucket, 그 이유는 무료 관세 계획으로 개인 저장소를 생성할 수 있었기 때문입니다(이는 GitLab). 수식 삽입을 찾았습니다. 매스 픽스. 이 단계에서 공식이 다음으로 변환되었기 때문에 마침내 "MarkDown + LaTeX"로 전환했습니다. 유액. PDF로 변환하기 위해 우리는 판독.

시간이 지남에 따라 간단한 텍스트 편집기만으로는 충분하지 않아 대체품을 찾기 시작했습니다. 그것을 시도했다 Typora 및 기타 유사한 프로그램. 그 결과 우리는 웹 솔루션에 도달했고 사용을 시작했습니다. 스택 편집, github과의 동기화부터 LaTeX 지원 및 댓글까지 필요한 모든 것이 거기에 있었습니다.

구체적으로 말하면, 그 결과 입력된 텍스트를 모아 WEB으로 변환하는 작업을 수행하는 간단한 스크립트가 작성되었는데, 이는 부끄럽습니다. 이를 위해서는 간단한 HTML 템플릿이면 충분했습니다.
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 {} ;

주목할만한 점은 스마트한 작업을 수행하지 않는다는 것입니다. 쉽게 탐색할 수 있도록 콘텐츠 헤더를 수집하고 LaTeX를 변환합니다.

현재 지속적인 통합 서비스(Circle CI, Travis CI..)를 사용하여 github의 담당자에게 푸시할 때 빌드를 자동화하는 아이디어가 있습니다.

새로운 것은 없습니다...

이 아이디어에 관심을 가지게 되면서 그것이 지금 얼마나 인기가 있는지 알아보기 시작했습니다.
이 아이디어가 소프트웨어 문서화에서는 새로운 것이 아니라는 것은 분명했습니다. 저는 프로그래머를 위한 교육 자료의 예를 꽤 많이 보았습니다. 예를 들면 다음과 같습니다. JS 코스 learn.javascript.ru. 나는 또한 git 기반 wiki 엔진이라는 아이디어에 관심이 있었습니다. 골룸

나는 완전히 LaTeX로 작성된 책이 있는 저장소를 꽤 많이 보았습니다.

출력

많은 학생들이 이전에 여러 번 썼던 메모를 여러 번 다시 작성합니다(손으로 쓰는 것의 이점에 대해서는 의문의 여지가 없습니다). 정보가 손실되고 매우 느리게 업데이트될 때마다 우리가 이해하는 것처럼 모든 메모가 기록되지는 않습니다. 전자 양식. 결과적으로 메모를 github에 업로드하고(pdf로 변환, 웹 보기) 교사에게도 동일한 작업을 수행하도록 제안하는 것이 좋을 것입니다. 이는 흡수되는 정보의 양을 늘리는 것은 물론, 어느 정도 학생과 교사를 "실시간" 경쟁적인 GitHub 커뮤니티로 끌어들일 것입니다.

예를 들어 제가 이야기했던 책의 첫 번째 장에 대한 링크를 남겨 두겠습니다. 여기에 그녀가있다. 그리고 여기에 대한 링크가 있습니다 랩.

출처 : habr.com