V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
my101du
V2EX  ›  分享创造

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

  •  
  •   my101du · 10 天前 · 997 次点击

    项目地址 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. 请先找个目录测试一下,不要直接在你的本地文档库运行,避免一些未检测到的问题。

    目前尚无回复
    关于   ·   帮助文档   ·   自助推广系统   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2712 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 24ms · UTC 05:35 · PVG 13:35 · LAX 22:35 · JFK 01:35
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.