# BlogLoom

> BlogLoom 是一套基于 Spring Boot 与 Vue 的开源博客 CMS，覆盖 Markdown 创作、内容管理、站点配置、评论互动与访问统计。

## v1

### 首页

- [BlogLoom v1](https://blogloom.changlu.cloud/v1/zh/intro.md): 一套面向个人开发者与内容创作者的开源博客平台

### 指南

#### 快速开始

- [什么是 BlogLoom？](https://blogloom.changlu.cloud/v1/zh/guide/index.md): 一套覆盖内容生产到站点运营的开源博客 CMS。
- [快速开始](https://blogloom.changlu.cloud/v1/zh/guide/quickstart.md): 从数据库初始化到启动博客前台与管理后台。
- [系统架构](https://blogloom.changlu.cloud/v1/zh/guide/architecture.md): 理解博客前台、管理后台与后端服务之间的职责与数据流。

#### 核心概念

- [内容模型](https://blogloom.changlu.cloud/v1/zh/guide/concepts/content-model.md): 文章、分类、标签、专栏、动态与评论之间的关系。
- [Markdown 写作](https://blogloom.changlu.cloud/v1/zh/guide/concepts/markdown.md): 文章编辑支持的 Markdown 语法与内容字段。
- [评论与互动](https://blogloom.changlu.cloud/v1/zh/guide/concepts/comments.md): 评论、回复、点赞与通知机制。

#### 系统模块

- [博客前台（blog-view-ui）](https://blogloom.changlu.cloud/v1/zh/guide/modules/blog-view-ui.md): 面向访客的博客门户模块。
- [管理后台（blog-cms-ui）](https://blogloom.changlu.cloud/v1/zh/guide/modules/blog-cms-ui.md): 面向站长的内容管理与运营后台。
- [后端服务（blog-backend）](https://blogloom.changlu.cloud/v1/zh/guide/modules/blog-backend.md): REST API、认证、业务逻辑、数据访问与任务调度。

#### 博客前台

- [首页与导航](https://blogloom.changlu.cloud/v1/zh/guide/frontend/home.md): 博客前台的首页结构与站点导航配置。
- [文章阅读](https://blogloom.changlu.cloud/v1/zh/guide/frontend/article.md): 文章详情页的结构与阅读体验。
- [归档与搜索](https://blogloom.changlu.cloud/v1/zh/guide/frontend/archive-search.md): 按分类、标签和归档浏览文章，以及站内搜索。
- [动态与点赞](https://blogloom.changlu.cloud/v1/zh/guide/frontend/moments.md): 短内容动态的展示与点赞互动。

#### 管理后台

- [数据仪表盘](https://blogloom.changlu.cloud/v1/zh/guide/admin/dashboard.md): 站点内容与访问数据的运营概览。
- [文章创作](https://blogloom.changlu.cloud/v1/zh/guide/admin/article-editor.md): 使用 Markdown 编辑器创作与发布文章。
- [内容管理](https://blogloom.changlu.cloud/v1/zh/guide/admin/content.md): 文章、动态、分类、标签与评论的集中维护。
- [站点设置](https://blogloom.changlu.cloud/v1/zh/guide/admin/site.md): 站点信息、社交链接、友链与关于页配置。
- [图床管理](https://blogloom.changlu.cloud/v1/zh/guide/admin/media.md): 本地与阿里云 OSS 的上传配置。
- [系统管理与日志](https://blogloom.changlu.cloud/v1/zh/guide/admin/system.md): 账号、定时任务与日志中心。

#### 参考

- [API 参考](https://blogloom.changlu.cloud/v1/zh/guide/reference/api.md): 公开端与管理端 REST 接口概览。
- [身份认证](https://blogloom.changlu.cloud/v1/zh/guide/reference/authentication.md): 管理端登录与基于 JWT 的鉴权流程。
- [数据库结构](https://blogloom.changlu.cloud/v1/zh/guide/reference/database.md): 数据库脚本、初始化与增量升级。
- [常见问题](https://blogloom.changlu.cloud/v1/zh/guide/reference/faq.md): 部署与使用过程中的高频问题。

### 部署与运维

#### 开始使用

- [部署概览](https://blogloom.changlu.cloud/v1/zh/deploy/index.md): 从本地开发到生产部署的完整路径。
- [环境要求](https://blogloom.changlu.cloud/v1/zh/deploy/environment.md): 运行 BlogLoom 所需的软件与版本。
- [Docker 部署](https://blogloom.changlu.cloud/v1/zh/deploy/docker.md): 使用 Docker 一键部署 BlogLoom。

#### 安装部署

- [初始化数据库](https://blogloom.changlu.cloud/v1/zh/deploy/database.md): 创建数据库并通过增量脚本完成初始化。
- [部署后端](https://blogloom.changlu.cloud/v1/zh/deploy/backend.md): 打包并运行 blog-backend。
- [构建与部署前端](https://blogloom.changlu.cloud/v1/zh/deploy/frontend.md): 构建博客前台与管理后台的静态资源。
- [Nginx 配置](https://blogloom.changlu.cloud/v1/zh/deploy/nginx.md): 托管前端静态资源并反向代理后端 API。

#### 配置

- [配置说明](https://blogloom.changlu.cloud/v1/zh/deploy/configuration.md): 后端与前端的关键配置项。
- [安全加固](https://blogloom.changlu.cloud/v1/zh/deploy/security.md): 上线前需要完成的安全检查。

#### 运维

- [运维](https://blogloom.changlu.cloud/v1/zh/deploy/operations.md): 备份、升级与日常维护。
- [故障排查](https://blogloom.changlu.cloud/v1/zh/deploy/troubleshooting.md): 按症状定位常见问题。

### 集成

#### 集成

- [集成概览](https://blogloom.changlu.cloud/v1/zh/integration/overview.md): BlogLoom 的外部依赖与可扩展能力。

#### AI 技能

- [AI Skill 同步](https://blogloom.changlu.cloud/v1/zh/integration/ai-skill.md): 下载专属 AI 技能包，用自然语言把本地 Markdown 文章同步到 BlogLoom。

#### 图床存储

- [本地图床](https://blogloom.changlu.cloud/v1/zh/integration/storage/local.md): 将图片上传到服务器本地目录。
- [阿里云 OSS 图床](https://blogloom.changlu.cloud/v1/zh/integration/storage/aliyun.md): 使用阿里云 OSS 存储图片资源。

#### 通知

- [邮件通知](https://blogloom.changlu.cloud/v1/zh/integration/notification/email.md): 配置评论邮件通知。

#### 数据存储

- [MySQL](https://blogloom.changlu.cloud/v1/zh/integration/data/mysql.md): 内容与日志数据的持久化存储。
- [缓存](https://blogloom.changlu.cloud/v1/zh/integration/data/cache.md): 基于 MySQL 的内部缓存实现。

#### 工具

- [IP 地域解析](https://blogloom.changlu.cloud/v1/zh/integration/utils/ip-region.md): 识别访问来源地域，支撑访客统计。

### 博客

#### 博客

- [博客](https://blogloom.changlu.cloud/v1/zh/blogs/index.md): 版本发布、技术文章与使用场景。
- [BlogLoom 1.0 发布](https://blogloom.changlu.cloud/v1/zh/blogs/v1-release.md): 首个正式版本的能力范围与升级说明。

##### 使用场景

- [使用场景](https://blogloom.changlu.cloud/v1/zh/blogs/usecases/index.md): BlogLoom 适用的典型场景。
- [个人技术博客](https://blogloom.changlu.cloud/v1/zh/blogs/usecases/personal-blog.md): 以 BlogLoom 搭建个人技术博客。
- [开源项目主页](https://blogloom.changlu.cloud/v1/zh/blogs/usecases/project-home.md): 用 BlogLoom 承载项目介绍与更新日志。

### 社区

#### 社区

- [参与贡献](https://blogloom.changlu.cloud/v1/zh/community/how-to-contribute.md): 如何提交 Issue、Pull Request 与维护文档。
- [贡献者](https://blogloom.changlu.cloud/v1/zh/community/contributors.md): BlogLoom 的维护者与贡献者。
- [路线图](https://blogloom.changlu.cloud/v1/zh/community/roadmap.md): BlogLoom 的未来演进方向。

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [English (51 pages)](https://blogloom.changlu.cloud/_llms/en.md): Documentation for English.