Hugo → Astro 记录第二次博客搬迁

这次搬迁的原因是看 MoScenix 的新博客主题太丝滑了，自己也想弄一个。不查不知道，astro框架下有不少开箱即用的博客，这个博客用了 Mizuki Next Theme。

安装依赖#

astro 是一个 js 框架，所以需要先保证 nodejs 的环境，另外需要 pnpm，如果是用了 homebrew 的 mac 那么只需要

1
brew install node
2
npm install -g pnpm

装完之后检查一下

1
node -v
2
npm -v
3
pnpm -v

本地调试#

直接 clone 主题的模板，然后安装需要的包

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

直接

1
pnpm dev

就可以跑起来测试页了，默认端口是 4321，访问 http://localhost:4321 即可预览。

如果想构建用于在生产环境部署的版本需要

1
pnpm run build

默认会输出到 ./dist 目录下，预览构建出的静态网页

1
pnpm preview

如果需要直接部署到服务器上，把 ./dist 目录复制到 /var/www，用 nginx 或者 apache2 部署均可。

配置#

改 src/config.ts 中的配置，官方有中文文档，很详细。

我配置的过程中遇到了一些迷惑的问题

问题	情况
toc 怎么设置好像都没有，很奇怪	实际上是因为我的浏览器窗口不够宽，toc 被挤到右边屏幕外了
Twikoo 评论区的 IP 地址莫名其妙都在美国	很诡异

迁移文章#

主要是这个文件头，下面是官方给的规范（然后我就发现了个问题，这个表格的有边框没有贴合😨，强迫症又要犯了。

Attribute	Description
`title`	The title of the post.
`published`	The date the post was published.
`pinned`	Whether this post is pinned to the top of the post list.
`priority`	The priority of the pinned post. Smaller value means higher priority (0, 1, 2…).
`description`	A short description of the post. Displayed on index page.
`image`	The cover image path of the post. 1. Start with `http://` or `https://`: Use web image 2. Start with `/`: For image in `public` dir 3. With none of the prefixes: Relative to the markdown file
`tags`	The tags of the post.
`category`	The category of the post.
`licenseName`	The license name for the post content.
`author`	The author of the post.
`sourceLink`	The source link or reference for the post content.
`draft`	If this post is still a draft, which won’t be displayed.

我要从 Hugo，根据这个表，需要动一下 Frontmatter，主要需要调整

date -> published，并删除引号和冗余的详细时间
categories -> category，只保留一个类别

另外文章内容也要微调一下

内部 a 标签 /p/xxx -> /posts/xxx/，/tags/xxx -> /archive/?tag=xxx…
内部公式需要统一改成 $ 我是行内公式 $ ，$$ 我是大公式 $$，不能用  和 \[ \] 组合

于是我让 GPT 生成了一个脚本处理了 Frontmatter，然后手动处理了一下公式

1
from pathlib import Path
2
from shutil import copy2, rmtree
3
import re
4
import ast
5

6
input_dir = Path.cwd() / "post"
7
output_dir = Path.cwd() / "output"
8

9

10
def extract_date(date_str: str) -> str:
11
    """
12
    从 2025-03-02T15:09:48+0000 或 2025-07-26T17:11:04+08:00
13
    提取 2025-03-02
14
    """
15
    return date_str[:10]
16

17

18
def parse_yaml_front_matter(text: str):
19
    """
20
    解析 --- YAML ---，返回 (meta_dict, body)
21
    """
22
    parts = text.split("---", 2)
23
    if len(parts) < 3:
24
        return None, text
25

26
    raw = parts[1].strip()
27
    body = parts[2].lstrip()
28

29
    meta = {}
30
    for line in raw.splitlines():
31
        if ":" not in line:
32
            continue
33
        k, v = line.split(":", 1)
34
        meta[k.strip()] = ast.literal_eval(v.strip()) if v.strip().startswith(("[", "'", '"')) else v.strip()
35

36
    return meta, body
37

38

39
def safe_eval(value: str):
40
    """
41
    尝试 literal_eval，失败则作为普通字符串
42
    """
43
    value = value.strip()
44
    try:
45
        return ast.literal_eval(value)
46
    except Exception:
47
        return value.strip("'\"")  # 去掉可能的引号
48

49

50
def parse_ini_front_matter(text: str):
51
    """
52
    解析 +++ INI/TOML 风格 +++
53
    """
54
    parts = text.split("+++", 2)
55
    if len(parts) < 3:
56
        return None, text
57

58
    raw = parts[1].strip()
59
    body = parts[2].lstrip()
60

61
    meta = {}
62
    for line in raw.splitlines():
63
        line = line.strip()
64
        if not line or line.startswith("#"):
65
            continue
66
        if "=" not in line:
67
            continue
68

69
        k, v = line.split("=", 1)
70
        meta[k.strip()] = safe_eval(v)
71

72
    return meta, body
73

74

75
def needs_quotes(s: str) -> bool:
76
    return any(c in s for c in [":", "#", "\n", "\"", "'"])
77

78

79
def to_yaml_front_matter(meta: dict) -> str:
80
    lines = ["---"]
81
    for k, v in meta.items():
82
        if isinstance(v, list):
83
            lines.append(f"{k}: {v}")
84
        elif isinstance(v, bool):
85
            lines.append(f"{k}: {'true' if v else 'false'}")
86
        elif isinstance(v, (int, float)):
87
            lines.append(f"{k}: {v}")
88
        elif isinstance(v, str):
89
            if needs_quotes(v):
90
                lines.append(f'{k}: "{v}"')
91
            else:
92
                lines.append(f"{k}: {v}")
93
        else:
94
            lines.append(f"{k}: {v}")
95
    lines.append("---\n")
96
    return "\n".join(lines)
97

98

99
def choose_category(title: str, categories: list[str]) -> str:
100
    print("\n⚠️  检测到多个 categories")
101
    print(f"文章标题：{title}")
102
    print("可选分类：")
103

104
    for i, c in enumerate(categories, 1):
105
        print(f"  {i}. {c}")
106

107
    while True:
108
        try:
109
            choice = int(input("请选择一个分类编号: "))
110
            if 1 <= choice <= len(categories):
111
                return categories[choice - 1]
112
        except ValueError:
113
            pass
114
        print("输入无效，请重新输入。")
115

116

117
def normalize_meta(meta: dict, src_path: Path | None = None) -> dict:
118
    new_meta = {}
119

120
    title = meta.get("title")
121
    if not title and src_path:
122
        title = src_path.stem
123

124
    for k, v in meta.items():
125
        if k == "date":
126
            new_meta["published"] = extract_date(str(v))
127

128
        elif k == "draft":
129
            continue
130

131
        elif k == "categories":
132
            if isinstance(v, list):
133
                if len(v) == 1:
134
                    new_meta["category"] = v[0]
135
                elif len(v) > 1:
136
                    chosen = choose_category(title or "（无标题）", v)
137
                    new_meta["category"] = chosen
138
            else:
139
                new_meta["category"] = v
140

141
        else:
142
            new_meta[k] = v
143

144
    return new_meta
145

146

147
def process_md(src: Path, dst: Path):
148
    text = src.read_text(encoding="utf-8")
149

150
    if text.startswith("---"):
151
        meta, body = parse_yaml_front_matter(text)
152
    elif text.startswith("+++"):
153
        meta, body = parse_ini_front_matter(text)
154
    else:
155
        dst.write_text(text, encoding="utf-8")
156
        return
157

158
    if meta is None:
159
        dst.write_text(text, encoding="utf-8")
160
        return
161

162
    meta = normalize_meta(meta, src)
163
    yaml_block = to_yaml_front_matter(meta)
164
    dst.write_text(yaml_block + body, encoding="utf-8")
165

166

167
def main():
168
    if output_dir.exists():
169
        rmtree(output_dir)
170
    output_dir.mkdir(parents=True)
171

172
    for src in input_dir.rglob("*"):
173
        rel = src.relative_to(input_dir)
174
        dst = output_dir / rel
175

176
        if src.is_dir():
177
            dst.mkdir(parents=True, exist_ok=True)
178
            continue
179

180
        if src.suffix == ".md":
181
            dst.parent.mkdir(parents=True, exist_ok=True)
182
            process_md(src, dst)
183
        else:
184
            dst.parent.mkdir(parents=True, exist_ok=True)
185
            copy2(src, dst)
186

187

188
if __name__ == "__main__":
189
    main()

最近腾讯云有一个可以白嫖的 Pages，但是国内服务器 + 国内域名需要备案，等备完案之后更新下一篇。

部署到 nginx#

因为备案域名需要买服务器，所以我就 79R 买了个 2G + 2G 服务器，作为临时方案，我尝试先部署到服务器的 nginx 上。我本来想按照标准的流程先给服务器配个 Github 的 ssh，然后 clone 项目。发现他这个丐版服务器根本跑不了 pnpm run build，然后我突然灵机一动，我在本地构建一下然后挪到服务器上不就行了，于是喂给 GPT，就有了下面这个脚本。

1
#!/usr/bin/env bash
2
set -e
3

4
# ===== 配置区 =====
5
SERVER_USER=youruser
6
SERVER_HOST=your.server.ip
7
SERVER_DIR=/var/www/html
8
ARCHIVE=dist.tar.gz
9
# ==================
10

11
echo "===> Building..."
12
pnpm build
13

14
echo "===> Packing dist/"
15
rm -f $ARCHIVE
16
tar -zcvf $ARCHIVE dist
17

18
echo "===> Uploading to server..."
19
scp $ARCHIVE ${SERVER_USER}@${SERVER_HOST}:/tmp/
20

21
echo "===> Deploying on server..."
22
ssh ${SERVER_USER}@${SERVER_HOST} << 'EOF'
23
set -e
24
cd /tmp
25

26
# 备份旧站点
27
if [ -d /var/www/html ]; then
28
  sudo rm -rf /var/www/html.bak
29
  sudo mv /var/www/html /var/www/html.bak
30
fi
31

32
# 解压并部署
33
tar -zxvf dist.tar.gz
34
sudo mv dist /var/www/html
35

36
# 权限（按需）
37
sudo chown -R www-data:www-data /var/www/html || true
38
EOF
39

40
echo "===> Done!"
41

42
# 把包删了
43
rm -f $ARCHIVE

当然，如果还没成功备案，想把他解析到域名，那可能会

alt text

Star's Blog

安装依赖#

本地调试#

配置#

迁移文章#

部署到 nginx#