#工具

记录一次博客搬家：为什么离开 Quartz，怎样用 Astro 保留 Obsidian 的双链体验，以及重新掌握博客编译过程的取舍

[!attention] 写在前面这篇文章主要讲述如何使用基础的 Obsidian 记笔记，管理知识库等，不涉及任何功能型插件；可以查看 来查看我使用的一些插件。

[!danger] 注意以下的教程都建立在屏幕分辨率为 4K 的情况下，截图时会导致图像很大 截图工具 首先，我们切换截图工具，不再使用传统的 alt + ctrl + a 与 win + shift + s 我们在微软商店中下载 Snipaste，如下图所示： [!tip]如果你使用 Mac，也可以使用 HomeBrew 下载这个软件，然后将截图键设置为 Option + Q（我的设置） 这个应用能够使得截图时不已分辨率为单位，而是选中的区域多大，像素长宽就是多大，此后，我

[!info] 前言插件来来去去，更换了很多，最终留下来的比较趁手的其实也就几个，这里一一介绍 目前的外观如下： 外观美化 主题 主题本人用过的有（按照时间顺序给出） Blue TopazBorderPrimaryVelocity 目前正在使用的是 Velocity，原因是与 Mac 非常适配，前面的主题如果自己花心思配置的话，也是很好看的（和个人审美有关系，这不是本文的重点） [!important] 重要提示上述主题都需要通过下文中的 插件中的 Style Setting

前期提要 [!note] 动机由于一直以来部署项目都十分麻烦，一下子有测试服务器一下子有正式服务器，正式生产环境的服务器还没办法使用 ip 访问，域名合法前也没办法访问网站。

[!warning] 已弃用该插件（Obsidian Copilot）已被我弃用，本文仅作存档，不再维护。

[!important] 重大更新由于本人更换了 MacOS，因此目前的同步方式为 iCloud，与 Windows 的更新方式为 Github，参考 因此请酌情参考下文的内容 同步工具 我们可以参考 Obsidian 官方的文章 来查看一些同步方法，例如： 其中，Obsidian Sync 为官方的付费同步模式 [!attention] 更新注意建议使用 S3 或其他 WebDav，本人现在使用的是 iCloud + Git 的同步方法也就是把 Obsidian 的文件夹设

前情提要 由于在 Obsidian 中，虽然我有不被 git 追踪的文件夹（私有文件夹），但是这也限制了我 的需求（因为 Windows 上的 iCloud 十分难用） 因此，我们期望工作流程如下： 在私有仓库中更新博客在公开仓库中拉取博客内容并自动构建 本质上，我们将公开仓库作为了一个博客生成器，专门用来触发 CI GitHub 与本地设置 GitHub 首先，需要申请一个 个人 Token，名字自由命名，例如 BLOGS，但是记得复制这个 Token，例如 <TOKEN>

问题记录 [!attention] 前置知识注意，这里我们使用的是 Gin 这个 web 框架开发的后端，我们使用了 gomail.v2 来发送文件，template 来渲染我们的 html 文件（也就是要发送的邮件内容），函数如下所示 // In package model type MailInfo struct { Subject string Code string ToWho string } func sendEmailVerificationCode(data

[!note] 已归档本笔记记录旧站（Quartz）的构建与配置，现已归档。

[!hint]这里的日常开发就不包括如何写各类公开课的实验了，最简单的方法就是使用 ，在 WSL 里随便玩，反正环境坏了也可以重装 日常开发 [!tip] 2025-10-20 更新已经换到了 MacBook Air M4 做开发，所以少了 Linux 到 Windows 的同步，但是服务器到本地的同步还是存在的，因此下面的内容也不算过时 在 MacOS 与 Linux 就可以使用 rsync -av 来做增量同步了 由于我在两台设备上进行开发，虽然都是 wsl 环境（写 C

[!info] 写在前面只是心血来潮，想要更换一下 Quartz 的包管理器以及打包工具，之前一直听说 Bun 运行时的速度快，想着在本地预览的话应该会比 Node 更快，所以替换一下 本地更改 首先需要安装一下 bun ，我是用的是 MacOS （根据官网给出的命令安装即可） 然后，我们需要更改 quartz 的几个文件： package.json 这里主要是更改 scripts 中的内容： "scripts": { "quartz": "./quartz/bootstra

[!attention] 免责声明本文的内容非原创，只是转载与记录，防止自己老是忘记命令还得去查 前期提要 这篇文章主要记录使用 OrbStack 后， 时导致的磁盘空间消耗过多的解决方法 [!hint]说是解决方法，其实只是一次搬运而已 这个问题在 Github 上有人提到，并且在评论的最下方给了一个暂时的解决方法 解决方法 容器、镜像与卷的清理，都可以通过 OrbStack 的图形化界面来进行删除，但构建时的缓存只能通过命令来删除： docker builder prun

本地环境 使用的设备均为 Windows11 系统： 本地台式：14700KF + 4080S + 32G + 2TB本地笔记本：13th-i5 + 16G + 1TB 一般而言都是在台式机上干重活（相当于会跑一下代码测试一下），笔记本对我来说是一个 ssh 工具，或者是简单写一个不吃配置的代码的工具 开发环境使用的是 WSL2-Ubuntu-24.04 + Windows，其中： WSL2 主要用来写科研代码，因为经常用到 C++/C， Rust， Python 和 Bas

这里主要是一些赛博暖暖的内容，不涉及任何功能上的配置 主题 Github Theme Dark Default，高亮如下所示： [!tip]之前使用的主题是 Tokyo Night，也很好看，换这个是因为在我之前的笔记本上，感觉完全的黑色+透明度更适合那个 Archlinux 的桌面背景（ 图标主题 Material Icon Theme，这里主要是用来更好的显示文件夹的图标，看起来花哨一些（ 字体 中文 霞鹜文楷，代码 Monaco，配置的方法如下：打开设置后（Ctrl +

[!warning] 已弃用该方案（picgo-plugin-compress-next 压缩插件）在 PicList 版本升级后已失效，本文仅作存档，不再维护。

文献搜索 这个通常没有什么好用的工具（如果 Google 算工具的话），一般是在网站上找，这里推荐几个好用的网站和一些浏览器插件 网站 出版社的官网： 好处是省事，坏处是不知道自己学校买没买版权（ 如果买了的话，可以通过 Access via Institute 来获取访问权限并下载，因为有些文章可能只能在官网上下载一些教授的主页 典型的例子：https://leria-info.univ-angers.fr/~jinkao.hao/ 甚至可以在主页上找到文章的代码/可执行文

[!tip]考虑到代码基本都在服务器上跑，为了兼容性，在本地开发的时候最好也使用 Linux 或 MacOS环境进行开发 一些文档帮助 关于 WSL 的下载，安装和使用，在微软的 官方文档 中有详细的介绍。

在这里推荐一些 AI 插件，用于增强 VSCode 的代码体验 [!attention] Out-of-Date由于本人已经很久没有用 VSC 了，插件的认知停留在 2025-01 左右的时间 Github Copilot 如果你已经申请了 Github 的黄书包（也就是教育版本），那么你可以免费使用 Copilot ，这是一个 LLM 代码补全工具，补全程度甚至可以自己写代码，有了这个，程序员只需要当无情的 Tab 键入机器就行。

Docker 的一些好处 使用 docker 的好处有很多，最大的特点就是你可以拿到一个速度并不算很慢，而且能够随便乱玩的 Linux 系统，而不是在自己的生产环境上乱玩。