跳到主要内容

提高网站开发效率的思路

· 阅读需 3 分钟
灵魂信息
网站作者

目前使用 docusaurus 创作速度太慢了,下面我总结了一些原因,以及改进方案。

原因总结

当前创作慢的主要原因是在文档格式控制上消耗太多精力:

  1. 编辑器效率低。直接使用 vscode 编辑 markdown 的效率很低。
  2. 排版耗时。一是缺乏前端基础,搞搞排版花了时间。使用 docusaurus 的这两个月以来经常卡壳,一些我觉得比较好的页面样式也难以实现。
  3. 构建和发布耗时。随着文档数量的增加,每次 build 的时间也越来越长了。
  4. 预览耗时。虽然 npm run start 可以启动预览窗口,但是来回切换窗口真的和耗时,很违反直觉。所以依然需要 所见即所得的 markdown 编辑器。

如何提高编辑体验和效率

方案一:思源笔记与docusaurus混合使用

  • docusaurus:做主页,负责导航和博客相关功能
  • 思源笔记:编辑知识文档,导出后给 docusaurus 使用

此外,思源笔记还可以静态站点

通过 NodeToWebsite插件 将文档集导出为静态网站,部署为在线知识库的子域名。

导出演示

缺点,导出的静态站点是固定排版格式的,不能自定义排版样式。

方案二:使用 vscode markdown editor 插件

关键词 mark editor,可以搜索到很多 markdown 编辑插件。

  • Markdown Editor:这些插件中比较好用的,支持所见即所得,对排版有优化。

Markdown Editor

  • Mark Sharp:看起来不多

Mark Sharp

方案三:使用 typora 等编辑器

本来对 typora 抱有重望,结果入手后发现并不是那么好用,不加载图床(image load failed)真的很恼火!

关于 image load failed 这个问题在2018年就有反馈,居然至今依然存在!

使用CD/CD提高发布效率

引入 CI/CD ,编辑文章后,自动 build 和 push 网站。