forked from ParadigmEducation/snowflake-notes
sjfhsjfh
6cc96a7126
- Astro+TS 严格模式（禁止 any、显式返回类型） - ESLint Flat Config + Prettier 格式化 - 内容集合（posts）与示例文章 - OSS 图床可配置 Img 组件 - 抽离 posts 数据逻辑（更易类型检查） - getStaticPaths 修正（rest 路由传字符串） - README/AGENTS 中文文档与约定 - Gitea CI：typecheck + lint - 忽略 ref/（仅作临时参考）
35 lines
1.2 KiB
Markdown
35 lines
1.2 KiB
Markdown
# 内部学习博客（Astro + TypeScript）
|
||
|
||
基于 Astro 构建的内部学习博客。目标：严格 TypeScript、统一格式化、内容可扩展（不仅 Markdown/MDX），图片优先使用外部 OSS。
|
||
|
||
## 快速开始
|
||
|
||
- 要求：Node >= 20，包管理器使用 pnpm
|
||
- 安装依赖：`pnpm install`
|
||
- 启动开发：`pnpm dev`
|
||
|
||
常用脚本：
|
||
- 构建：`pnpm build` ；预览：`pnpm preview`
|
||
- 代码检查：`pnpm lint` ；类型检查：`pnpm typecheck`
|
||
- 格式化：`pnpm format`
|
||
|
||
## 内容与结构
|
||
|
||
- 文章与集合：`src/content/`（示例：`src/content/posts/hello-world.mdx`）
|
||
- 页面与布局：`src/pages/`、`src/layouts/`
|
||
- 通用组件：`src/components/`（如 `Img.astro` 支持外部图床）
|
||
- 内容扩展抽象：`src/lib/content/`（为未来 Typst 等格式预留）
|
||
|
||
## 配置
|
||
|
||
- `PUBLIC_MEDIA_BASE_URL`：外部图床前缀（避免图片入库）
|
||
- `PUBLIC_SITE_URL`：站点地址（可选，用于 canonical 等）
|
||
|
||
## 约定
|
||
|
||
- 严格 TypeScript：禁止 any，导出函数需显式返回类型
|
||
- 统一格式化：Prettier（含 Astro/Markdown/MDX）
|
||
- 图片默认不入库，建议走外部 OSS
|
||
|
||
更多细节与约定见 `AGENTS.md`。
|