内容设置
内容设置
内容设置用于控制文档的编辑器、URL 生成规则、列表分页、图片处理与缩略图策略,影响全站内容的录入方式和前台展示效果。
入口路径
后台顶部菜单 →「设置」→「内容设置」。实际地址:/system/setting/content,需要管理员权限(canAdmin)。
功能说明
页面分为「基础配置」「列表与规则」「图片缩略图处理」三个标签页,配置保存后对全站生效。三个标签页保存时是整包覆盖,切换前请确认已保存当前页 [源码]。
界面截图
基础配置:

列表与规则:

图片缩略图处理(含各项默认值):

设置项说明
基础配置
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 默认编辑器 | 发布文档时使用的编辑器 | 富文本(空值)/ Markdown / 简易 [源码+实测] | 一般选富文本;需完全掌控 HTML 用简易;Markdown 门槛较高 | 实测默认「富文本编辑器」 |
| 下载远程图片 | 保存文档时把正文外链图片下载到本地 | radio:0停用 / 1启用;实测默认「启用」[实测] | 用自有图床时可停用 | 启用后外链图片会落到本站资源库 |
| 内容外链处理 | 控制正文中的外部链接 | radio:0保留 / 1移除 / 2添加Nofollow [源码+实测];实测默认「移除链接」 | 不希望外流权重选「添加Nofollow」 | 0保留原链接;1移除链接;2给链接加 rel="nofollow"——只有值 2 才加 nofollow,0 不会加 [源码] |
列表与规则
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 自定义URL格式 | 文档链接的拼音形式 | radio:0全拼音 / 1首字母 [源码] | 中文站用全拼音,长标题可用首字母 | 影响伪静态命名模式的 URL |
| 文档多分类支持 | 允许一篇文档属于多个分类 | radio:0停用 / 1启用 [源码] | 默认停用 | 启用后可能增加加载开销 |
| 启用文档排序 | 允许手动指定文档排序 | radio:0停用 / 1启用 [源码] | 默认停用 | 启用后可能增加加载开销 |
| 自动添加文档标签 | 新建文档时自动匹配标签库 | radio:0停用 / 1启用 [源码] | 依赖标签库已有数据 | 无标签库时无效果 |
| 列表**显示页码 | 列表翻页上限 | 数字,源码默认 1000 [源码],运行时 <1 兜底 1000 |
不要设置过大 | 过大会增加单页读取负担 |
| 列表单页**显示条数 | 每页文档数上限 | 数字,源码默认 100 [源码],运行时 <1 兜底 100 |
按性能设置 | 过大影响列表页加载 |
图片缩略图处理
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 图片Alt优化 | 保存文档时给无 alt 的正文图片填充文档标题 | radio:0停用 / 1启用;实测默认「停用」[实测] | 有 SEO 需求的站点建议启用 | 多图自动加序号;已有 alt 不覆盖 |
| 启用Webp图片格式 | 上传的 jpg/png 转为 Webp | radio:0停用 / 1启用;实测默认「启用」[实测] | 多数站点建议启用以减小体积 | 只对修改设置后上传的图片生效 |
| 转换GIF图片为Webp | GIF 也转 Webp | radio:0停用 / 1启用;实测默认「停用」[实测] | 需要保留动画时保持停用 | 启用后 GIF 动画丢失,变静态图 |
| 图片质量 | jpg/webp 压缩质量 | 数字 10–100 [源码],默认 90 [常量];实测 90 [实测] | 默认 90 即可 | 只对 jpg 与 webp 生效 |
| 自动压缩大图 | 按宽度压缩上传的大图 | radio:0停用 / 1启用;实测默认「启用」[实测] | 图片大的站点启用 | — |
| 压缩到指定宽度 | 大图压缩宽度(像素) | 数字;源码注释默认 1200 但前端 placeholder 写 800 [冲突];实测 1200 [实测] | 按前台展示宽度设置 | 与上一项联动,仅「自动压缩大图」启用时显示 |
| 缩略图方式 | 缩略图生成方式 | radio:0按最长边等比缩放 / 1按最长边补白 / 2按最短边裁剪;实测默认「按最长边补白」[实测] | 列表卡片用裁剪,图文混排用等比缩放 | — |
| 缩略图尺寸(宽×高) | 缩略图像素尺寸 | 数字,源码默认 250 [源码];实测 300×200 [实测] | 按模板展示区域设置 | 改尺寸后需先提交,再点「批量生成缩略图」 |
| 默认缩略图 | 文档无图时的替代方式 | radio:0随机图片 / 3图片分类;实测默认「随机图片」[实测] | 想统一风格选「图片分类」 | 选择后联动下方附件或分类选择 |
配置项详解
转换GIF图片为Webp
出现条件:仅在「启用Webp图片格式」为「启用」时显示 [源码]。
源码确认启用后 GIF 自动转 Webp,动画效果丢失、变成静态图片 [源码+i18n]。
推荐值:站点有动图需求时保持停用;无动图需求且追求体积时可启用。
填错后果:启用后所有 GIF 变静态,无法恢复原动画。
压缩到指定宽度(默认值冲突)
出现条件:仅在「自动压缩大图」为「启用」时显示 [源码]。
源码注释写默认 1200(config/setting.go:43),前端 placeholder 写 800,实测预填 1200 [COMPUTED]。
推荐值:以实测为准填 1200;如需更小按前台实际展示宽度调整。
填错后果:宽度过小会让大图细节丢失。
默认缩略图(跨字段联动)
出现条件:始终显示 [实测]。
| 取值 | 含义 | 联动字段 |
|---|---|---|
0 |
从选定的图片中随机选择 | 显示多选附件 default_thumbs |
3 |
从指定图片分类中随机选择 | 显示图片分类下拉 thumb_category_id(含「未分类图片」0、「全部图片」-1) |
源码前端提交处注释写成「0=default, 1=category」,与 Go 及界面不一致,以界面选项 0/3 为准 [COMPUTED]。
填错后果:联动字段填错会导致默认缩略图无法输出,前台列表出现空白图。
批量生成缩略图
出现条件:修改了缩略图尺寸后 [源码]。
必须先提交保存尺寸,再点击「批量生成缩略图」,否则已有缩略图不会按新尺寸重算 [源码+i18n]。
操作步骤
- 进入「设置 → 内容设置」。
- 切换到需要修改的标签页。
- 调整选项后点击「提交」;注意三个标签页是整包覆盖。
- 涉及缩略图尺寸变更的,提交后执行批量重新生成。
- 涉及 Webp 转换的,使用附带的转换工具处理存量图片。
适用场景与建议
- 图片多的资讯站:开启 Webp + 自动压缩大图 + 图片 Alt 优化,兼顾体积与 SEO。
- 重视收录的站点:保持「内容外链处理」为「添加 Nofollow」,避免权重外流。
- 大型站点:慎用「多分类」和「文档排序」,它们会增加查询负担。
注意事项
- Webp 转换不会处理设置生效前已上传的图片,需使用 Webp 转换工具批量处理。
- 开启 GIF 转 Webp 会让动图变静态,确认不需要动画后再开启。
- 修改缩略图尺寸后必须执行批量重新生成。
- 本页多处默认值以实测为准(见上表 [实测] 标记);源码与前端 placeholder 有冲突时已在对应项注明。