Quartz & Obsidian | 总之又有新文具
2433 字
标签 # Obsidian # Quartz
分类 为沙滩插上太阳伞 ,

先放上成果：Lyin’s Room 。

前段时间在象上刷到Quartz ，算是一个支持Obsidian双链玩法的博客？点了收藏之后今天适逢周六，刚好呢又到了晚上十一点（人家的一个不干正事又不打算睡觉的时间），虽然呢也没有什么笔记要整理，但是就是看到漂亮的东西想试一试。搭建并不算难，而且很漂亮！于是来写一下笔记记录过程。

第一步：BGM - In Motion启动！Let the hacking begin！

首先来讲一下我对Quartz的使用感受。它的框架也是基于Hugo啦，这直接降低了我的心理负担，因为算是一个很熟悉的东西。

它默认支持：

  1. 搜索
  2. 本地预览
  3. 夜间模式
  4. 文章目录（可以修改层级和目录序号的显示）
  5. 支持Obsidian的双链玩法，直接打开Obsidian就写！无痛保存！
  6. 最近的文章
  7. 文章Tag
  8. Front-Matter（这好像并不是必须的）

但是它的缺点是本身并不支持归档（Archive）的功能。于是作为归档功能的替代，在此隆重向大家介绍我用Obsidian时常用的MOC（Map of Content），算是一种整理思路。轻轻地推荐这篇最早让我了解到Map of Content的一篇文章：Obsidian · 网课学习笔记整理 From Seviche.cc 。

其实概括而谈MOC就是放弃用Obsidian本身的文件夹功能给笔记归类（并非必要，只是我很懒得整理），直接建立一个索引页，里面用双链功能创建文章，索引页就像归档或总目录一样，带你去任何一页笔记。

而Quartz的使用完全适配这种笔记管理思路，在Quartz中，_index.md文件就是博客主页，可以被任意编写，因此可以作为索引/文章目录页使用。

注意：我基本没有什么计算机基础，以下内容不保真！有疑问的话建议去原作者的仓库底下提Issue :D

你需要有些什么

  1. Github账号
  2. Go  环境(>= 1.16) 。（这个东西我都不知道我为什么会有）
  3. Hugo
  4. Make工具。因为我也缺少这个所以后文有关于它的安装与配置。

那么就开始吧！

基本上只需要跟着作者的Setup一步步走下来。

  1. Fork作者的仓库： Quartz Repository
  2. Clone仓库到本地，可以用Github Desktop也可以敲命令行：
1

git clone https://github.com/YOUR-USERNAME/quartz

于是此时你已经有了一个quartz文件夹了。

你所有的内容都可以在quartz/content中找到。里面默认有notes、private、templates三个文件夹，顾名思义分别存放笔记、隐私笔记（不显示）、模板文件夹。

但是你的笔记并不一定需要放在/content/notes中，完全可以放在/content下。

同时里面还有_index.md文件，它里面的内容直接展现为播客主页。

Obsidian配置

  1. （可选）新建一个笔记库，或者直接将你的笔记库移动到/content文件夹。
    1. 但假设这么做了，文件夹层级目录则为/content/Vault，你可以用Obsidian在里面新建、修改笔记。
    2. 那么此时就涉及一个问题，可是_index.md文件是放在/content目录中的，这意味着你在Obsidian中见不到它。
    3. 可是按照我的笔记使用逻辑，我希望博客主页(index.md)直接作为我的笔记索引页，放满我的笔记双链（幻想），如果它不能在Obsidian里修改，那就会很不方便。
  2. 我希望一打开笔记就能修改所有东西。因此我是这么做的：直接将我的Obsidian笔记库位置放在了根目录quartz中，并将上述三个文件夹、一个_index.md剪切到了笔记库中，删掉quartz/content，并把笔记库重命名为content。
  3. 在Obsidian的设置 > 文件与链接中打开始终更新内部链接，内部链接类型：基于仓库根目录的绝对路径。

安装hugo-obsidian

需要确保你已经安装了 Go  (>= 1.16) 。

1

go install github.com/jackyzha0/hugo-obsidian@latest

如果遇到报错：

1

go install: github.com/jackyzha0/hugo-obsidian@latest: module github.com/jackyzha0/hugo-obsidian: Get "https://proxy.golang.org/github.com/jackyzha0/hugo-obsidian/@v/list": dial tcp 142.251.42.241:443: connectex: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.

解决办法： 执行命令go env -w GOPROXY=https://goproxy.cn

安装Hugo

  1. Install Hugo | Hugo
  2. 运行命令行：
1
2

cd <quartz文件夹地址>
make serve
  1. 如果此时显示'make'不是内部或外部命令，也不是可运行的程序 或批处理文件，那么就需要安装工具make。
  2. 参照make不是内部或外部命令，也不是可运行的程序或批处理文件解决方案 ，逐步安装完毕并配置好PATH环境变量。
    1. 假如对安装有疑惑的话可以参考：MinGW下载和安装教程 的前六步。
    2. 关于环境变量的配置，请不要仅安装在当前的用户变量中，而是安装在系统变量中。
    3. 确认上述步骤无误，如果此时执行命令行make serve仍显示不是内部或外部命令的话，将MinGW\bin下的mingw32-make.exe重命名为 make.exe。
  3. 执行命令行后，博客生成成功，访问http://localhost:1313/本地预览。

发布你的页面

全程按照Deploying Quartz to the Web 操作，完全不知道原理，我至今也没真正搞懂Github分支是什么，不知道为什么我本地所作的一些修改全都安静无缝地Push到了Hugo分支里。但它就是成功了（成功了）。

我就这样静静地操作到了最后一步绑定域名。

关于子域名我是这么干的：

  1. 在仓库根目录Add file，写一个文件名为CNAME且没有后缀的文件。在里面写入你要绑定的域名：c.gregueria.icu。
  2. 然后去DNS设置里，子域名记录，记录类型为CNAME， IP地址/目标主机：你的GitHub用户名.github.io`。
  3. 然后去Setting > Pages > Custom domain把你的域名写好，保存。

大功告成！

其余的配置

在config.toml和/data/config.yaml和/data/graphConfig.yaml中可以修改网站基本配置。

尚未解决的问题

  1. 这个分支到底是怎么回事啊。
  2. 网站证书无效，搜了一圈教程都没能解决，现在它还是一个很不安全的网站呢。并且虽然我什么也没动但是网站时常掉线，感觉是我绑定域名那一步有些问题。
  3. 看到有人的网站装修（jzhao.xyz ）很漂亮，这个也太炫了吧？！！！！
  4. 人家哪有那么多笔记要放啊？！！！