站点维护指南

✦ 新增文章

在 src/content/blog/ 新建 文件名.md，粘贴下面的模板：

---
title:
  zh: 中文标题
  en: English Title
description:
  zh: 中文摘要（首页卡片展示）
  en: English summary
date: 2026-06-15
tags: [tag1, tag2]
draft: false          # 改为 true 则隐藏（草稿）
---

## 正文开始

直接写 Markdown，支持代码块、表格、图片。

```python
print("hello")
```

✦ 删除文章

直接删除对应的 .md 文件即可。

✦ 隐藏文章（不删除）

把 frontmatter 里的 draft: false 改为 draft: true。

✦ 新增项目

在 projects.ts 的 projects 数组末尾添加一个对象：

{
  id: 'my-new-project',          // URL 路径，英文短横线
  title: {
    zh: '项目中文名',
    en: 'Project English Name',
  },
  codename: 'CODE-NAME',         // 显示在卡片顶部的代号
  period: '2026',
  status: { zh: '开发中', en: 'In Progress' },
  hero: '一句话描述，显示在卡片上',
  summary: {
    zh: '详细摘要（中文）',
    en: 'Detailed summary (English)',
  },
  challenge: {
    zh: '项目面临的挑战',
    en: 'Challenges faced',
  },
  approach: {
    zh: ['方案步骤1', '方案步骤2'],
    en: ['Step 1', 'Step 2'],
  },
  outcome: {
    zh: ['成果1', '成果2'],
    en: ['Outcome 1', 'Outcome 2'],
  },
  tech: ['Python', 'React'],     // 技术标签
  github: 'https://github.com/...',  // 可选
  featured: false,               // true 则显示在首页精选
}

✦ 删除项目

在 projects.ts 中删除对应的整个 {...} 对象即可。

✦ 修改工作经历

在 resume.ts 的 work 数组里找到对应公司，修改 highlights 下的描述。每个字符串是一条要点。

✦ 新增工作经历

// 在 work 数组最前面（最新在前）添加：
{
  company: { zh: '公司名称', en: 'Company Name' },
  role: { zh: '职位名称', en: 'Job Title' },
  period: '2026.01 — 至今',
  highlights: {
    zh: ['职责描述1', '职责描述2'],
    en: ['Responsibility 1', 'Responsibility 2'],
  },
},

✦ 修改个人技能

修改 resume.ts 中的 skills 对象，zh 和 en 各是一个字符串数组，每条是一项技能描述。

✦ 发布到 Cloudflare Pages

在项目根目录打开终端（PowerShell），运行：

npm run deploy

这条命令会自动构建并推送到 Cloudflare Pages。

✦ 本地预览

npm run dev

浏览器打开 http://localhost:4321 即可预览。

✦ 添加图片

把图片文件放进 public/images/ 目录，然后在 Markdown 里这样引用：

![图片说明](/images/my-photo.jpg)

项目封面图：把图片路径填入 projects.ts 对应项目的 image: '/images/xxx.jpg' 字段（需先在 BaseLayout 里渲染该字段）。

✦ 修改网站颜色 / 字体

文件：src/styles/global.css 顶部的 :root 变量块。

--accent-amber: #c9a227;    /* 主强调色（金色）*/
--accent-teal: #2dd4bf;     /* 次强调色（青色）*/
--bg-void: #050506;          /* 背景色 */

✦ 修改导航栏 / 页脚

文件：src/layouts/BaseLayout.astro，导航链接在 <nav> 标签内，页脚在 <footer> 标签内。

✦ 修改首页文字

文件：src/i18n/ui.ts → zh.home 对象下的 greeting、intro 等字段。