这是 xingpingcn.top 的 Astro 博客源码，由旧的私有 Hexo 源仓库迁移而来。

本仓库是公开仓库。src/content/blog/ 下生成的 MDX 文章才是预期放在这里的迁移结果。

在 src/content/blog/ 下新建目录，并在目录里放一个 index.mdx：

src/content/blog/my-post-slug/
  index.mdx

文章 URL 会生成在站点根路径：

/my-post-slug

使用下面这种 frontmatter：

---
title: '文章标题'
description: '用于首页摘要和 SEO 的简短描述'
date: 2026-05-19
tags: ['python']
authors: ['xingpingcn']
coverImage: 'https://cdn.jsdmirror.com/gh/xingpingcn/picx-images-hosting@master/path/to/image.webp'
---

import Figure from '@/components/figure.astro'
import ImageGrid from '@/components/image-grid.astro'

正文内容从这里开始。

支持的文章 frontmatter：

文章协议示例：

license:
type: 'cc-by-nc-sa-4.0'

转载文章示例：

canonicalURL: 'https://example.com/original-post'
license:
type: 'original'
sourceTitle: '原文标题'
sourceUrl: 'https://example.com/original-post'

首页和 /blog 列表会排除 subpost，并按下面规则排序：

1. 置顶文章在前；
2. date 越新的文章越靠前。

仓库提供 .vscode/mdx.code-snippets，在 Markdown / MDX 文件里可以直接输入触发词后按 Tab 展开：

VS Code 的快捷键配置是用户级配置，不会读取仓库里的 .vscode/keybindings.json。如果想选中文字后一键包成内联代码，需要打开 Preferences: Open Keyboard Shortcuts (JSON)，在用户级 keybindings.json 加：

{
  "key": "ctrl+alt+e",
  "command": "editor.action.insertSnippet",
  "when": "editorTextFocus && editorLangId =~ /^(markdown|mdx)$/",
  "args": {
    "snippet": "`${TM_SELECTED_TEXT:${1:高亮内容}}`"
  }
}

Subpost 沿用上游 astro-erudite 的约定：如果一篇博客条目的 ID 里包含 /，它就会被当作 subpost。不需要额外写父子关系字段。

它适合把一组强相关内容做成“系列合集”：

• 父文章是合集入口，负责写总览、背景、目录说明和整体结论；
• 子文章是系列里的每一节，适合拆分很长的教程、笔记、章节或连续记录；
• 站点会根据文件路径自动把子文章挂到父文章下，不需要额外配置 series、parent 之类字段。

使用下面这种结构：

src/content/blog/parent-post/
  index.mdx
  first-subpost.mdx
  second-subpost.mdx

会生成下面这些 URL：

/parent-post
/parent-post/first-subpost
/parent-post/second-subpost

建议把父目录命名成这个系列的固定 slug，例如 docker-learning-notes；子文章文件名命名成每一节的 slug，例如 install.mdx、network.mdx、compose.mdx。index.mdx 永远是父文章本身，不要拿来当第一节。

父文章示例：

---
title: 'Docker 学习笔记'
description: 'Docker 基础、网络、Compose 和常见运维问题的系列笔记'
date: 2026-05-19
authors: ['xingpingcn']
tags: ['docker']
---

这里写这个系列为什么要整理、每一节大概讲什么，以及读者应该按什么顺序看。

Subpost 示例：

---
title: 'Docker 网络基础'
description: '整理 Docker bridge、host、container 网络模式的基本用法'
date: 2026-05-19
order: 1
authors: ['xingpingcn']
tags: ['docker']
---

# Docker 网络基础

子文章正文。

Subpost 注意事项：

普通 Markdown 图片仍然可用：

![图片说明](https://cdn.jsdmirror.com/gh/xingpingcn/picx-images-hosting@master/path/to/image.webp)

从 Hexo 迁移过来的图片块，或者任何需要图片说明和大图预览的图片，优先使用 Figure 或 ImageGrid。

单张图片使用 Figure：

import Figure from '@/components/figure.astro'

<Figure
  src="https://cdn.jsdmirror.com/gh/xingpingcn/picx-images-hosting@master/path/to/image.webp"
  caption="测速截图"
/>

Props：

图片尺寸由 npm run sync:image-metadata 自动同步到 data/image-metadata.sqlite，并生成 src/generated/image-metadata.ts 供组件使用。npm run dev 和 npm run build 会自动先同步一次；通常不需要在 MDX 里手写 width / height。

相册或对比截图使用 ImageGrid：

import ImageGrid from '@/components/image-grid.astro'

<ImageGrid
  images={[
    {
      src: 'https://cdn.jsdmirror.com/gh/xingpingcn/picx-images-hosting@master/path/to/a.webp',
      caption: '官方解析',
    },
    {
      src: 'https://cdn.jsdmirror.com/gh/xingpingcn/picx-images-hosting@master/path/to/b.webp',
      caption: '优化解析',
    },
  ]}
/>

网格行为：

Figure 和 ImageGrid 都会使用：

ImageGrid 会自动从同一组图片的 metadata 里找出按同宽展示时最高的图片比例，作为整组统一骨架高度；其他图片会在这个统一区域里填充显示。

除非有明确理由保留其他域名，图片 CDN 默认使用 https://cdn.jsdmirror.com/gh/xingpingcn/picx-images-hosting@master/...。

标签页由顶层文章里的 tags 生成：

tags: ['volantis', 'python']

当前迁移策略比较保守：标签应该来自旧博客里真实存在的标签，或者来自明确的新分类调整。不要因为文章里偶然提到某个主题就添加无关标签。

作者 ID 指向 src/content/authors/ 下的文件：

src/content/authors/xingpingcn.md

普通文章使用 authors: ['xingpingcn']。作者卡片、头像、邮箱、GitHub 和网站都在作者文件里维护。

友链页在 /friends，配置集中在 src/consts.ts 的 SITE.friends：

friends: {
  api: 'https://raw.githubusercontent.com/xingpingcn/friends/output/v2/data.json',
  repo: 'xingpingcn/friends',
  applyUrl: 'https://github.com/xingpingcn/friends/issues',
}

页面会在构建时读取公开的 xingpingcn/friends 输出数据。JSON 里每个站点建议包含：

{
  "title": "站点名",
  "url": "https://example.com",
  "avatar": "https://example.com/avatar.png",
  "screenshot": "https://example.com/screenshot.webp",
  "description": "站点简介",
  "labels": [{ "name": "active", "color": "58EC80" }]
}

只有带 active 标签的站点会显示在友链页。

常见 jsDelivr URL 会自动规范化为 cdn.jsdmirror.com。

迁移脚本会从本地路径读取旧的私有博客源，并生成 Astro MDX 文章：

node scripts/migrate-hexo-blog.mjs /tmp/newblog-migration/blog-source

脚本会把旧 Hexo 图片 / gallery 标签转换成 Figure 和 ImageGrid，把已知 CDN URL 规范化为 cdn.jsdmirror.com。