Skip to content

内容管理系统 (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移动端 双视图切换。

点击列表中的 "预览" 按钮,打开预览弹窗:

  1. 设备切换: 弹窗顶部栏包含切换按钮。
    • 🖥️ PC 模式: 展示宽屏排版,适合检查桌面端显示效果。
    • 📱 Mobile 模式: 模拟 iPhone 尺寸与边框,内容区在“手机屏幕”内独立滚动,完美还原移动端阅读体验。
  2. Markdown 渲染: 集成了 Vditor 引擎,Markdown 内容会自动解析为 HTML,并支持 代码高亮
  3. 暗黑模式: 预览组件完全适配系统的深色模式 (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 解析错误,请尝试刷新页面或清除浏览器缓存。