OneBlog，一个博客，再无其他。本主题的设计初衷是文字本身，并无太多其他功能，适合生活记录、文学作品等文字类博客，非文字博客，请慎重选择。主题相关设计及功能，可以参照彼岸临窗（oneblog.net）官网体验，所见即所得。也可参见主题官网和Github上面的主题介绍。
- 主题介绍：Typecho文字博客主题
- 使用介绍：OneBlog主题文档
- 主题下载：GitHub – cncodehub/OneBlog:
- 主题演示：呢喃 – 喜于情，爱于心，言于表。
主题特性
✅ 极致的性能，页面加载平均仅需0.02s；
✅ 流畅的体验，无限加载+自动加载数据+图片懒加载；
✅ 极致的简约风，扁平化设计，简约而不简单；
✅ 符合美学的松弛美感，精益求精的留白，让每一次访问都是一种享受；
✅ 精雕细琢，精致而优雅的响应式移动端界面；
✅ 注释齐全，代码精简，基于OneBlog，你可以最大限度地实现自定义效果。
主题功能
- 文章，聚焦文字本身，沉浸式阅读体验；
- 微语，前台登录和发布，抓住转瞬即逝的灵感；
- 友链，每一位邻居都值得被珍惜和被看见；
- 评论，电脑端点击无限加载，移动端下拉自动加载；
- 归档，干净利落的博客归档页面；
- 搜索，友好的交互体验。
版权声明
本主题的所有外观设计专利及软件著作权均归 ©彼岸临窗 所有，并已取得中华人民共和国国家版权局颁发的计算机软件著作权登记证书（登记号：2025SR0334142）和外观设计专利证书（证书号：第7121519号），作者保留所有权利。致敬开源，本主题自2025年1月1日起，以GPL-2.0协议授权广大用户免费使用。任何个人或单位在注明来源的基础上，均可以免费无偿使用本主题，但不得以任何形式售卖（包括但不限于以付费下载、积分购买、vip用户可见等形式向用户提供下载链接，下同），否则视为侵权。基于GPL-2.0协议，本主题允许在保留来源（同时包含署名和链接）的基础上对源代码进行修改，但修改后的源码只能自己使用或免费开源，不得以任何形式售卖。
环境配置
1.服务器环境
推荐使用Linux系统、PHP8.2，Mysql5.7，Ngnix1.24，该环境为开发测试阶段以及主题官网的稳定运行环境，其他环境未作兼容性测试，但不影响正常使用。如有问题，请在Github官方仓库提issue。
2.Typecho版本
本主题基于Typecho1.2.1开发，请在下载本主题之前安装好Typecho官方稳定版。如果你使用的是Typecho旧版本，请自行解决兼容性问题。为了安全性和稳定性考虑，后续主题的更新只可能适配Typecho最新版本。
如果你还未安装Typecho，请前往Typecho官网下载安装。
3.服务器推荐
如果你想要新购国内服务器，推荐前往腾讯云最新活动选取合适的机器。
如果你想新购免备案境外服务器，推荐前往大圣云计算选取合适的机器。
五、主题安装
1.下载主题包
官方项目源：Github
国内镜像源：Gitcode
开源不易，请记得点★Star。
如果你打算将本主题用于生产环境，请下载Releases中的最新稳定版本；如果想要体验最新开发版，可以前往仓库打包下载ZIP压缩包，即Code – Download ZIP。下载后解压主题文件夹，默认解压后的文件夹的名称为OneBlog-lite，需要修改主题包的名称为OneBlog，否则会影响主题的正常使用。
请确保你使用的是官方正版，除了上述Github官方仓库和Gitcode镜像仓库，其他任何渠道都无法保证主题的完整性和安全性。如果你是从其他渠道下载安装的，为避免漏洞和后门，建议第一时间更换成官方正版。如果你是从其他渠道购买的，那么毫无疑问，你使用的是盗版，欢迎向主题作者举报。
2.版本更新
如果你使用的是官方正版，且未对主题源码进行过任何修改，后续更新建议使用Releases中的最新稳定版本进行覆盖更新。对于小问题的修复将会在版本更新时统一更新，如果你想第一时间修复版本bug，请直接查看仓库源码的提交记录。
3.初始化
如果你正确安装了本主题，可以在Typecho后台 [控制台] – [外观]中看到OneBlog和对应版本号。启用主题后，请第一时间到主题外观设置中配置好相关信息并点击保存按钮以便初始化主题配置，否则可能会出现不可预知的问题，尽管本主题在开发过程中已经配置了各种默认数据。
六、插件推荐
本主题不依赖任何插件，您如果想实现某些个性化需求，可以考虑安装以下插件：
1.Links
这是一款由懵仙兔兔开发的友情链接插件。为了更方便地维护友情链接，本主题的友链页面基于该插件开发，如果需要友情链接，请安装并启用该插件。启用插件后，需要在后台新建独立页面，选择“友链”模板。后期友链的维护直接在后台[管理] – [友情链接]管理友情链接即可。
Github插件地址：Links
备用下载地址：蓝奏云
2.CommentNotifier
本插件能够实现在有新评论或者评论被回复时以邮件的形式通知作者或评论者。本主题已完美适配该插件，可实现邮件通知中也能显示表情。在配置该插件时，在[表情重载]下方的输入框填写 parseEmojis 即可。如果你想获得与官网邮件通知模板一样的效果，请下载下方邮件皮肤后上传到该插件文件夹CommentNotifier/template/目录下，解压并确保文件名为 OneMail ，然后在typecho后台 – 控制台 – 评论邮件提醒外观 选择并启用OneMail。
Github插件地址：CommentNotifier
备用下载地址：蓝奏云
邮件皮肤下载地址：OneMail
七、使用教程
1.微语
本主题自带微语/说说功能，只需要在后台新建一个独立页面，选择[微语]模板即可。本主题的微语是基于typecho原生评论开发的，因此在独立页面配置好微语页面后，还需要在Typecho后台[设置] – [评论] – 评论显示中配置相关参数。本主题的评论列表均实现了无限加载，因此，在评论设置中必须启用分页功能。
推荐设置：☑启用分页，并且每页显示5篇评论，在列出时将第一页作为默认显示；将较新的评论显示在前面。
如果你想修改微语页面顶部的默认背景，只需要在后台独立页面-微语页面-自定义字段设置封面图片即可。
2.文章详情页
本主题的文章详情页有两种样式，您只需要考虑是否设置自定义字段中的封面图片即可，设置后就是有封面图的样式，不设置则为干净的A4纸样式。
3.分类页面个性化
移动端的分类页面有分类背景图和分类描述等字段显示，如果你想自定义，直接在后台分类描述中进行填写。直接填写分类图片的url地址和中文分类描述即可，主题代码会自动抓取分类图片和分类文字描述。
3.相册
考虑到文章数据结构的合理性和轻量化，自V3.6.1版本起，本主题已移除原有的相册、书单等功能模块，如果您需要继续使用这些功能，建议使用V3.5.3版本（仓库中保留了old分支，切换到old分支下，打包下载即可）。
针对周边功能模块，后续考虑通过插件的形式实现。目前，已开发出完美适配本主题的相册插件。如果您在2025年7月27日之前，曾经赞助过本项目，无论金额多少，本插件均可以免费授权给您个人使用。如需购买相册插件（当前版本定价50元），请加QQ群后私信群主。
4.附件页面/作者页面
本主题主要偏向于内容本身，很多冗余功能都被移除了。使用本主题后，Typecho默认的附件页面/作者页面会跳转到404页面，如果你想让它们正常显示，请删除主题文件中functions.php的以下代码：
//附件页面和作者页面重定向到404页面
function redirect_404(){
$request = Typecho_Request::getInstance();
$pathInfo = $request->getPathInfo();
// 使用正则表达式匹配路径
if (preg_match('/^/(attachment/d+|author/w+)/i', $pathInfo)) {
// 调用 404 页面
$options = Typecho_Widget::widget('Widget_Options');
$url = $options->siteUrl . '404';
header("Location: $url");
exit;
}
}
// 在页面加载之前调用
Typecho_Plugin::factory('Widget_Archive')->beforeRender = 'redirect_404';八、常见问题
目前主题相关的所有已知问题均已解决，暂未收到任何反馈。如果你在使用本主题的过程中，遇到了难以解决的问题，请先认真阅读本文档及Github仓库中已关闭的issue。如果仍然无法解决，请先提issue，详细描述问题。同时，你可以考虑加入官方QQ交流群:939170079，礼貌求助或许能够快速得到满意的答复。
以下问题与本主题无关，但为了方便广大用户正常使用，在这里列出解决方案：
1.网站的错误页面并非跳转到主题内置的404.php页面，而是跳转到Nginx默认的404 Not Found页面？
原因分析： 这是由于Nginx配置中存在默认的error_page设置，其优先级是最高的，覆盖掉了主题的404逻辑。
解决办法：登录你的服务器面板，打开对应的Nginx配置文件，找到:
error_page 404 /404.html这一行，将它用#注释掉，也就是修改为:
# error_page 404 /404.html然后保存并重载Nginx服务。
