DOC-01上手主题11 分钟2026.09.04

Theme

Pixel主题文档

Clay Article 使用手册

概述Clay Article 是一款面向认真创作者的暖调极简长文博客主题。它以窄栏排版、衬线正文与阅读进度条为核心体验，把注意力还给文字本身——无论你写评论、随笔、技术长文还是连载专栏，都能得到稳定、克制、可长时间停留的阅读场。本手册覆盖从安装启用、基础配置、内容结构、版式与排版、模块能力、性能与 SEO，到授权、升级与常见问题的完整流程。建议按章节顺序阅读；若你已熟悉 WordPress 主题安装，可从「首次配置」直接开始。

概述

Clay Article 是一款面向认真创作者的暖调极简长文博客主题。它以窄栏排版、衬线正文与阅读进度条为核心体验，把注意力还给文字本身——无论你写评论、随笔、技术长文还是连载专栏，都能得到稳定、克制、可长时间停留的阅读场。

本手册覆盖从安装启用、基础配置、内容结构、版式与排版、模块能力、性能与 SEO，到授权、升级与常见问题的完整流程。建议按章节顺序阅读；若你已熟悉 WordPress 主题安装，可从「首次配置」直接开始。本手册覆盖从安装启用、基础配置、内容结构、版式与排版、模块能力、性能与 SEO，到授权、升级与常见问题的完整流程。建议按章节顺序阅读；若你已熟悉 WordPress 主题安装，可从「首次配置」直接开始。本手册覆盖从安装启用、基础配置、内容结构、版式与排版、模块能力、性能与 SEO，到授权、升级与常见问题的完整流程。建议按章节顺序阅读；若你已熟悉 WordPress 主题安装，可从「首次配置」直接开始。

适合谁

以长文、专栏、深度评论为主的个人作者与独立媒体
希望前台安静、少干扰、强调阅读节奏的内容站
需要清晰授权、可持续更新与文档支持的付费主题用户

设计原则

文字优先：默认栏宽约 66ch，行高与字距针对中文长段落校准
暖调克制：纸面感背景与衬线正文，避免喧宾夺主的装饰
可预期：模板层级清晰，常用能力在主题选项中可开关，不依赖一堆零散插件

系统要求

上线前请确认运行环境满足下列要求。低于最低版本可能导致安装失败、样式错乱或后台选项无法保存。

软件环境

WordPress：6.4 及以上（推荐使用当前正式版）
PHP：8.0 – 8.3（推荐 8.1+）
MySQL：8.0 及以上；MariaDB 10.5+ 亦可
Web 服务器：推荐 Nginx；Apache 需开启 mod_rewrite

服务器与扩展

推荐独立云主机或物理机；共享虚拟主机可能因资源限制影响图片处理与缓存表现
PHP 扩展建议开启：curl、mbstring、xml、zip、gd 或 imagick
内存建议：PHP memory_limit ≥ 256M；上传包较大时同步提高 upload_max_filesize / post_max_size

浏览器支持

前台与主题自定义器支持近两年版本的 Chrome、Edge、Firefox、Safari。不承诺完整兼容 Internet Explorer。

安装与启用

你可以通过后台上传安装，或使用 WP-CLI。安装完成后务必启用主题，并按「首次配置」完成基础检查。

后台上传安装

登录 WordPress 后台 → 外观 → 主题 → 添加
选择「上传主题」，上传购买后获得的 .zip 安装包（不要解压后二次压缩错误目录层级）
安装完成后点击启用
若提示缺少推荐插件，可按提示安装；非必需插件可稍后处理

WP-CLI 安装

# 将主题解压到 wp-content/themes/clay-article
wp theme activate clay-article

# 确认当前主题
wp theme list --status=active

安装后自检清单

前台首页可访问，无致命 PHP 报错
后台出现 Clay Article 主题选项入口（或「外观 → 自定义」中的主题面板）
文章详情页显示窄栏正文与阅读进度条（若已开启）
固定链接建议使用「文章名」结构，并点击保存一次以刷新重写规则

提示：若启用后样式丢失，优先检查是否误启用了子主题空壳、缓存插件未刷新，或 CDN 仍缓存旧主题静态资源。

授权与激活

Clay Article 采用站点授权机制。请在可访问公网的生产域名上完成激活；本地开发可使用主题提供的开发许可策略（以购买页说明为准）。

激活步骤

打开主题选项中的授权 / License面板
粘贴订单中的 License Key
确认当前站点 URL 与授权域名一致（含是否带 www、是否 https）
保存并等待校验通过；成功后可下载更新与解锁完整能力

域名与换绑

授权域名数量与换绑次数取决于你购买的授权档位
从测试域迁移到正式域时，先在授权中心解绑旧域，再在新域激活
请勿在多个生产站点共用同一把仅限单站的 Key

首次配置

启用主题后，建议按下列顺序完成第一次配置，避免内容录入后才发现结构不对。

1. 固定链接与阅读设置

设置 → 固定链接：选择「文章名」，保存
设置 → 阅读：首页显示「最新文章」或指定静态页（Clay Article 对两种模式均友好）
时区与站点语言按受众设置，影响日期展示与部分文案

2. 菜单与站点标识

在 外观 → 菜单 创建主导航，并勾选主题提供的菜单位置（通常为 Header Primary）
上传站点 Logo（建议 SVG 或 2x PNG），并填写站点标题 / 副标题
页脚菜单、社交链接按需配置；无内容的菜单位置可留空

3. 首页与归档基调

在主题选项中选择首页列表样式：经典列表 / 杂志卡片 / 极简时间线（以当前版本选项为准）
设置归档页是否显示摘要、特色图、阅读时长估算
关闭不需要的首页模块，保持首屏干净

4. 排版与阅读体验

开启阅读进度条（文章页顶部或底部细条）
确认正文字体栈：衬线优先；若站点以代码内容为主，可在选项中切换更偏无衬线的混排方案
设置文章页是否显示作者、发布日期、分类、上一篇 / 下一篇

内容结构建议

Clay Article 的优势在「长文可读性」。内容结构稍作规划，前台观感会明显更稳。

文章写作建议

标题简洁有力；避免过长 SEO 堆砌标题破坏封面与列表节奏
正文使用清晰的 H2 / H3 层级，便于目录与扫读
段落不宜过碎；中文长文可适当增加段间距，主题已为长段落预留行高
代码块、引用、列表主题均有样式；请使用区块编辑器原生块，避免粘贴带脏样式的 Word HTML

特色图片

推荐比例约 16:9 或 3:2；主题会按模板裁切
列表页与详情页可分别控制是否展示特色图
无图文章会回退到更偏文字的列表样式，属于预期行为

分类、标签与专栏

用分类表达稳定栏目（如「评论」「笔记」「译介」）
用标签表达横切主题；避免标签爆炸
若使用自定义「专栏 / Series」能力（视版本），请保持专栏内文章排序一致

模板与页面类型

主题围绕博客阅读场景组织模板。了解默认模板有助于你决定哪些页面需要自定义。

核心模板

首页 / 最新文章：列表节奏与摘要策略由主题选项控制
单篇（single）：窄栏正文、进度条、文末导航、相关阅读
页面（page）：可用于「关于」「留言」等；可选全宽或窄栏页面模板
归档：分类、标签、作者、日期归档共享统一视觉语言
搜索结果：强调标题与摘要命中，减少噪声模块
404：简洁返回首页 / 搜索入口

主题选项速览

以下为常见选项分组说明。具体字段名以你安装版本后台为准；升级后请浏览一遍选项面板，确认新增开关的默认值。

全局与品牌

站点 Logo、深浅色 Logo、站点图标
主色 / 强调色（建议保持低饱和，贴近纸面气质）
圆角与边线密度：Clay Article 默认偏克制，不建议拉满装饰

页头与页脚

顶栏滚动后是否吸附、是否显示搜索入口
页脚版权文案、备案号、辅助链接
回到顶部按钮的显示阈值

文章与阅读

阅读进度条开关与位置
预估阅读时长算法（按字数）
文末作者卡、相关文章数量、分享按钮
代码高亮主题（若内置）

性能相关

是否预加载关键字体
是否延迟非关键脚本
特色图默认尺寸与懒加载策略

排版与中文阅读

Clay Article 针对中文长文做了默认校准。你可以在不破坏整体气质的前提下微调。

栏宽与正文字号

默认内容栏宽约 66ch，兼顾手机与桌面扫读
桌面端正文字号通常在 17–19px 区间；过大会破坏窄栏节奏
行高建议保持主题默认；若你大量插入图片，可适当增加段后距

字体

正文默认倾向衬线（或系统衬线回退栈），标题可使用更利落的无衬线
自定义字体时请控制 WebFont 数量；中文字体文件体积大，务必子集化或使用可靠 CDN
代码与键盘文案使用等宽字体，主题已区分

图片与图注

图片默认居中、带适度留白；宽图可使用「全宽」区块（若模板支持）
为每张内容图填写有意义的 alt；图注使用图说样式，而不是把说明塞进正文段落

导航、搜索与发现

主导航

保持导航项精简（通常 4–7 项）。Clay Article 的顶栏不是「功能堆场」，过多入口会削弱阅读站气质。

站内搜索

主题提供搜索入口时，结果页会突出标题与摘要
内容量大时，可另行接入更专业的搜索插件；注意样式冲突与脚本体积

评论与互动

默认兼容 WordPress 原生评论；外观跟随主题纸面风格
若使用第三方评论（如部分社交评论 SDK），请在主题选项中关闭可能重复的原生评论模块
开启评论时请同步配置反垃圾策略，避免垃圾评论破坏阅读页

性能优化建议

主题本身已尽量减少无用脚本。要让长文站真正「快」，还需配合主机与缓存策略。

常见性能误区

同时启用多个缓存 / 优化插件导致互相清理或重复 minify
在每篇文章强制加载沉重的页面构建器，抵消主题轻量优势
无节制加载外部字体与图标库

SEO 与可访问性

主题输出语义化标题层级与合理的文档大纲；请在正文中正确使用标题，不要用加粗段落冒充标题
配合成熟的 SEO 插件填写 Title / Description 即可；无需为「主题 SEO」重复安装多个同类插件
保持足够的对比度；若你自定义颜色，请在真实日光与夜间环境下各检查一次
为按钮与链接提供可理解文案，避免「点击这里」堆砌

子主题与二次开发

若需长期定制，请使用子主题，避免直接修改父主题文件导致升级被覆盖。

建议做法

通过子主题覆盖模板或追加 functions.php 钩子
优先使用主题提供的过滤器 / 动作钩子（详见主题内 inc 或开发者注释）
自定义 CSS 优先放在「附加 CSS」或子主题样式表，便于迁移

<?php
// 子主题中示例：调整摘要字数
add_filter('excerpt_length', function () {
    return 42;
});

注意：深度改造模板前，请先备份，并在预发环境验证主要页面（首页、单篇、归档、搜索、页面）。

更新与迁移

更新主题

确认授权有效，可收到版本更新
备份数据库与 wp-content
在维护窗口更新主题；更新后清理页面缓存与 CDN
浏览首页与一篇长文，确认进度条、目录与评论正常

站点迁移

迁移后更新 WordPress 地址与站点地址
重新保存固定链接
在新域名重新完成授权激活
检查媒体库旧域 URL 是否需要批量替换

故障排除

启用后白屏或致命错误

提高 WP_DEBUG 日志级别，查看具体 PHP 错误
确认 PHP 版本处于支持区间
暂时切换默认主题，确认是否为环境或插件冲突

样式错乱 / 无样式

硬刷新浏览器，清理缓存插件与 CDN
检查是否错误地 dequeue 了主题样式
确认子主题 style.css Template 头指向 clay-article

阅读进度条不显示

确认主题选项中已开启
确认当前为单篇文章模板（部分页面模板可能不显示）
检查是否有脚本报错中断了前端初始化

授权失败

核对 Key 是否复制完整、域名是否一致
服务器是否能访问授权接口（防火墙 / 出站限制）
本地环境请使用文档或订单页说明的开发激活方式

常见问题

可以用于商业项目吗？

可以，但须遵守你购买的授权档位条款（例如是否允许多站、是否可用于客户交付）。详情以订单与授权协议为准。

是否兼容 Gutenberg / 经典编辑器？

主题以区块编辑器为优先适配路径。经典编辑器通常可用，但部分区块样式（全宽图、组块间距）在 Gutenberg 下表现更完整。

是否内置页面构建器？

否。Clay Article 刻意保持轻量。若你强依赖构建器，请自行评估样式冲突，并尽量将构建器页面与长文阅读页分离。

如何关闭相关文章或分享？

在主题选项「文章与阅读」分组中关闭对应模块即可；无需改代码。

中文排版发虚或字体发灰？

多为系统字体回退或显示器 ClearType / 缩放问题。可尝试调整正文字重，或为关键区域指定更清晰的字体栈；避免给正文叠加半透明颜色。

版本与支持

当前文档对应主题线 v1.11.x。小版本更新通常向前兼容；跨大版本请阅读更新日志中的 Breaking Changes。

产品页与更新日志：请回到站点「主题详情 / 更新」栏目
授权与下载：登录后在个人中心查看
技术支持：通过站点提供的工单或联系渠道提交，并附上 WordPress / PHP 版本与问题复现步骤

附录：上线检查表

主题已启用且授权有效
固定链接已保存，关键页面无 404
Logo、菜单、页脚信息完整
抽查 3 篇长文：进度条、标题层级、图片、代码块、评论均正常
手机与桌面各浏览一遍首页与文章页
缓存与 CDN 规则确认；提交搜索引擎站点地图（如适用）
完成内容备份策略（主机快照或定期导出）

完成以上检查后，你的 Clay Article 站点即可稳定对外提供长文阅读体验。若后续需要针对「杂志首页」「多作者」「付费阅读」等场景扩展，可在本手册目录之外继续增补专题文档。

Topics

标签

入门

概述

适合谁