Tianhao's Blog

环境配置#

本博客使用基于Mizuki主题模板，进行了少量更改并在EdgeOne Pages上进行了部署。原作者的GitHub仓库如下。

可以从 Mizuki主题官方文档中获得该博客需要的环境配置为Node.js >= 20，pnpm >= 9以及Git（Git用于版本管理）。所以我们首先需要配置这些环境。

Node.js配置可以去Node.js官网下载并安装最新版本的 Node.js。建议使用 LTS 版本。安装完成后在终端中运行如下命令以查看安装的版本。

1
node -v
2
npm -v

如果能够显示版本号，那么即为安装成功。然后，我们通过npm安装pnpm，直接在终端中运行如下命令即可。

1
npm install -g pnpm

我们仍然可以通过-v来验证是否安装成功，在终端中运行以下命令。

1
pnpm -v

用于版本管理的Git也可以从Git官网安装，安装完成后使用以下命令验证是否安装成功。

1
git --version

本地运行#

首先，我们可以使用Git将项目克隆到本地，并将路径转为博客目录。

1
git clone https://github.com/matsuzaka-yuki/mizuki.git
2
cd Mizuki

然后，我们在这里安装项目依赖pnpm，在终端中运行如下命令。

1
pnpm install

然后我们可以使用如下命令启动开发服务器。

1
pnpm dev

这样我们就可以在本地端口http://localhost:4321中查看到自己克隆下来的博客了。

博客主题的更新#

当上游的博客主题更新了新功能后，我们应该如何将这些新功能迁移到我们的博客主题中呢？首先我们可以检查本地仓库与上游仓库的关系，以便我们可以从上游仓库中获取更新信息。

1
git remote -v

博主这里显示的是这样的，可以看到upstream显示的是上游模板仓库，这样我们可以将模板的更改合并到我们的博客中了。

1
origin  https://github.com/QTH1225/MizukiBlog.git (fetch)
2
origin  https://github.com/QTH1225/MizukiBlog.git (push)
3
upstream        https://github.com/matsuzaka-yuki/Mizuki.git (fetch)
4
upstream        https://github.com/matsuzaka-yuki/Mizuki.git (push)

然后获取上游仓库的信息以供查看

1
git fetch upstream
2
git branch -r | grep upstream/  # 查看所有上游远程分支

获取到上游仓库更改后进行合并

1
git fetch upstream        # 确保获取最新更改
2
git merge upstream/main   # 如果上游分支是 main
3
# 或者
4
git merge upstream/master # 如果上游分支是 master
5
# 或者使用你确认正确的分支名

当然，有时候上游的更改并不能令我们满意，这时候可以在合并冲突的时候保留自己的更改（例如各类API、个人信息等），这样可以让我们避免在更新后需要重新设置重复的信息。

content目录下的设置#

首先我们需要知道，Obsidian的管理单位是“库”，你可以为不同用途的笔记创建多个库。而Mizuki的所有博客文档都放在src/content下，所以我们直接选择content文件夹作为我们的库。

插件，让Obsidian更加智能#

但是Obsidian的默认功能往往显得不够智能，甚至只能称作“Markdown编辑器”而不是“笔记管理软件”，我们需要一些插件才能发挥它的功能。Obsidian中的插件分为核心插件与第三方插件，核心插件主要提供一些基本的功能（例如白板、知识图谱），而第三方插件则提供一些更高级的功能（例如git、LaTeX snippets）。这些第三方插件被统一存放在与仓库同级的.obsidian文件夹中，当你需要迁移你的插件时可以直接将该文件夹复制到新仓库中即可。

这里介绍博主常用的一些插件，由于插件较多所以此处仅介绍影响操作和效率的插件，美化插件与部分功能插件不在此列。需要注意的是，当你下载了你所需要的插件后，请在.gitignore文件中添加以下行以忽略.obsidian文件夹的上传，否则可能由于含有密钥而上传失败。

1
.obsidian

1. i18n插件

该插件可以将其他插件的英文配置界面进行翻译。所以博主首先推荐安装这个插件以对其他英文插件进行汉化。但是该插件没有上线Obsidian的插件市场和PKMER的插件市场，只能通过链接进行下载。这里给出项目地址以供下载。

2. Templater插件

该插件主要解决创建新博客时formatter经常遗漏的问题，因为Mizuki可选的formatter很多。有些是构建页面必要的条目而有些是可选的条目。这时候可以使用该插件在文件夹下创建一个模板文件，以后每次新建文件都会以该文件为模板进行生成，而不需要从头开始编写formatter。

博主的模板文件是Z-Template.md，这是由于在Obsidian中自定义文档的显示顺序比较麻烦，所以可以在你想要置顶的文档开头加上00前缀，想置底的文件开头加上99前缀。这样在按照字母顺序排列时就可以顺利地置顶或者置底了，文件内容如下。

1
---
2
title: Template
3
author: Qin Tianhao
4
description: Your description Here
5
published: 2025-01-01
6
tags:
7
  - Template
8
  - Mizuki
9
category: Technology
10
draft: true
11
---

3. LaTeX Suite插件

关于如何在笔记中快速输入公式，那就不得不提Gilles Castel大佬，他配置的Vim+Snippets具有恐怖的输入效率。但是配置比较麻烦而且不太适合国人笔记习惯，而该插件主要解决Markdown中LaTeX公式快速输入的问题，通过设置触发快捷键来进行LaTeX公式的快速输入。特别适合用Obsidian做理工科笔记的同学，该插件的配置可以参考LaTeX中的Snippets设置（即[[LaTeX Snippets]]）以及如何用LaTeX Suite真正实践数学笔记 - 经验分享 - Obsidian 中文论坛。该插件熟练之后可以很快地输入公式。例如下面的公式，我的实际键入与对应的LaTeX公式如下，可以看到，大部分括号{}、语法提示符\都被映射到了字母区，而不必不停地切换符号。

1
  Input:dm sum ooo n=1 1/nsr = pisr/6
2
  Output:
3
  $$
4
  \sum^{\infty}_{n=1} \frac{1}{n^{2}} = \frac{\pi^{2}}{6}
5
  $$

4. Git插件

该插件主要解决笔记更改的可视化。当我们某个文件写到一半发现需要改其他文件，或者同时更改了若干文件的若干地方。该插件可以很好地记录更改的文件以及更改的情况，这对于我们提交博客前的审查笔记是否完整是非常有帮助的。

有朋友可能会问为什么不是解决笔记上传GitHub的难题呢？其实我们在其它软件中打开同样的文件目录后也可以进行上传，并且可以更方便地编写提交信息以供自己参考（例如使用git-commit-plugin插件）。

Base，统览所有笔记的神#

在Obsidian正式版1.9.10版本以上，新增了Base功能。该文件类型可以在Obsidian中显示库中所有的文件，起到管理所有笔记的效果。在目前最新的1.9.14版本中你可以在.base文件中自由地设置你想查看的笔记类型，例如可以按仓库或者标签显示。但是想要base真正成为obsidian管理博客的工具还需要进行以下调整。

首先，由于.base是一类特殊的格式，所以我们需要在.gitignore中加入下面一行，这样可以在部署时不上传该文件，否则会出现报错。

1
*.base

其次，由于.base是直接读取文件夹下的文档名称并形成跳转链接的。因此，我们尽量采取Mizuki文档中的文件格式写法，而不是文件夹写法，也就是直接在posts目录下创建md文档，而不是创建文件夹。如果采用文件夹写法，虽然可以通过文章的title字段区分文章，但是由于需要保留跳转的功能，第一列需要保留一列index，这样不够美观。因此本博客也是采用文件写法，即直接在posts目录下创建md文件。同时配合图床来实现跳转，图床的配置可以参考Piclist×Github图床的搭建（即[[Piclist×Github]]）一文。

Windows与ios系统多端同步#

现在你可以在你的电脑上随时更新你的博客了，但是问题也随之而来了。你不可能随时带着你的电脑，有时候我们携带的只是手机或者平板，那么能否保持笔记的多端同步呢。这样我们随时都可以写笔记并把想法记录下来。虽然Obsidian提供了官方的同步服务，但是其高昂的价格让很多小伙伴望而却步。这时候我们可以使用Remotely Save插件，配合一些网盘进行同步操作，这样我们就可以随时随地写笔记了。当然，你也可以使用git插件每次进行拉取与提交，与vscode中的方式相同，这里不再赘述。

博主这里使用的是OneDrive个人版进行同步，在插件中鉴权后进行连接，然后设置自动同步即可。