Skip to main content

为什么需要一个技术库

从 2016 年起,尝试搭建技术交流网站。时至今日,在经历了各种平台的变迁之后,我在 Xcent's Wiki 上搭建了个人知识库,在此记录与分享知识。接下来,我将围绕本文主题展开详细阐述,并且让经验可复制,帮助到更多的人。

为什么我们需要一个技术交流网站?

知识需要归档沉淀。我们平时学习积累的知识,如果不及时进行整理归纳,很快就会忘记,比如golang option模式,没有归纳整理,可能很快就会忘记,并且已经做过的东西,没有地方去看,当你想要用的时候,也没办法马上回顾,合理的分类归档,既有利于日后检索与参考,又能避免在同一个地方踩坑。

用输出倒逼输入。若想快速掌握一门知识,最好的方法,就是用自己的话复述给别人听。如果你把能知识清晰地描述出来,那么你才算掌握它。有了持续的输出,当你不能清晰地描述知识时,就会通过主动学习来补充。从另一个方面来讲,这也促进了我们不断去进行阅读和输入。

桃源空间。在这一片自留地上,可以避开主流互联网上的纷争(特指某些乌烟瘴气的言论)。常把技术交流当作世外桃源一样的存在,这是一个可以静下心来耕耘的地方。

为什么技术文章要公开?

更加精致化的输出和整理。如果选择技术文章不公开,那么要求就变低了。我们对自己的技术的归纳整理,可能会慢慢变得随意,不会很注重规范和可阅读性。久而久之,技术文章会慢慢变成草稿箱,甚至可能看不懂自己先前写了些什么。

分享让思想碰撞。技术知识需要分享,在碰撞中可能出现新的火花。当别人遇到一样的问题时,也可以直接发自己写过的教程,这样既方便又酷。

提升个人品牌,遇见志同道合的人。持续维护技术知识库,收获志同道合的读者和朋友。也许他们也对我们使用的技术感兴趣,也在经营着一个博客。

工具的选择

至于知识库的选型,个人看重的主要是以下几点:

  • 基础功能:侧边栏可显示文章标题及其归属类别,主版面显示文章内容,内容支持 Markdown 语法,图片查看,内容与框架相互独立。
  • 搜索功能:搜索功能是类别归档的补充,有时候以大类别查找一个特定的知识点并不方便,但有了全站搜索就能直接传送到点。
  • 项目开源:知识库的平台一定要是开源的,因为闭源的项目,可能会因维护者个人或团队的原因停止更新或支持
  • 应易于搭建,便于部署与更新:知识库的架设不应该花过多的时间,内容更新的流程也不应过于复杂。
  • UI 简洁美观:为了阅读体验,版面 UI 应尽量保持清爽美观,且最好有夜间模式。

总结

临渊羡鱼,不如退而结网。在下一篇文章 基于 Docusaurus 搭建wiki 中,我将对如何自建知识库展开详细讲解。

参考与致谢

评论区