# Astro

**Repository Path**: dxc19961118/astro

## Basic Information

- **Project Name**: Astro
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-23
- **Last Updated**: 2026-09-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HK Master Guide

> 暗房中的红灯 — 以克制的红辐射为核心语言的中文技术落地页。

一个面向**香港硕士申请者**的内容站点，整合院校信息、申请攻略、真实案例与生活经验，帮助准备赴港深造的同学做出更明智的选择。

## 🎯 项目定位

- **目标读者**：计划申请香港硕士的内地本科生
- **内容主线**：院校介绍 → 申请时间线 → 笔面试经验 → 真实案例 → 港漂生活
- **设计语言**：以 `#e63946` 为唯一点缀色，配合暖白底 `#fff8f8` 与墨黑 `#1a1a2e`，追求克制、可读、专注内容

## 🛠 技术栈

| 类别 | 选型 |
|------|------|
| 框架 | [Astro 7](https://astro.build) |
| 内容 | MDX（Markdown + JSX） |
| 搜索 | [Pagefind](https://pagefind.app)（构建时静态生成） |
| SEO | `@astrojs/sitemap` 自动生成 |
| 设计系统 | 见 [`DESIGN.md`](./DESIGN.md) + [Impeccable](https://www.impeccable.design/) |
| 运行时 | Node.js >= 22.12.0 |

## 🚀 本地开发

```bash
# 安装依赖
npm install

# 启动开发服务器（http://localhost:4321）
npm run dev

# 构建生产版本（含 Pagefind 索引）
npm run build

# 本地预览生产构建
npm run preview
```

## 📁 项目结构

```text
/
├── public/                    # 静态资源（favicon 等）
├── src/
│   ├── components/            # Astro 组件（按页面分目录：schools/ posts/ cases/ 等）
│   ├── content/
│   │   ├── schools/           # 院校 MDX（hkust.mdx, hku.mdx ...）
│   │   ├── posts/             # 文章 MDX（申请攻略、经验贴）
│   │   ├── cases/             # 真实案例 MDX
│   │   ├── authors/           # 作者数据（authors.json）
│   │   └── writing-examples/  # 写作规范示例
│   ├── layouts/               # 页面布局（BaseLayout、文章布局等）
│   └── pages/                 # 路由（基于文件）
├── DESIGN.md                  # 设计系统规范（颜色、字体、间距、组件）
├── TODO.md                    # 当前进行中的任务
└── package.json
```

## ✍️ 内容管理

所有内容以 **MDX 文件**形式存放在 `src/content/` 下，文件名即 URL slug。每个集合由 [Zod schema](./src/content.config.ts) 强类型校验。

### 添加院校

在 `src/content/schools/` 新建 `<school-id>.mdx`：

```mdx
---
name: 香港大学
englishName: The University of Hong Kong (HKU)
overview: 一句话简介，显示在学校卡片上
location: 香港岛薄扶林
website: https://www.hku.hk
qsRanking: 26          # QS 世界大学排名（可选）
featured: true         # 是否在首页推荐
---

## 学校简介

正文用 Markdown 写，支持插入 JSX 组件。
```

### 添加文章

在 `src/content/posts/` 新建 `.mdx`：

```mdx
---
title: 文章标题
description: 用于 SEO 和列表页的摘要
pubDate: 2025-03-15
updatedDate: 2025-03-20     # 可选，有更新时填写
category: 申请攻略           # 分类：申请攻略 / 笔面试 / 生活经验 / ...
author: eleanor              # 对应 src/content/authors/authors.json 的 id
featured: true
---

正文内容...
```

### 添加真实案例

在 `src/content/cases/` 新建 `.mdx`：

```mdx
---
name:  applicant nickname
background: 本科背景简述（学校层级、专业、GPA、语言成绩、其他亮点）
targetSchools:
  - 香港大学
  - 香港科技大学
admittedSchools:
  - 香港大学 MSc in CS
gpa: "3.6"
language: 雅思 7.0
timeline:
  - date: 2024年3月
    event: 确定申请方向
---

## 申请心路

正文...
```

### 写作规范

- 中文排版使用**全角标点**，中文与英文/数字间**留空格**
- 完整示例见 [`src/content/writing-examples/`](./src/content/writing-examples/)
- 设计系统细节见 [`DESIGN.md`](./DESIGN.md)

## 🌐 部署

Astro 构建输出为静态文件，可部署到任何静态托管：

```bash
npm run build   # 产物在 ./dist/，含 Pagefind 搜索索引
```

推荐平台：

- [Vercel](https://vercel.com) — 零配置，自动识别 Astro
- [Netlify](https://netlify.com) — 构建命令 `npm run build`，发布目录 `dist`
- [Cloudflare Pages](https://pages.cloudflare.com) — 同上

任何支持 Node.js 22+ 的 CI 均可构建。

## 📄 License

Private project. All rights reserved.