LLM Log Frontend

基于 Astro 6、Tailwind CSS v4 和 Content Collections 构建的现代化文档站点。

功能特性

• Astro 6 - 下一代静态站点生成器，支持 Content Collections
• Tailwind CSS v4 - 使用 @tailwindcss/vite 集成的原子化 CSS 框架
• 排版插件 - 使用 @tailwindcss/typography 实现美观的 Markdown 渲染
• 数学公式 - 通过 remark-math + rehype-katex 支持 LaTeX 数学公式
• 代码高亮 - 使用 rehype-pretty-code 实现语法高亮（github-dark 主题）
• 中文优化 - 专为中文文档内容优化

技术栈

包名	版本	用途
astro	^6.1.9	静态站点生成器
tailwindcss	^4.2.4	CSS 框架
@tailwindcss/vite	^4.2.4	Tailwind Vite 插件
@tailwindcss/typography	^0.5.19	Markdown 文章样式
remark-math	^6.0.0	Markdown 数学插件
rehype-katex	^7.0.1	KaTeX HTML 渲染器
rehype-pretty-code	^0.14.3	代码语法高亮

项目结构

llm_log_frontend/
├── src/
│   ├── content/
│   │   └── docs/              # Markdown 文档文件
│   │       └── test.md
│   ├── layouts/
│   │   └── BaseLayout.astro   # 基础 HTML 布局
│   ├── pages/
│   │   ├── index.astro         # 首页
│   │   └── docs/
│   │       └── [...slug].astro # 动态文档路由
│   └── styles/
│       └── global.css          # Tailwind 入口
├── public/                    # 静态资源
├── astro.config.mjs           # Astro 配置
├── tailwind.config.mjs        # Tailwind + Typography 配置
├── package.json
└── tsconfig.json

快速开始

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build

# 预览生产构建
npm run preview

命令说明

命令	操作
npm run dev	在 localhost:4321 启动开发服务器
npm run build	构建输出到 ./dist/
npm run preview	本地预览生产构建
npm run astro -- --help	获取 Astro CLI 帮助

编写文档

在 src/content/docs/ 目录下创建 Markdown 文件：

---
title: "我的文档"
---

# 标题

内容含 LaTeX 公式：$E=mc^2$

```javascript
const hello = "world";

文档会自动通过 `[...slug].astro` 页面进行路由。

## License

MIT