这是本站的第一篇日志。目标很简单:先在本地做出一个能写、能读、好看的版本,部署和域名放到下一阶段。
这一版要解决什么
- 写作要轻:在
content/archive/下新建一个 Markdown 文件就是一篇文章,不需要后台。 - 阅读要清楚:装饰放在页边和首屏,正文区域保持克制。
- 视觉有辨识度:平面设计、工业感、有一点交互,但不吵。
技术栈
| 层 | 选择 | 作用 |
|---|---|---|
| 框架 | Next.js 16(App Router) | 路由、构建期渲染、静态导出 |
| 内容 | MDX + gray-matter | Markdown 里能写组件,frontmatter 存元数据 |
| 样式 | Tailwind CSS 4 | 原子类 + CSS 变量做主题 |
| 高亮 | Shiki | 构建期上色,浏览器零 JS |
| 包管理 | Bun | 安装快,lockfile 可复现 |
目录怎么分
plain
content/ ← 只放内容
archive/
logs/ ← 一个文件夹 = 一个分类,_folder.json 写名称和说明
schedule/
notes/devops/ ← 可以继续嵌套
about.mdx research.mdx links.mdx
src/
app/ ← 路由:每个文件夹就是一个网址
lib/content.ts ← 唯一读取 content/ 的地方
components/ ← 页面零件一个页面是怎么出来的
页面文件(比如 app/archive/[...slug]/page.tsx)在构建时调用 getDoc() 读到 Markdown,交给 MDX 编译成 React 组件,再输出成静态 HTML。浏览器拿到的已经是排好版的页面,只有目录高亮、主题切换这些交互需要 JS。
视觉语言
- 一个强调色:默认机械橙,可以在右上角切到冰青、圣环金。
- 网格与编号:每个区块都有编号,标题配英文大字。
- 工业细节:切角、对位十字、条形码、警戒斜纹,只做点缀。
下一步
- 首页、档案、文章、研究、友链、关于
- 换上真正的头像和个人信息
- 接入 GitHub 数据
- 部署到 Vercel 并绑定域名