Skip to main content

提高网站开发效率的思路

· 3 min read
灵魂信息
灵魂信息
网站作者

目前使用 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 网站。