用户指南

本指南面向第一次使用 luox 的博客作者，按照安装 → 创建项目 → 写文章 → 选主题 → 生成 → 预览 → 部署的顺序组织。每一节都包含完整步骤、示例文件和常见错误。

阅读路径

我只想先生成一个博客

1. 安装与发布包 — 了解你需要下载什么
2. 创建第一个项目 — 五条命令出站
3. GitHub Pages 部署 — 把 public/ 发布到你的仓库

我想自定义内容和页面

1. 配置文件 — _config.yml 每个字段的含义
2. 文章与 Front Matter — 写文章、打标签、设草稿
3. 页面、分类与标签 — about、categories、tags、archives
4. 项目结构 — 每个目录是什么、哪些可以改

我想控制视觉效果

1. 主题与静态资源 — 安装主题、编写 CSS、注入 JS
2. 命令行参考 — 所有命令和参数

我遇到了问题

• 开发服务器与调试 — 本地预览和日志
• 故障排查 — 按症状定位

一分钟概览

luox cl my-blog        # 创建项目
cd my-blog             # 进入
luox new "第一篇文章"  # 写文章
luox g                 # 生成 → public/
luox d                 # 预览
luox deploy            # 部署（dry-run）

如果你准备开发主题或插件，请跳转到插件开发。想理解 luox 为什么这样设计，请看架构说明。