From a3272858ad01187b0b93f205937409394920b0ee Mon Sep 17 00:00:00 2001 From: Spirale <2635131263@qq.com> Date: Mon, 17 Aug 2026 23:29:26 +0800 Subject: [PATCH] =?UTF-8?q?docs(ts):=20=E6=96=B0=E5=A2=9E=20TypeScript=20?= =?UTF-8?q?=E5=AE=9E=E9=AA=8C=E7=9B=AE=E5=BD=95=E5=8F=8A=20Astro=20?= =?UTF-8?q?=E9=A1=B9=E7=9B=AE=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 添加 ts/README.md 约定文档（每个实验独立 npm 项目） - 新增 ts/web/astro/polaris 实验项目说明与 logo - .gitignore 增加 Node/TypeScript 忽略规则 - 根 README 目录说明补充 ts/ 条目 --- .gitignore | 6 ++ README.md | 1 + ts/README.md | 32 ++++++++++ ts/web/astro/polaris/README.md | 31 +++++++++ ts/web/astro/polaris/logo.svg | 111 +++++++++++++++++++++++++++++++++ 5 files changed, 181 insertions(+) create mode 100644 ts/README.md create mode 100644 ts/web/astro/polaris/README.md create mode 100644 ts/web/astro/polaris/logo.svg diff --git a/.gitignore b/.gitignore index 23cd900..07c4b41 100644 --- a/.gitignore +++ b/.gitignore @@ -19,6 +19,12 @@ vendor/ .pub/ build/ +# ---- Node / TypeScript ---- +node_modules/ +dist/ +.astro/ +*.tsbuildinfo + # ---- IDE / 编辑器 ---- .idea/ .vscode/ diff --git a/README.md b/README.md index 8a19020..27f38f6 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,7 @@ - `go/` — Go（共用一个 module，约定见 [go/README.md](go/README.md)） - `dart/` — Dart +- `ts/` — TypeScript / JavaScript（每个实验独立 npm 项目，约定见 [ts/README.md](ts/README.md)） ## 约定 diff --git a/ts/README.md b/ts/README.md new file mode 100644 index 0000000..d54f5e9 --- /dev/null +++ b/ts/README.md @@ -0,0 +1,32 @@ +# TypeScript / JavaScript 练习区 + +本目录是 TS/JS 的学习 / 练手代码。与 Go 那边共用一个 module 不同，这里**每个实验是独立的 npm 项目**（各自的 `package.json`、lock 文件）。 + +## 约定 + +- **每个叶子目录 = 一个独立实验**：自带 `package.json`，依赖自行管理。 +- 多个实验并存互不冲突，框架和版本可以各不相同（一个 Astro 4、一个 Astro 5 都行）。 +- `node_modules/`、构建产物（`dist/`、`.astro/` 等）已在根 `.gitignore` 忽略，不会提交。 + +## 主题目录 + +| 目录 | 放什么 | +|---|---| +| `basics/` | 语法基础、类型系统、ES 新特性 | +| `web/` | 前端框架：Astro、Vite 等 | +| `node/` | Node.js 后端练习（http、fs、CLI…） | +| `testing/` | 测试机制（Vitest、Playwright…） | +| `project/` | 完整小项目（多文件） | + +> 主题目录可随时增删。写新实验时挑最贴的主题，在里面建一个新子目录即可。 + +## 新建一个 Astro 实验 + +```bash +cd ts/web/astro +npm create astro@latest my-lab -- --template basics --no-git --install +cd my-lab +npm run dev +``` + +> `my-lab` 换成实验名；想完全交互式地选模板/TypeScript 严格度，去掉 `--` 后面的参数即可。 diff --git a/ts/web/astro/polaris/README.md b/ts/web/astro/polaris/README.md new file mode 100644 index 0000000..f60aad3 --- /dev/null +++ b/ts/web/astro/polaris/README.md @@ -0,0 +1,31 @@ +# Polaris（北极星） + +个人导航网站（Personal Navigation / 个人主页 + 导航站）。 + +## 项目背景（记录于开发启动前） + +- **项目名**：polaris +- **定位**：个人导航网站 —— 作为个人门户，聚合常用链接 / 站点导航 / 个人介绍等。 +- **当前状态**：设计尚未完成，仅完成并存放了 Logo（`logo.svg`）。 +- **Logo 风格**：青蓝渐变（`#00F2FE → #3B82F6`）的"极客魔法阵 + 机甲指针"罗盘图形，整体偏深色科技感。 + +## 技术选型（待定） + +- **候选主力框架**：Astro（静态优先、岛屿架构，适合导航站这类以内容/链接为主的站点）。 +- 其余（样式方案、部署平台、数据源等）**尚未确定**。 + +## 待办 / 未决事项 + +- [ ] 完成整体设计（页面结构、视觉风格、配色是否沿用 Logo 的深色青蓝科技风） +- [ ] 确定技术栈细节：Astro 版本、样式方案（如 Tailwind / UnoCSS）、是否引入 UI 组件 +- [ ] 确定内容与数据组织：导航链接的存放方式（Markdown / JSON / 内容集合） +- [ ] 确定部署方式（如 Vercel / Netlify / Cloudflare Pages / 自有服务器） +- [ ] 搭建项目骨架并接入现有 Logo + +## 目录 + +``` +polaris/ +├── logo.svg # 项目 Logo（唯一现有资产） +└── README.md # 本项目说明（本文件） +``` diff --git a/ts/web/astro/polaris/logo.svg b/ts/web/astro/polaris/logo.svg new file mode 100644 index 0000000..6ad38af --- /dev/null +++ b/ts/web/astro/polaris/logo.svg @@ -0,0 +1,111 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +