Clever Geek Handbook

教材の陳腐化を防ぐ

大学の状況について簡単に（個人的な経験）



そもそも、提示された資料は主観的なもの、いわゆる「内部ビュー」であると規定する価値がありますが、感覚によると、この情報はソビエト後のスペースの多くの州立大学に関連しています。







ITスペシャリストの需要により、多くの教育機関は関連するトレーニング分野を開設しています。 さらに、非IT専門職の学生でさえ、多くのIT関連科目、多くの場合Python、R、 恵まれない 多くの人は、パスカルのような「ほこりっぽい」学習言語を学ばなければなりません。







もっと深く見ると、すべてがそれほど単純ではありません。 すべての教師がトレンドに追いつくわけではありません。 個人的には、「プログラミング」の専門分野で勉強していたとき、関連する講義ノートがない教師がいるという事実に直面しました。 より具体的には、教師は、一部の学生が手書きしたフラッシュドライブの写真の要約に監視員を投げました。 WEBプログラミングに関するマニュアル（2010年）などの資料の関連性については言及していません。 専門学校や最悪の教育機関で最悪の事態が発生していることについては推測する必要があります。







要約すると：



  • 彼らは、定量的な学術指標を追求して、多くの無関係な情報を印刷します。
  • 新しい資料のリリースは組織化されていません。
  • 多くの場合、「傾向」と関連する詳細は、通常の無知のために見落とされます。
  • 著者からのフィードバックは困難です。
  • 更新版はまれで不規則です。




「私は同意しない-批判、批判-申し出..」



最初に思い浮かぶのは、 Media Wikiエンジンに基づいたシステムの導入です。 はい、はい、誰もがウィキペディアについて聞いたことがありますが、それは参照の脳卒中の性格を持っています。 教材にもっと興味があります。 ウィキブックスのほうが適しています。 欠点を特定できます：









長い間、私は状況を改善する方法について何も役に立たないと思っていました。 かつて、ある知人は、彼がずっと前にA4の本の下書きを印刷したが、電子版を失っていたと言った。 それをすべて電子形式に変換する方法を知りたいと思っていました。







それはかなりの数の数式とグラフを含む教科書だったので、 abbyy finereaderなどの人気のあるOCRツールは半分で助けました。 Finereaderはプレーンテキストを提供しました。これを通常のテキストファイルに入れ、章に分け、MarkDownですべてをマークアップしました。 明らかに、 gitは協力の便宜のために使用されました。 BitBucketをリモートリポジトリとして使用しました。理由は、無料の料金プランでプライベートリポジトリを作成できる可能性があるためです（これはGitLabにも当てはまります）。 数式の挿入では、 Mathpixが見つかりました。 この段階で、式がLaTeXに変換されたため、最終的に「MarkDown + LaTeX」の側面に変わりました。 PDFへの変換にはPandocを使用しました。







時間が経つにつれて、単純なテキストエディタが見逃され始め、代わりのものを探し始めました。 Typoraと他のいくつかの同様のプログラムを試しました 。 その結果、Webソリューションに取り組み、 stackitの使用を開始しました。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 "${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 {} \;


注目すべきことから、彼は巧妙なことは何もしていません。簡単なナビゲーションのためにコンテンツヘッダーを収集し、LaTeXを変換します。







現時点では、継続的インテグレーションサービス（Circle CI、Travis CI ..）を使用してgithubの担当者にプッシュするときに、アセンブリを自動化するアイデアがあります。







何も新しいものではありません...



この考えに興味を持って、私はそれが今どれほど人気が​​あるかを見始めました。

明らかに、この考えはソフトウェアのドキュメントにとって新しいものではありませんでした。 たとえば、JSコースlearn.javascript.ruのように、プログラマ向けのトレーニング資料の例がたくさんありました 。 Gollumと呼ばれるgitベースのwikiエンジンのアイデアにも興味があります







私はLaTeXで完全に書かれた本を含む多くのリポジトリを見てきました。







おわりに



多くの学生は、以前に何度も書いたメモを数回コピーします（手書きで書くことの利点は疑問ではありません）。情報が失われ、更新されるたびに、すべてのメモが電子形式ではありません。 その結果、githubで要約を記入する（pdfに変換、Webビュー）のはクールで、教師にも同じことが示唆されます。 これは、消化可能な情報の量の増加は言うまでもなく、生徒と教師をある程度「生きた」競争力のあるgithubコミュニティに引き付けるでしょう。







たとえば 、私が話した本の最初の章へのリンクを残しています。ここにあり 、ここにラップ自体へのリンクがあります。







More articles:


All Articles