目前我们的文档站点(https://docs.halo.run)使用的 wiki.js,此文档程序非常优秀,但是有几个痛点导致我们产生切换文档程序的想法:
不支持锚定位, 比如访问 https://docs.halo.run/install/prepare#%E5%90%8D%E8%AF%8D%E8%A7%A3%E9%87%8A 无法定位到具体位置。 支持,但是不方便复制,以及动画过于啰嗦。
- 略臃肿,很多功能是我们目前用不到的,而且页面的资源体积也较大,访问不是很顺畅。
- 动态站点,意味着会占用不少服务器资源,如果我们使用静态生成器,可以节省部分服务器资源。
- 不方便对主题进行自定义。
- 搜索体验没有 Algolia DocSearch 好,虽然 Wiki.js 支持 Algolia,但是有一个 bug 没有解决,无法使用。
所以我们打算使用更加轻量级的 Docusaurus,目前还未正式使用,还在测试和编辑中。其中的内容和结构会和原文档保持一致,但部分页面的地址可能会发生改变,我们会对对应的地址做重定向处理。
测试文档地址:http://docstest.halo.run/