极致·文档主题 使用手册

🎯 主题概述

主题简介

极致·文档主题是一款专为Z-BlogPHP设计的专业级文档类主题，特别适合技术文档、知识库、产品手册等场景。主题采用现代化的设计语言，提供丰富的自定义选项和优秀的用户体验。

适用场景

🚀 安装与配置

安装步骤

1. 下载主题：从官方应用中心获取主题

2. 启用主题：Z-Blog后台→主题管理→启用极致·文档主题

3. 基础配置：可参考本手册进行配置

配置流程建议

基础设置 → SEO优化 → 首页模块 → 文章系统 → 广告设置 → 其他功能

⚙️ 基础设置详解

Logo与品牌设置

图片Logo配置

启用图片logo: 开启
LOGO地址: http://域名/zb_users/theme/Jz52_docs/style/images/logo.svg
暗黑模式LOGO: http://域名/zb_users/theme/Jz52_docs/style/images/nlogo.svg

文字Logo配置

启用图片logo: 关闭
logo图标: fas fa-book-open
logo文字: DOCSTHEME

图标使用指南

主题内置Font Awesome 6.7.2图标库：

头像系统配置

QQ头像+随机头像: 开启
随机头像文件名使用首字母: 开启
Gravatar头像: 开启

头像显示优先级：

1. QQ头像（邮箱匹配QQ号）

2. Gravatar头像（邮箱注册）

3. 随机头像（用户名首字母）

4. 系统默认头像

时间显示设置

翻页方式配置

文章时效提醒

建议天数: >90
提示内容: |
  <div class="alert alert-warning">
    <em class="fas fa-info-circle"></em>
    本文最后更新于{daysDiff}天前，请注意内容是否还可用
  </div>

💰 赞赏与互动系统

基础配置

启用赞赏按钮: 开启
赞赏文字: 赞赏
启用点赞: 开启
显示相关文章: 开启

收款码设置

微信收款码: http://域名/zb_users/theme/Jz52_docs/style/images/weipayimg.svg
支付宝收款码: http://域名/zb_users/theme/Jz52_docs/style/images/alipayimg.svg
QQ收款码: http://域名/zb_users/theme/Jz52_docs/style/images/qqpayimg.svg

📚 文章系统配置

左导航设置

调用方式选择

排序规则配置

排序字段: 发布时间
排序方向: 升序
包含子分类: 开启
包含顶分类: 开启
最大文章数: 99
多级默认折叠: 开启
拖动调整宽度: 开启
目录图标: 开启
无刷加载: 开启

全局文章排序系统

排序字段选项

排序方向

• 降序：新内容在前（DESC）

• 升序：旧内容在前（ASC）

分类级排序设置

每个分类可单独设置排序规则，覆盖全局设置。

🏠 首页模块配置

搜索区域配置

大标题: "您的网站主标题"
说明: "用一段话描述网站特色和价值"
预置词: "关键词1|关键词2|关键词3"

精选区域配置

模块配置参数表：

分类区域配置

- 是否开启: 开启
  图标: fas fa-code
  数据来源: 分类数据
  调用分类: 技术文档
  标题: 开发文档
  说明: 技术文档和教程集合
  链接: /category/tech

推荐阅读区域

图标: fas fa-paperclip
区域标题: 推荐阅读
调用条数: 8

🌐 SEO优化配置

基础SEO设置

主题SEO设置: 开启
站点标题: 主标题 - 副标题
关键词: 核心词1,核心词2,核心词3
网站描述: 150字内描述文字，包含关键词

页面标题模板

拖拽排序说明

• 通过拖拽调整标题组件顺序

• 组件间自动添加分割符

各页面标题配置

高级SEO功能

功能开关表

灯箱控制选项

• 缩略图：显示图片导航

• 全屏：支持全屏查看

• 缩放：支持图片缩放

• 旋转镜像：旋转镜像操作

📢 广告系统配置

广告位位置详解

广告代码示例

横幅广告代码

<div style="width: 100%; height: 80px; line-height: 80px; text-align: center;">广告位：后台设置广告代码</div>

🎥 视频功能配置

基础视频设置

启用视频播放: 开启
M3U8支持: 开启
视频最大宽度: 420px
播放器logo: http://域名/zb_users/theme/Jz52_docs/style/images/videologo.png

视频嵌入方式

本地视频嵌入：

发布文章，上传或填入视频文件地址

在线视频嵌入：

发布文章，填入视频网站嵌入代码

⚡ 其他功能配置

主题夜间模式设置

默认夜间模式: 关闭
定时开启夜间模式: 22-6

宽窄屏切换

默认宽屏: 开启
宽屏最大宽度（首页、列表）: 1400px
宽屏最大宽度（文章）: 100%

宽度单位支持：

• px：固定像素（1200px）

• vw：视口宽度（80vw）

• %：百分比（90%）

自定义功能

自定义CSS: |
  /* 自定义样式代码 */

顶部附加代码: 
  <!-- 全站头部附加代码 -->

🛠️ 实用工具与技巧

内置图标使用

主题内置Font Awesome 6.7.2免费版，完整类名参考：Font Awesome图标库

浏览器图标设置

1. 准备32×32像素favicon.ico文件

2. 使用在线工具生成：透明ICO生成器

3. 上传到网站根目录

4. 自动识别显示

导航菜单设置

桌面导航图标

1. 启用「链接模块管理」插件

2. 模块管理→导航栏→编辑

3. 「图标」字段填入Font Awesome类名

4. 提交保存

手机导航设置

1. 启用「链接模块管理」插件

2. 模块管理→文档主题手机菜单

3. 配置菜单项并提交

💡 参考配置实践

场景化配置方案

技术文档网站

基础设置:
  翻页设置: 手动加载
  时间显示: XXX前
  左导航: 多级分类
  排序: 发布时间升序

首页模块:
  搜索区域: 技术文档搜索
  精选区域: 最新更新+热门教程
  分类区域: 完整技术分类

新闻资讯网站

基础设置:
  翻页设置: 自动加载
  时间显示: 年-月-日 时:分:秒
  左导航: 分类内固定N篇
  排序: 发布时间降序

首页模块:
  搜索区域: 新闻搜索
  精选区域: 头条新闻+热点专题

个人知识库

基础设置:
  翻页设置: 默认分页
  时间显示: XXX前
  左导航: 多级分类+无刷加载
  赞赏系统: 开启

SEO优化策略

新网站配置

站点标题: 品牌名 - 品牌口号
关键词: 核心业务关键词
网站描述: 突出特色的150字描述
开启基础SEO功能

成熟网站配置

开启所有高级SEO功能
设置OG默认图片
配置结构化数据
开启时间因子

广告投放策略

流量分布策略

用户体验优化

• 重要页面控制广告数量

• 使用原生广告提升体验

• 避免弹窗式广告

⚠️ 重要注意事项

性能优化建议

兼容性说明

安全提醒

1. 顶部附加代码：不要插入不可信代码

2. 自定义CSS：避免布局冲突

3. 清除配置：操作前务必备份

🔧 故障排除指南

常见问题解决

问题排查步骤

1. 检查配置是否保存成功

2. 清除浏览器缓存测试

3. 查看浏览器控制台错误

4. 检查文件权限设置

5. 查看系统错误日志

获取技术支持

遇到无法解决的问题时，请提供：

1. 订单号

2. 主题版本号

3. Z-BlogPHP版本号

4. 问题详细描述

5. 错误截图或日志

6. 重现步骤