这是做什么的
「文档」用来放结构化的说明类内容，比如产品说明书、帮助文档、知识库文章。它和普通文章最大的不同是：文档之间可以有「父级—子级」的关系（一篇文档挂在另一篇文档下面），像一本书的目录一样层层展开。
小提醒：文档模块必须配合「现代Markdown编辑器（vditor）」使用。如果你没把编辑器切成它，一进文档页面就会被拦下并提示「文档模块必须配合vditor编辑器使用，请到设置修改」。
在哪里操作（菜单路径 + 截图占位）
- 文档列表：后台左侧菜单「文档」→「所有文档」（直接点「文档」也行）。
- 文档分类：后台左侧菜单「文档」→「文档分类」。
【此处插入：文档列表页面截图】
【此处插入：文档新增/编辑页面截图】
操作前准备
- 先把编辑器切成 Markdown：进入「设置」页，把「编辑器」选为「现代Markdown编辑器（推荐）」。这一步没做，文档功能无法使用。
- 先建好分类：到「文档」→「文档分类」里至少建一个分类。没有分类时，列表会提示「请先添加文档分类」。
- 准备封面图（可选）：想给文档配缩略图的话，提前按页面提示的尺寸准备好图片。
- 想好这篇文档要不要挂在别的文档下面（做子文档）。
新增（分步操作）
进入方式：在「所有文档」列表右上角点「添加」（或在某个分类里点「添加」）。如果要作为某篇文档的子文档，也可以在列表里直接点那一行的「+ 添加子文档」。
【此处插入：文档新增表单截图】
- 文档标题
- 位置：表单最上方第一行。
- 填什么：这篇文档的名字，如「安装与卸载说明」。
- 是否必填：必填。
- 填错后果：留空无法提交；超过约 150 个字符也会被拦下。
- 网址别名 (Slug)
- 位置：标题下方（若站点开启了「网址别名」功能才会出现）。
- 填什么：网址里用的英文短名，只能用小写字母、数字和连字符（-），例如
install-guide。点右侧「自动生成」可由标题自动生成。 - 是否必填：开启了该功能时必填，且全站唯一。
- 填错后果：填了大写字母、空格、中文，或和别人重复，都会保存失败报错，需改成小写字母/数字/连字符。
- 文档分类
- 位置：Slug 下方。
- 填什么：这篇文档属于哪个分类。
- 是否必填：必填（系统默认已选好你进入时所在的分类）。
- 注意：这一栏是灰色不可点的——你在哪个分类的列表里点「添加」，它就会自动归到那个分类。想换分类，请回到列表用「移动分类至」批量改。
- 父级文档
- 位置：文档分类下方。
- 填什么：想让这篇文档挂在哪篇文档下面，就选那篇文档；不想挂靠，保持「未分类」（表示它是顶级文档）。
- 是否必填：选填。
- 填错后果：若形成「你挂我、我挂你」的死循环，前台目录会错乱，选父级时注意别互相引用。
- 自定义属性
- 位置：父级文档下方（只有在「设置」里为文档配置过自定义属性时才会出现）。
- 填什么：按提示的字段顺序填写，多个值用英文逗号隔开。
- 是否必填：选填。
- 文档描述
- 位置：正文编辑区。
- 填什么：文档的正文内容，支持 Markdown 写法（用
**文字**加粗、-开头做列表、#做小标题等）。 - 是否必填：选填。
- 小贴士：编辑器工具栏上有「AI」等辅助按钮（需站点启用 AI 模块），可帮你想正文。
- 缩略图
- 位置：正文下方。
- 填什么：文档的封面图，点上传按钮选择图片。
- 是否必填：选填。
- 填错后果：图片过大时会按设置里的尺寸自动压缩/裁剪，建议先用合适尺寸的图。
- 排序
- 位置：缩略图下方。
- 填什么：一个数字，默认 50。
- 是否必填：选填。
- 规律：数字越小越排前面，默认 50；想更靠前就填比 50 小的数。
- 添加日期
- 位置：排序下方。
- 填什么：这篇文档的日期，默认已填今天。
- 是否必填：必填。
- 填错后果：格式不对（不是日期）会保存失败。
- 关键字
- 位置：添加日期下方。
- 填什么：给搜索引擎用的关键词，多个用英文逗号隔开。
- 是否必填：选填。
- 简单描述
- 位置：表单最后一个输入框。
- 填什么：一句话简介，常显示在列表或搜索结果里。
- 是否必填：选填。
- 全部填好后点最下方的「提交」。保存成功后会停在编辑页，可继续修改。
若站点开启了多语言：标题、描述、关键字、简单描述右侧会出现其他语言的按钮，点击可为该语言单独填写翻译。
编辑 / 修改
- 在「所有文档」列表里，点文档标题，或点该行右侧的「编辑」，进入编辑页。
- 编辑页和新增页长得一样，字段含义相同；改完点「提交」即可。
- 要换分类不能直接在编辑页改（分类栏是灰色锁定的），请回列表用「移动分类至」。
删除 / 批量操作
删除单篇文档
- 在列表里找到那一行，点右侧「删除」。
- 弹出确认框，点确认后删除，不可恢复。
- 注意：如果这篇文档下面还挂着子文档，会提示「不是末级文档，您不能删除」，需要先删掉或移走它的子文档。
批量操作
- 在列表第一列勾选要处理的多行（表头勾选框可全选）。
- 在列表底部的下拉框里选动作：
- 移动分类至：再在旁边的下拉框选目标分类，点「执行」，这些文档会整体换到新分类。
- 文档模块没有「批量删除」选项，只能逐条删除。
- 注意：批量「移动分类至」后，这些文档的父级文档会被清空（变成新分类里的顶级文档）。
- 没勾选就点执行，会提示「没有选择任何文档」。
列表页常用操作
【此处插入：文档列表筛选与状态截图】
- 按分类筛选：列表上方是横排的分类标签（不是下拉框），点某个分类名只看该分类的文档；分类多时最右侧会出现「未分类」标签。
- 关键字搜索：右上角输入框输入标题关键词，点「筛选」。
- 显示 / 隐藏：直接点「状态」列的「显示/隐藏」文字即可切换，不用进编辑页，前台会立刻跟着变。
- 排序：列表里有「排序」列显示数值，想改就去编辑页改这个数字（数字越小越靠前）。
- 分页：列表底部有翻页，一页展示条数可在「设置」里调整。
- 其他：标题后面若有一个小图片图标，说明这篇文档上传了缩略图，点它可查看原图。
分类管理
进入方式：左侧菜单「文档」→「文档分类」。
【此处插入：文档分类页面截图】
列表列有：分类名称、别名、图标、简单描述、排序、操作。
新增一个分类
- 右上角点「添加」。
- 分类名称：必填，如「新手入门」。
- 别名：必填，只能小写字母/数字/连字符，且不能和其他分类重名。
- 图标：选填，点上传选一张小图。
- 关键字 / 简单描述：选填，用于搜索和前台简介。
- 排序：选填，默认 50，数字越小越靠前。
- 点「提交」。
文档分类是扁平的，后台没有「上级分类」层级，也没有「同步到自定义导航」选项；分类之间的层级由前台的展示方式决定。
编辑 / 删除分类
- 编辑：点分类行的「编辑」，改完「提交」。
- 删除：点「删除」并确认。如果该分类下还有文档、或还有子分类，会提示不能删除，请先把内容清空或移走后再删。
常见问题 / 小贴士
- 进文档页报「必须配合vditor编辑器」怎么办？ 去「设置」把「编辑器」改成「现代Markdown编辑器（推荐）」即可。
- 保存时提示别名错误？ 别名只能用小写字母、数字、连字符（-），且不能重复。
- 为什么编辑页改不了分类？ 文档分类栏是锁定的，请回列表用「批量移动分类至」。
- 删不掉文档或分类？ 文档有子文档、分类有内容或有子分类时都不能删，先处理里面的东西。
- 想让某篇文档排第一？ 把它的「排序」数字改得比别的小（默认 50）。
- 文档和文章有什么区别？ 文档有「父级文档」，能做成树状目录；文章是平铺的新闻/资讯。