UUQIO / Monoline 主题使用说明

Monoline（theme-uuqio）适用于 Halo 2.27，最低兼容 Halo 2.26。提供企业展示、CMS 与博客三种首页方式。

开始使用

在「外观 → 主题」启用主题，在「全局设置」选择首页布局、默认深浅色和品牌 Logo。默认使用主题内置的黑白 UUQIO 图片，也可分别上传浅色与深色 Logo，或启用 Halo 系统 Logo。

首页布局

企业、CMS、博客分别配置正文模块。模块可独立排序、开启或关闭。企业与 CMS 保留主视觉背景模式；CMS 支持标题、搜索框或组合内容。文章模块支持指定文章、分类、最新和热门来源，以及多种展示布局。

博客文章列表采用点击加载更多，追加内容后保留后续模块。

侧边栏

「侧边栏」独立管理博客首页、瞬间、关于、友链、归档、分类、标签、普通单页面、图库、静态作品与文档页。

每种页面都有独立开关和模块列表，可使用站点资料、热门/最新文章、时间轴、分类、标签、搜索、公告、友情链接、推荐文章或页面等模块。支持排序、重复添加和左右位置；窄屏在正文下方展示。

无封面文章

默认封面只影响前台展示，不修改文章原有封面。可选择统一图片、内置随机来源、自定义随机接口或根据标题自动生成。自动生成支持多种风格与配色组合。

瞬间

需要安装官方瞬间插件。列表支持点赞、展开评论、查看详情与点击加载更多；详情页保留独立讨论区和返回瞬间入口。评论输入、登录和评论管理由 Halo 评论组件提供。登录后的作者或管理员可打开瞬间管理。

静态作品

需要安装静态网页服务插件，在插件中上传项目文件。新建单页面，选择「静态作品」模板。主题「静态作品页面」配置名称、介绍、列数和项目封面。

静态插件没有公开的项目列表接口；可用 npm run halo -- theme sync-integrations --profile <配置名> --apply 同步后台项目基本信息。同步保留已有项目封面、顺序和手动添加的链接。项目更新后可再次同步。前台不使用后台令牌，点击作品在新标签页访问。

文档

需要安装 My Docs 插件（已验证 1.7.6）。插件原有 /docs、文档库和阅读页面复用主题导航与页脚；排序、行列、文件夹、Markdown 内容样式、代码主题和阅读增强仍在插件内配置。

新建单页面选择「文档总览」模板，按库汇总全部已发布文档。「文档页面」可配置总览标题、介绍、卡片或列表、列数和主题外观。草稿不出现在公开总览中。

代码高亮

官方 highlight.js 插件自动注入依赖并识别代码语法，主题不重复加载高亮引擎。「插件与代码高亮」可让 token 颜色跟随主题深浅色。建议关闭插件复制按钮，使用主题自带复制按钮。插件目前以维护为主，主题兼容现有版本。

SEO 与页面结构

Halo 核心按系统设置及当前页面注入 description、keywords、favicon 和访问统计。主题另外生成 canonical、Open Graph、Twitter Card 和 JSON-LD；这两项开关默认作用于所有支持的公开页面。已使用相同功能的 SEO 插件时只保留一方，避免重复。

结构化数据帮助搜索引擎和 AI 理解页面、作者、时间与内容类型，不能保证收录、排名或引用。文章使用实际摘要、作者和时间。自动生成封面仅在前端显示，不作为公开分享图片；分享图片应配置可公开访问的地址。

JSON-LD 与页面配置数据不是执行脚本。深浅色初始化留在 head 防止闪白，主题交互模块在 body 尾部；插件脚本保留自身的依赖和初始化顺序。

维护

更新主题前保留实例备份。源码在 src/，构建输出在 templates/ 与 dist/，不要直接修改生成文件。使用 npm，并在改动后运行 npm run check 和 npm run build。插件停用时，相关页面显示空状态而不影响站点其他内容。