主持人 > 博客 > 网络新闻 > 防止学习材料过时

防止学习材料过时

简单介绍一下大学的情况（个人经历）

首先，值得指出的是，所提供的材料是主观的，可以说是“内部观点”，但感觉这些信息与后苏联时期的许多国立大学相关。

由于对IT专业人员的需求，许多教育机构开设了相关培训领域。 而且，即使是非IT专业的学生也接受了很多IT相关的科目，往往是Python、R，而不太幸运的学生则要掌握Pascal这样“尘封”的学术语言。

如果你看得更深一点，一切就没有那么简单了。 并不是所有的老师都能跟上“趋势”。 就我个人而言，在学习“编程”专业时，我面临着一些老师没有最新讲义的事实。 更准确地说，老师给校长发了一张学生手写在闪存盘上的笔记照片。 我对 WEB 编程手册（2010）等材料的相关性完全保持沉默。 还需要猜测技术学校和学校中发生了什么 最坏中的最坏 教育机构。

概括如下：

  • 他们为了追求量化的学术指标而印刷大量无关的信息；
  • 新材料发布无组织；
  • “流行”和当前的细节常常因为无知而被错过；
  • 给作者反馈很困难；
  • 更新版本很少且不定期发布。

“不同意就批评，批评就建议……”

首先想到的是基于引擎的系统的实施 媒体维基。 是的，是的，每个人都听说过维基百科，但它具有百科全书的参考性质。 我们对教育材料更感兴趣。 维基教科书 更适合我们。 缺点包括：

  • 所有材料的强制开放（引用：“在维基环境中，教育文献是共同撰写、自由分发并可供所有人访问。”）
  • 存在对网站规则、用户内部层次结构的某种依赖性
    公共领域有很多 wiki 引擎，但我认为甚至没有必要开始谈论在大学规模上部署 wiki 系统的可能性。 根据经验，我会说：a）此类自托管解决方案存在容错能力； b) 您可以忘记系统更新（极少数例外）。

我想了很长一段时间，也没有想到如何改善这种情况。 然后有一天，一个熟人说，他很久以前用A4纸打印了一本书的草稿，但电子版丢失了。 我对如何将其全部转换为电子形式感兴趣。

这是一本包含大量公式和图表的教科书，因此流行的 OCR 工具，例如 abbyy finereader，只帮助了一半。 Finereader 生成了一些纯文本，我们开始将其输入到常规文本文件中，将它们分成章节，并在 MarkDown 中标记所有内容。 明显用过 混帐 为了方便合作。 作为我们使用的远程存储库 到位桶，原因是能够创建具有免费关税计划的私人存储库（对于 GitLab）。 找到公式插入 Mathpix。 这个阶段，我们最终转向了“MarkDown + LaTeX”，因为公式被转换成了 胶乳。 为了转换为 pdf，我们使用了 潘多克.

随着时间的推移，一个简单的文本编辑器变得不够了，所以我开始寻找替代品。 试过了 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。

目前有一个想法是在向 github 上的代表推送时使用持续集成服务（Circle CI、Travis CI..）来自动化构建

没什么新鲜事...

对这个想法产生兴趣后，我开始了解它现在有多流行。
显然，这个想法对于软件文档来说并不新鲜。 我见过不少程序员教材的例子，例如：JS课程 学习.javascript.ru。 我也对基于 git 的 wiki 引擎的想法感兴趣，称为 咕噜

我见过很多存储库，里面有完全用 LaTeX 编写的书籍。

结论

很多学生会多次重写笔记，他们之前写过很多很多次（我不质疑手写的好处），每次信息都会丢失并且更新得很慢，正如我们所理解的，并非所有笔记都在电子形式。 因此，将笔记上传到 github（转换为 pdf、网页视图）并让老师也这样做会很酷。 这在一定程度上会吸引学生和老师加入“活生生”竞争激烈的 GitHub 社区，更不用说增加吸收的信息量了。

例如 我会留下我正在谈论的书的第一章的链接， 这是 这是它的链接 说唱.

来源： habr.com

添加评论