这份 README 是为你目前的项目量身定制的，采用了职业开源项目的标准结构，重点突出了你已经实现的 Astro 5.0、多语言支持 以及 Algolia 搜索 等功能。

OKCODE 是一个高性能、多语言的技术文档门户。基于最新的 Astro 框架与 Starlight 主题构建，旨在提供极致的阅读体验与精准的知识检索。

🌐 访问在线文档

• 🌍 全球化多语言：原生支持简体中文 (zh-CN)、英语 (en) 及西班牙语 (es) 切换。
• 🔍 智能搜索：集成 Algolia DocSearch，提供毫秒级的全文索引与搜索建议。
• ⚡ 极致性能：采用 Astro 5.0 Content Layer API，确保静态生成的文档加载极其迅速。
• 📊 商业化集成：内置 Google Analytics 4 数据统计及 Google AdSense 广告支持，并适配了单页应用路由跳转统计。
• 🛠️ 开发者友好：支持 MDX、代码高亮、侧边栏自动生成，并集成了“回到顶部”等增强插件。

• 核心框架: Astro 5.0+ (使用 docsLoader)
• 文档主题: Starlight
• 搜索技术: Algolia DocSearch
• 内容管理: Content Collections (支持 MDX)
• 部署平台: GitHub Pages

okcode/
├── src/
│   ├── assets/             # 图片、图标等静态资源
│   ├── content/
│   │   └── docs/           # 文档核心内容 (MDX/MD)
│   │       ├── zh-cn/      # 简体中文文档
│   │       ├── en/         # 英文文档
│   │       └── es/         # 西班牙语文档
│   └── content.config.ts   # 内容集合 Schema 配置
├── astro.config.mjs        # Astro 与 Starlight 插件配置
└── public/                 # 静态公开资源

git clone https://github.com/okcode-es/okcode.git
cd okcode
npm install

在根目录创建 .env 文件（可选，用于存储敏感 ID）：

PUBLIC_ALGOLIA_APP_ID=RGT6K369RP
PUBLIC_ALGOLIA_API_KEY=your_api_key

• 启动预览: npm run dev
• 生产构建: npm run build
• 本地预览构建: npm run preview

本项目采用 MIT License 许可。