Astro Starter Kit: Minimal
pnpm create astro@latest -- --template minimal
🧑🚀 Seasoned astronaut? Delete this file. Have fun!
🚀 Project Structure
Inside of your Astro project, you'll see the following folders and files:
/
├── public/
├── src/
│ └── pages/
│ └── index.astro
└── package.json
Astro looks for .astro or .md files in the src/pages/ directory. Each page is exposed as a route based on its file name.
There's nothing special about src/components/, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
Any static assets, like images, can be placed in the public/ directory.
🧞 Commands
All commands are run from the root of the project, from a terminal:
| Command | Action |
|---|
pnpm install | Installs dependencies |
pnpm dev | Starts local dev server at localhost:4321 |
pnpm build | Build your production site to ./dist/ |
pnpm preview | Preview your build locally, before deploying |
pnpm astro ... | Run CLI commands like astro add, astro check |
pnpm astro -- --help | Get help using the Astro CLI |
👀 Want to learn more?
Feel free to check our documentation or jump into our Discord server.
「5 分钟了解 tcdw」页面
一页式个人介绍，桌面端 / 打印版是一张 A4 横向（297mm × 210mm）的 profile sheet，
窄屏重排为单栏。
- 内容全部集中在
src/data/profile.ts（资料来自博客仓库与 GitHub，文件顶部有来源说明），以「待补充」开头的字符串会以浅色占位样式渲染，
直接替换文字即可，无需改动模板。
- 图标：
astro-icon，两套图标集按角色分工——品牌 mark 用 Simple Icons（simple-icons:github），
通用 UI 图标用 Remix Icon（ri:mail-line）。图标名写在 profile.ts 的 icon 字段里，
模板用 <Icon name={row.icon} class="size-[1.15em]" /> 渲染，跟着字号缩放。换图标只改数据文件。
- 头像：
public/avatar.png（从博客仓库 src/assets/avatar.png 复制并缩放到 512px）。
换头像就替换这个文件，或改 profile.avatar 指向别的路径。
- 打印：页面右下角的「打印 / PDF」按钮，或浏览器打印。
@page 已固定为 A4 横向、零边距，
记得在打印对话框里勾选「背景图形」。
- 布局约定：
sheet: 这个 Tailwind 自定义 variant 同时覆盖「宽屏」和「打印」两种场景
（见 src/styles/global.css），所以打印时不会意外落回移动端单栏布局。
- 字号与部分尺寸走 CSS 变量（
--fs-*、--pad-y 等），在 src/styles/global.css 里分
「移动端 / 宽屏 / 打印」三套取值：屏幕上是正常阅读字号，只有打印时才收紧到能塞进一张 A4。
想调排版密度改那里就够了。
- 单位约定：毫米只出现在
--sheet-w / --sheet-h（= A4 横向）和 @page 里，A4 只是一个
「容器大小」。版心内部一律用 px，尽量落在 Tailwind 的间距刻度上（px-10、gap-6……），
别再往模板里写 mm。
- 打印版是严格的一页，内容高度上限就是
--sheet-h；写内容时留意别把某个 section 撑得太长。
代码风格
用 Biome（配置从 plasticwan 抄来，biome.json）：
pnpm lint # biome check . —— lint + format + import 整理，只检查
pnpm lint:fix # biome check --write . —— 应用安全修复
两个和 Astro 有关的配置要点：
css.parser.tailwindDirectives: true。否则 global.css 里的 @custom-variant
会被当成语法错误，整个文件跳过格式化。overrides 里对 **/*.astro 关掉了 noUnusedImports 和 noUnusedVariables。
Biome 只解析 .astro 的 frontmatter，看不到下面的模板，所以只在模板里用到的
import 和变量会被误判为「未使用」——开着的话 --write --unsafe 会直接把它们删掉。
Biome 只格式化 .astro 的 frontmatter，模板部分不动。public/ 是静态资源，已排除。
