从零开始：安装与使用
本文带你从零把 astro-theme-ink 跑起来，并完成第一篇文章和一次部署。
1. 环境准备
需要 Node.js 22+ 和 pnpm：
node -v # v22.0.0+
pnpm -v # v10+2. 获取主题
把仓库 clone 到本地（或者直接下载 ZIP 解压）：
git clone <你的仓库地址> my-blog
cd my-blog如果是从 GitHub 模板仓库创建，也可以直接用 “Use this template”。
3. 安装依赖并启动
pnpm install
pnpm dev打开 http://localhost:4321 就能看到主题首页。开发模式下改文件会热更新。
4. 写第一篇文章
在 src/content/blog/ 下新建一个 Markdown 文件，例如 hello.md：
---
title: '你好，世界'
description: '我的第一篇文章。'
publishDate: 2026-08-17
tags: [随笔]
---
这里是正文。支持标准 Markdown 语法。保存后刷新浏览器，文章就会出现在首页的”最近文章”和 /blog 列表里。
Frontmatter 字段速查：
| 字段 | 必填 | 说明 |
|---|---|---|
title | ✅ | 标题（≤80 字） |
description | ✅ | 一句话摘要（≤200 字） |
publishDate | ✅ | 发布日期 |
updatedDate | — | 更新日期（显示”Updated”） |
tags | — | 标签数组 |
heroImage | — | 封面图：heroImage: { src: ../../assets/cover.png, alt: '…' }（相对文章文件的本地资源，构建时自动压缩） |
draft | — | true 时仅在 URL 可见，不进列表 |
comment | — | 单篇关闭评论 |
5. 配置个人信息
编辑 src/site-config.ts，把站点改成你的：
site: {
title: "Hansen's ink", // 站点标题
author: 'Hansen W.', // 作者名
description: '……',
lang: 'en', // 语言
avatar: '/avatar.png', // 首页头像（放 public/）
palette: 'fresh' // 默认配色：'ink' 或 'fresh'
}首页内容（简介、教育、技能等）改 home 配置块，评论和浏览量在 comment / pageview 里填你的 Waline 服务器地址。
6. 构建与部署
pnpm build # 产物在 dist/
pnpm preview # 本地预览构建结果重要：部署前把 astro.config.ts 里的 site: 'https://example.com' 换成你的真实域名 —— sitemap、canonical 和 RSS 都依赖它。
纯静态产物可以部署到任何平台：
- Vercel / Netlify：连上仓库自动构建（build 命令
pnpm build，输出目录dist） - Cloudflare Pages：同上
- GitHub Pages：构建后把
dist/内容推送到 pages 分支
7. 更新主题（主题与博客分开时）
如果把主题放在 D:/Code/astro-theme-ink，而真实文章和个人配置放在 D:/Code/Blog，主题升级时使用同步脚本，而不是直接复制文件：
cd D:/Code/astro-theme-ink
pnpm theme:sync --target ../Blog
pnpm theme:sync --target ../Blog --apply
cd ../Blog
pnpm test
pnpm build第一条只列出变更，第二条才写入。脚本会保留文章、个人图片、域名、部署设置和个人站点配置；将生成的 .theme-sync.json 一起提交。需要解决 REVIEW 或 CONFLICT 时，阅读仓库中的 docs/theme-sync.md。
也可以执行 pnpm theme:sync:ui 打开本机同步面板，在浏览器中完成目录选择、预览和确认应用。
8. 清理演示内容
把 src/content/blog/ 下的示例文章删掉或改写，把 public/avatar.png、favicon/ 换成你自己的，就完成了。