防止學習材料過時

簡單介紹一下大學的情況(個人經驗)

首先,值得指出的是,所提供的材料是主觀的,可以說是“內部觀點”,但感覺這些資訊與後蘇聯時期的許多國立大學相關。

由於對IT專業人員的需求,許多教育機構開設了相關培訓領域。 而且,即使是非IT專業的學生也接受了很多IT相關的科目,往往是Python、R,而不太幸運的學生則要掌握Pascal這樣「塵封」的學術語言。

如果你看得更深一點,一切就沒有那麼簡單了。 並不是所有的老師都能跟上「趨勢」。 就我個人而言,在學習「程式設計」專業時,我面臨著一些老師沒有最新講義的事實。 更準確地說,老師給校長發了一張學生手寫在隨身碟上的筆記照片。 我對 WEB 程式手冊(2010)等材料的相關性完全保持沉默。 還需要猜測技術學校和學校中發生了什麼 最壞中的最壞 教育機構。

概括如下:

  • 他們為了追求量化的學術指標而印製大量無關的資訊;
  • 新資料發布無組織;
  • 「流行」和當前的細節常常因為無知而被錯過;
  • 給作者回饋很困難;
  • 更新版本很少且不定期發布。

「不同意就批評,批評就建議…”

首先想到的是基於引擎的系統的實施 媒體維基。 是的,是的,每個人都聽說過維基百科,但它具有百科全書的參考性質。 我們對教育材料更感興趣。 維基教科書 更適合我們。 缺點包括:

  • 所有資料的強制開放(引用:「在維基環境中,教育文獻是共同撰寫、自由分發並可供所有人訪問。」)
  • 存在對網站規則、使用者內部層次結構的某種依賴
    公共領域有很多 wiki 引擎,但我認為甚至沒有必要開始談論在大學規模上部署 wiki 系統的可能性。 根據經驗,我會說:a)此類自託管解決方案存在容錯能力; b) 您可以忘記系統更新(極少數例外)。

我想了很長一段時間,也沒有想到如何改善這種情況。 然後有一天,一個熟人說,他很久以前用A4紙印了一本書的草稿,但電子版遺失了。 我對如何將其全部轉換為電子形式感興趣。

這是一本包含大量公式和圖表的教科書,因此流行的 OCR 工具,例如 艾比罰款閱讀器,只幫助了一半。 Finereader 產生了一些純文本,我們開始將其輸入到常規文本文件中,將它們分成章節,並在 MarkDown 中標記所有內容。 明顯用過 混帳 為了方便合作。 作為我們使用的遠端儲存庫 到位桶,原因是能夠創建具有免費關稅計劃的私人存儲庫(對於 GitLab)。 找到公式插入 Mathpix。 這個階段,我們最終轉向了“MarkDown + LaTeX”,因為公式被轉換成了 膠乳。 為了轉換為 pdf,我們使用了 Pandoc.

隨著時間的推移,一個簡單的文字編輯器變得不夠了,所以我開始尋找替代品。 試過了 Typora 和其他幾個類似的程序。 結果,我們找到了一個網路解決方案並開始使用 Stackedit,您需要的一切都在那裡,從與 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課程 學習.javascript.ru。 我也對基於 git 的 wiki 引擎的想法感興趣,稱為 咕嚕

我看過很多儲存庫,裡面有完全用 LaTeX 寫的書。

產量

很多學生會多次重寫筆記,他們之前寫過很多很多次(我不質疑手寫的好處),每次資訊都會丟失並且更新得很慢,正如我們所理解的,並非所有筆記都在電子形式。 因此,將筆記上傳到 github(轉換為 pdf、網頁視圖)並讓老師也這樣做會很酷。 這在一定程度上會吸引學生和老師加入「活生生」競爭激烈的 GitHub 社區,更不用說增加吸收的資訊量了。

舉個例子 我會留下我正在談論的書的第一章的鏈接, 她在這 這是它的連結 饒舌.

來源: www.habr.com

添加評論