内容管理系统 (CMS) 使用手册
本手册将帮助您快速掌握 NestBase 内容管理系统的使用方法,包括文章管理、分类管理、标签管理以及最新的预览功能。
1. 访问入口
登录系统后,在左侧菜单栏找到 "内容管理" 模块:
- 文章管理:
/manage/content/article- 核心内容发布与管理 - 分类管理:
/manage/content/category- 文章分类配置 - 标签管理:
/manage/content/tag- 文章标签配置
2. 文章管理
2.1 文章列表与搜索
进入文章管理页面,您可以看到所有文章的列表。顶部提供了丰富的搜索筛选功能:
- 标题: 输入关键词模糊搜索。
- 状态: 筛选
草稿/已发布/已下架。 - 分类: 选择所属分类。
- 发布时间: 选择起始和结束日期范围。
- 高级筛选: 支持按 编辑器类型、置顶、推荐 等属性筛选。
2.2 创建与编辑文章
点击右上角 "新增文章" 按钮,或点击列表中的 "编辑" 按钮。
在侧滑抽屉中填写文章信息:
- 基础信息: 标题、Slug (URL标识)、摘要。
- 编辑器类型: 支持
Markdown和富文本两种模式。- Markdown: 适合技术文档,支持代码高亮。
- 富文本: 适合图文混排,所见即所得。
- 发布设置:
- 发布时间: 可指定未来的时间进行定时发布(需后台任务配合,目前作为记录字段)。
- 置顶/推荐: 开启后将在前端通过 API 优先展示。
2.3 多端响应式预览 (New ✨)
我们在 v1.5.0 版本中重构了预览功能,支持 PC 和 移动端 双视图切换。
点击列表中的 "预览" 按钮,打开预览弹窗:
- 设备切换: 弹窗顶部栏包含切换按钮。
- 🖥️ PC 模式: 展示宽屏排版,适合检查桌面端显示效果。
- 📱 Mobile 模式: 模拟 iPhone 尺寸与边框,内容区在“手机屏幕”内独立滚动,完美还原移动端阅读体验。
- Markdown 渲染: 集成了
Vditor引擎,Markdown 内容会自动解析为 HTML,并支持 代码高亮。 - 暗黑模式: 预览组件完全适配系统的深色模式 (Dark Mode)。
2.4 状态管理
在文章列表中,您可以直接通过开关快速调整文章属性:
- 发布状态: 点击开关可立即 发布 或 下架 文章。
- 置顶: 开启后文章排序权重提高。
- 推荐: 开启后文章会被标记为推荐内容。
3. 分类与标签管理
- 分类管理: 支持树形结构(无限层级)。您可以拖拽排序(如有实现)或通过表单设置父级分类。
- 标签管理: 扁平化标签管理,用于文章的多维度标记。支持通过标签名称搜索。
4. 配置说明
4.1 权限配置
若需通过角色控制 CMS 的访问权限,请前往 "系统管理 -> 角色管理"。
建议权限分配:
- 管理员 (Admin): 拥有所有增删改查及发布权限。
- 编辑 (Editor): 拥有文章的创建、编辑、发布权限,但可能无法删除他人文章(视具体后端策略)。
- 访客 (Guest): 仅拥有查看权限(通常通过前台 API 访问)。
4.2 按钮权限
前端已实现细粒度按钮权限控制:
- 新增按钮:
content:article:add - 编辑按钮:
content:article:edit - 删除按钮:
content:article:delete - 导入/导出:
content:article:import,content:article:export
确保用户角色关联了上述权限标识,才能看到对应操作按钮。
提示: 如遇到预览样式异常或 Markdown 解析错误,请尝试刷新页面或清除浏览器缓存。