vide coding 写了一个 Docsify 辅助工具,一键从当前文档生成侧边栏导航 + 一键部署 CloudFlare Pages

20 天前
 my101du

项目地址 https://github.com/my101du/docsify-helper

背景

我日常用 Obsidian 来管理自己的技术笔记,这些 markdown 格式的文件都放在本地一个目录里。 得益于这个软件的快速、稳定、插件丰富,已经让我放弃了 Evernote/Joplin 等等一众软件。

之前使用 Hexo / Hugo 等方式来生成博客在线访问,都需要先把 mardown 编译成 HTML 后才能提交,步骤繁琐时间漫长,于是就切换成了 Docsify ,能够直接解析 markdown 文件,只需要直接定期把目录推送到 CloudFlare Pages 就行了。

这样保持源文件,方便对笔记的维护。

由此带来两个问题:

  1. 每次都要启动 CloudFlare Wrangler CLI 命令行来跑一次 deploy, 略微繁琐
  2. Docsify 自己的 cli 生成 sidebar 导航经常失败

实现功能

  1. 读取指定目录下所有 markdown 文件,生成 sidebar (支持多层级),目前只支持一个唯一的放在根目录的文件,不支持每个子目录放一个 (对 Docsify 无法支持文件名含有空格的问题,直接进行了转义)
  2. 图形界面一键发布到 CloudFlare Pages, 省去打开命令行调用的时间

注意事项

  1. 请先找个目录测试一下,不要直接在你的本地文档库运行,避免一些未检测到的问题。

1133 次点击
所在节点    分享创造
0 条回复

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://ex.noerr.eu.org/t/1155044

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX