简要介绍大学的情况（个人经历）
首先，值得指出的是，所介绍的材料是主观的，可以说是“内部视图”，但是根据感觉，这些信息与后苏联时期的许多州立大学有关。
由于对IT专家的需求，许多教育机构都开设了相关培训领域。 而且，即使是非IT专业的学生也有很多IT学科，通常是Python，R， 不太幸运 许多人必须学习Pascal等“多灰尘的”学习语言。
如果您看得更深，那么一切都不是那么简单。 并非所有的老师都跟上潮流。 就我个人而言，当我在“程序员”专业学习时，我遇到了这样的事实，即有些老师没有相关的讲义。 更具体地说，老师把看守交给了一些学生手写的闪存照片摘要。 我对诸如WEB编程手册（2010年）之类的材料的相关性完全保持沉默。 至于技术学校和最糟糕的教育机构中最糟糕的情况，还有待猜测。
总结：
- 他们打印大量不相关的信息以追求定量的学术指标。
- 新材料的发布是无组织的；
- 由于普遍的无知，往往忽略了“趋势”和相关细节；
- 与作者的反馈很困难；
- 更新的版本很少见且不定期。
“我不同意-批评，批评-提供..”
首先想到的是基于Media Wiki引擎的系统的介绍。 是的，是的，每个人都听说过维基百科，但是它具有参考的百科全书特征。 我们对教材很有兴趣。 Wikibooks更适合我们。 可以识别出以下缺点：
- 强制公开所有材料（引用：“在Wiki环境中，教育文献是联合编写的，可以自由分发并提供给所有人。”）
- 对网站规则，用户内部层次结构的某种依赖的存在
许多Wiki引擎都在公共领域中流通，但是我认为您甚至不需要开始谈论在整个大学范围内部署Wiki系统的可能性。 根据经验，我会说：a）这种自托管的解决方案具有容错能力； b）您可以忘记系统更新（很少有例外）。
长期以来，我一直在思考如何改善这种状况。 有一次，一个熟人说他很早以前就在A4上印刷了一本书的草稿，但是却丢失了电子版。 我想知道如何将其全部转换为电子形式。
这是一本教科书，其中包含大量的公式和图形，因此流行的OCR工具（例如abbyy finereader ）帮助了一半。 Finereader产生了很多纯文本，我们开始将它们放入纯文本文件中，分成几章，在MarkDown中标记所有内容。 显然，我们使用git是为了方便合作。 我们使用BitBucket作为远程存储库，原因是可以使用免费的收费计划创建私有存储库（对于GitLab也是如此）。 对于公式插入，找到了Mathpix 。 在这一阶段，随着公式被转换为LaTeX ，最终转到“ MarkDown + LaTeX”一侧。 要转换为pdf，请使用Pandoc 。
随着时间的流逝，一个简单的文本编辑器开始被错过，开始寻找替代品。 我尝试了Typora和其他几个类似的程序。 结果，我们来到了一个Web解决方案并开始使用stackitit ，从与github同步到LaTeX支持和注释的所有内容都在那里。
具体来说，结果是编写了一个简单的脚本 为此我感到ham愧 ，该任务完成了将键入的文本组装和转换为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课程learning.javascript.ru 。 也对名为Gollum的基于git的Wiki引擎的想法感兴趣
许多人看到了完全用LaTeX编写的书籍的存储库。
结论
许多学生多次复制他们以前写过的摘要的许多次（我不怀疑手工书写的好处），每次信息丢失和更新非常缓慢时，据我们了解，并非所有的摘要都是电子形式的。 结果，在github上填写摘要（转换为pdf，网络视图）将是很酷的，对教师来说也是一样。 这将在一定程度上吸引学生和教师加入一个“实时的”竞争性github社区，更不用说增加了可消化信息的数量。
例如，我留下了指向我所谈论的书的第一章的链接，这里是指向说唱本身的链接。