主题文档写文档后台示例Demo

Theme

Annoying 主题优势

相比 XiunoX 原生,Annoying 更关注成品体验:前台 UI、个人中心、文章阅读、评论区、用户中心、AI 和后台配置都围绕可运营站点设计。

XiunoX

轻量、干净、适合作为论坛底座,但默认 UI 和扩展入口较基础。

Annoying 主题

在 XiunoX 上补齐整站视觉、插件套件、运营模块和文档后台能力。

开源主题骨架

围绕模板、Hook、CSS 变量、Bootstrap 5、Vanilla JS 和 VitePress 文档整理,方便继续二开。

Bootstrap 5基础组件React + Go后台配置

Components

主题组件覆盖前台、后台和运营链路

这些组件按照 Annoying 主题实际遇到的问题整理:粉色旧边框、评论区灰底、插件配置跳转、文章错位、图片过大、流程图不显示等都会逐步收口到主题规则里。

首页首屏与导航玻璃态侧边栏后台分区配置右上角头像菜单自定义文章作者卡片重排个人主页资料卡用户中心视觉升级资料按钮和插件入口评论区无粉色旧边框Mermaid 流程图展示图片尺寸自动约束AI 自动回复融合Annoying 插件后台栏目开源主题介绍文档写作后台文档嵌入官网

Interface

前台体验围绕社区运营重做

Annoying 把 XiunoX 默认页面整理成更接近现代博客社区的体验:导航、侧边栏、文章页、头像菜单、个人主页、按钮、评论和移动端都统一视觉。

  • 右上角头像菜单支持后台自定义
  • 侧边栏分区不再跳回插件管理
  • 作者卡片、个人主页和用户标识统一
  • 评论区去掉旧粉色和灰色背景叠加

Extensions

用户中心与扩展入口形成完整主题链路

相比 XiunoX 原生论坛,Annoying 更适合站长做长期维护。用户中心、资料入口、内容权限、消息入口和扩展插件以统一样式出现。

  • 自定义用户等级和标识
  • 资料、消息、设置入口统一展示
  • 扩展插件进入主题后台
  • 文档说明支持客户项目交付

Workflow

插件后台栏目集中配置

Annoying 主题配套插件不再散落在插件管理页。主题后台提供统一栏目,按 UI、评论、AI、用户中心、官网内容等模块组织配置。

  • 减少点击插件时页面上滑问题
  • 避免未安装插件显示成断层入口
  • 统一保存按钮和配置说明
  • 方便站长给用户开放可配置项

Performance

清理旧规则叠加,保持页面稳定

之前文章、评论、图片、Mermaid 和作者卡片错位,本质是旧 CSS 和旧脚本叠加。Annoying 的方向是减少重复规则,保证每个模块边界清晰。

  • 正文不再被 max-height 裁掉
  • 图片限制最大宽度并保留圆角
  • Mermaid 区块独立加载与降级
  • 右栏卡片不被 flex 压缩