Quartz 4

Quartz配合GitHub实现知识网页化

3 min read

前置步骤

Quartz是什么？

  • Quartz 是一个开源工具，能够解析 Obsidian 笔记（支持双链、标签、图谱等）并生成网页。
    • 于是整个工作流就是使用Quartz解析Obsidian笔记，然后生成网页，使用GitHub储存编译工具以及相关笔记内容，并使用cloudflare将编译网页并发布

安装Quartz

  • 1.使用本地命令行操作(以管理员权限打开cmd，并进入为Quartz项目建立的目录)，从GitHub上下载（npm下载可能存在问题，因此直接clone整个仓库）

    git clone https://github.com/jackyzha0/quartz.git

    • 但是此时有可能github会被防火墙拦截，可以使用国内的镜像站

      git clone https://kkgithub.com/jackyzha0/quartz.git

    • 也可直接到GitHub项目目录直接下载整个项目，然后解压到工作目录
    • 在本地执行（cmd）

      cd quartz npm install npx quartz create 即可完成对quartz的安装，然后进行初始化，建立到Obsidian知识库的软链接（设置Obsidian的目录作为content），然后路径设置默认（default）

  • 2.本地运行网页生成

    • 运行如下命令，Quartz 会扫描刚才关联的 Obsidian 文件夹，将里面的 Markdown 笔记编译成 HTML 静态网页，并在本地启动一个临时网页服务器。

      npx quartz build —serve

    • http://localhost:8014 在此本地的临时网页可以看到生成的网页界面，但是需要在Obsidian目录下新建一个index文件，否则界面会是404
    • 按下ctrl + c可以结束

  • 3.通过cloudflare发布到互联网

    • 首先将quartz文件迁移到Obsidian仓库根目录下并将需要发布的内容放置在content目录下（index也要迁移）
    • 然后

Graph View

Backlinks