诞生与初衷

站长是一个不务正业、爱折腾的人，我是这样介绍自己的：“An electrical student with poor academic performance. I love literature and life more.”所以【洛理指南】也算是折腾项目。

一次偶然的机会，在GitHub上找到了这样一个项目：【NUC-Courses】。在惊叹作者nb的同时，也是一通搜索，寻找属于咱洛理的学习生活指南，无果，失望之余也有一丝暗喜，那就由我来做那个英雄吧hhh 。

【洛理指南】的雏形于今年02-23诞生，其开发历程展示在我的 blog ，以导航+文档+社区 的形式展现，导航Fork自翠翠 开源的 Life-in-NJU ，可作为浏览器主页，添加一些在学校常用到的网址，文档使用了轻量的amwiki ,也是本项目的核心部分，具备了三种典型的知识形态：结构化、碎片化和体系化，适合长期做内容产出。至于社区论坛，可作为wiki的补充及交流使用，起初是选定Discuz! Q或者Discuz！X来做社区，但是准备过程不出意外的阻碍重重，包括域名备案、小程序审核等等，曾一度有申请营业执照的冲动。

当初选定amwiki做在线文档的时候考虑了很多方面，诸如简洁的UI或许会更受读者欢迎，超低的开发门槛更适合多人协同创作等等，在编写文档的过程中又发现了些许小小的毛病，这使得我又诞生了一个想法：在Wiki中嵌入一个评论系统，这样就可以摒弃Discuz! Q，专心运维Wiki了。当然一个评论系统肯定无法与论坛社区比拟，但做社区的初心就是文档的补充和交流，用评论代替社区也是完全ok的。

对于洛理指南来说什么是一个好的文档呢？其实我也在不断的寻找和思考，不过我觉得它至少要结构清晰、管理方便，在查找问题点的过程中可以快速的找到，更重要的是可以便捷的进行反馈交流。或许我的目光局限于wiki相关的解决方案，忽略了项目启动的初衷，明白了这点思路也就开阔了。

最终决定采用Typecho+Handsome的方式把文档做出来（谁说的blog不能做Wiki？Handsome的强大足以支撑洛理指南文档的需求！），也就是现在所展现的页面。

你的大学，可以很精彩。

Handsome的强大之处不仅仅在于漂亮的UI设计，它对于创作者而言更是一款写作利器，三种markdown编辑模式应对不同使用场景，高阶MD用户能够专注于内容创作，小白也可以无缝使用，这里 有一份编辑指南可供参考；它对于阅读者来说能完美替代amwiki的高效和简洁，内置ajax 可为用户提供更友好、交互性更强的搜索体验，视频、音乐及mathjax公式更是弥补传统Wiki的不足。

在handsome原有的基础上我对其进行了魔改，除了美化还增加了第三方登录、评论提醒、之后会考虑引入PWA来优化移动端的体验、关闭Ajax搜索部署更高效的PostgreSQL全文检索等等。在访问速度方面文档站已经套上了腾讯云CDN，项目首页导航之后会放在腾讯云开发上面，访问速度不用担忧。（如果哪天发现访问不了了就是被大佬打了，小生在此求饶！）

站长缺乏艺术细胞，只愿用拙劣的文笔，撰写内心最真诚的想法和建议，但是个人精力始终有限，未来本站将会邀请本校的小伙伴一起参与文档编写的工作！在这里我将展示项目进度以及参与编写人员的名单，如果你也是喜欢折腾，有意愿参与文档编写的工作，热烈欢迎加入我们！

不以以下为目的的参与工作都是耍流氓！

• 【洛理指南】属个人兴趣项目，不具备、也不会有组织或社团的性质！！！
• 参与编写及维护的过程，不能抱有以利益为目的想法，过程仅为兴趣使然！

• 小白如有兴趣也可以参与，你我一起可以学到：

  • 写文章和论文时摆脱格式混乱、公式困难的烦恼（LaTex和Mathjax基础语法、Markdown高阶语法）
  • 学会总结生活日常、方法经验，学会整理各种资源（锻炼写作技能）
  • 交流云计算的各种玩法、体验IT运维的快乐、教你白嫖服务器及域名（你也可以拥有自己的站点哦）
  • ······（更多乐趣快来体验吖！）
• 同时诚邀行内大神对本项目提出宝贵的建议！

站长的联系方式在关于页哦！

项目相关

鸣谢

• 开发及编辑人员转移到了友链，欢迎去踩呀！
• 赞助人员名单在赞助页，感谢支持！
• 珍惜当下，且行且惜

【洛理指南】使用许多开源产品，感谢每一位开源作者及参与者，我也会努力做好这款产品，尽管是个既简单又困难的过程。简单是因为网站本身没有什么技术难度，换做任何有想法的人都可以比我做得更好，困难在于努力做到对别人有价值 ，始终坚持输出，做起来很困难，更重要的是螺旋上升，不断迭代，产出精品。

项目历程

项目进展