本主题由彼岸临窗设计编写，已取得软件著作权证书及外观设计专利。致敬开源，本主题自2025年1月1日起，以GPL-2.0协议授权广大用户免费使用。任何个人或单位在注明来源的基础上，均可以免费无偿使用本主题，但不得以任何形式售卖（包括但不限于以付费下载、积分购买、vip用户可见等形式向用户提供下载链接，下同），否则视为侵权。基于GPL-2.0协议，本主题允许在保留来源（同时包含署名和链接）的基础上对源代码进行修改，但修改后的源码只能自己使用或免费开源，不得以任何形式售卖，主题作者保留所有权利。
推荐使用Linux系统、PHP8.2，Mysql5.7，Ngnix1.24，该环境为开发测试阶段以及主题官网的稳定运行环境，其他环境未作兼容性测试，可能存在部分功能无法正常使用的问题。如果你使用的是其他环境，且在阅读本文档后仍解决不了问题，请在Github官方仓库提issue。
本主题基于Typecho1.2.1开发，请在下载本主题之前安装好Typecho官方稳定版。如果你使用的是Typecho旧版本，请自行解决兼容性问题。为了安全性和稳定性考虑，后续主题的更新只可能适配Typecho最新版本。
如果你还未安装Typecho，请前往Typecho官网下载安装。
如果你想要新购国内服务器，可点击此处腾讯云最新活动选取合适的机器。
如果你想新购免备案境外服务器，可点击此处大圣云计算选取合适的机器。
主题包最新版本在Github，开源不易，请记得点★Star，国内镜像源在Gitcode。
如果你打算将本主题用于生产环境，请下载Releases中的最新稳定版本；如果想要体验最新开发版，可以前往仓库打包下载ZIP压缩包，即Code - Download ZIP。下载后解压主题文件夹，即OneBlog文件夹，请确保主题包的名称为OneBlog，否则可能无法正常使用。
请确保你使用的是官方正版，除了上述Github官方仓库和Gitcode镜像仓库，其他任何渠道都无法保证主题的完整性和安全性。如果你是从其他渠道下载安装的，为避免漏洞和后门，建议第一时间更换成官方正版。如果你是从其他渠道购买的，那么毫无疑问，你使用的是盗版，欢迎向主题作者举报。
如果你使用的是官方正版，且未对主题源码进行过任何修改，后续更新建议使用Releases中的最新稳定版本进行覆盖更新。对于小问题的修复将会在版本更新时统一更新，如果你想第一时间修复版本bug，请直接查看仓库源码的提交记录。
如果你正确安装了本主题，可以在Typecho后台 [控制台] - [外观]中看到OneBlog和对应版本号。启用主题后，请第一时间到主题外观设置中配置好相关信息并点击保存按钮以便初始化主题配置，否则可能会出现不可预知的问题，尽管我在开发过程中已经配置了各种默认数据。
本主题不依赖任何插件，但为了获得最佳的使用体验，强烈建议安装以下插件，下载插件后，请务必把插件文件夹的名字修改为我这里列出的名字，否则可能无法正常启用。
这是一款由泽泽开发的自定义菜单插件，本主题已完美适配。如果你的网站需要菜单，请安装并启用该插件。安装成功后，鼠标移动到后台[控制台] - [管理菜单]，右侧已自动显示支持拖拽的链接页面，把你需要作为菜单的页面拖拽到左侧菜单区域即可。如果你需要添加其他页面或者需要在右键菜单中显示图标，请手动配置菜单，在[图标参数]中填写完整的图标类名，如“iconfont icon-home”。类名既可以填写自己的图标库类名，也可以直接在主题设置中查阅本主题自带的图标库。
注意：PHP版本小于8.0的，本插件可能无法正常使用。不使用插件的情况下，需要手动修改源码才能正常显示菜单。如果你完全是新手，建议将PHP版本切换成8.2后，安装本插件。
这是一款由懵仙兔兔开发的友情链接插件。为了更方便地维护友情链接，本主题的友链页面依赖于该插件，如果需要友情链接，请安装并启用该插件。启用插件后，需要在后台新建独立页面，选择“友链”模板。后期友链的维护直接在后台[管理] - [友情链接]管理友情链接即可。
这是一款由Rakiy开发的首页过滤指定分类文章的插件，如果你用到了相册分类、书单分类，建议安装本插件，以便在首页隐藏这些特殊分类的文章。由于本插件的原作者已经停止维护，建议下载安装由woodchen在原插件基础上更新维护的版本。
Github插件地址：CateFiler 备用下载地址：蓝奏云
该插件为本主题定制插件，现开放给使用本主题的所有用户（请勿外传），可以实现自定义文章字段的显示与隐藏。由于本主题自定义字段较多，但并非所有文章都需要填写这些字段，本插件能够实现在编辑某些分类的文章时，只显示与这些分类有关的字段，让文章编辑页更加简洁、美观、实用。如果不会配置，请按照以下参数配置：
默认分类/文章类：'thumb','origin','author'
相册分类：'thumb','photo','author'
书单分类：'thumb','author','bookCat','bookYear','bookGrade'
独立页面：'thumb'
插件下载地址：蓝奏云
本主题自带微语/说说功能，只需要在后台新建一个独立页面，选择[微语]模板即可。本主题的微语是基于typecho原生评论开发的，因此在独立页面配置好微语页面后，还需要在Typecho后台[设置] - [评论] - 评论显示中配置相关参数。本主题的评论列表均实现了无限加载，因此，在评论设置中必须启用分页功能。
推荐设置：☑启用分页，并且每页显示5篇评论，在列出时将第一页作为默认显示；将较新的评论显示在前面。
如果你想修改微语页面顶部的默认背景，只需要在分类描述中直接填写图片url地址后保存即可。
本主题自带书单功能，方便博主们添加书籍和记录读书笔记。书单功能是通过文章分类实现的，并非独立页面，因此，如果你想要启用书单功能，只需要新增分类“书单”即可，分类缩略名必须修改为“books”。
新增书籍时，直接在后台发布新文章即可，标题处填写书籍名称，自定义字段填写书籍相关信息，正文部分填写书籍简介，分类选择书单分类即可。需要记录相关书籍的阅读笔记或者书摘时，登录后进入该书籍的详情页，即可看到输入框。
如果你想修改书单页面顶部的默认背景，只需要在分类描述中直接填写图片url地址后保存即可。
本主题自带相册功能，方便博主们持续维护自己的照片。相册页面是通过文章分类来实现的，并非独立页面，因此，如果你想要启用相册功能，只需要新增分类”相册“即可，分类缩略名必须修改为“photos”。
Unsplash照片同步功能：可自由选择是否开启，开启与否均不影响相册功能的使用。启用本功能需要在后台设置中同时配置好Unsplash API 、 你的Unsplash用户名 、相册分类的mid。配置完毕后，相册页面会自动显示同步按钮。在Unsplash上传照片后建议第一时间同步，同步时不会覆盖已有数据，请放心同步。
目前主题相关的所有已知问题均已解决，暂未收到任何反馈。如果你在使用本主题的过程中，遇到了难以解决的问题，请先认真阅读本文档及Github仓库中已关闭的issue。如果仍然无法解决，请先提issue，详细描述问题。同时，你可以考虑加入官方微信交流群，或许能够快速得到满意的答复。官方微信群二维码详见Github仓库的readme文档，作者会定期更新群二维码，如果群二维码已失效，请通过邮件info@oneblogx.com向作者反馈。
以下问题与本主题无关，但为了方便广大用户正常使用，在这里列出解决方案：
原因分析： 这是由于Nginx配置中存在默认的error_page设置，其优先级是最高的，覆盖掉了主题的404逻辑。
解决办法：登录你的服务器面板，打开对应的Nginx配置文件，找到 error_page 404 /404.html 这一行，将它用#注释掉，也就是修改为 # error_page 404 /404.html，然后保存并重载Nginx服务。
原因分析：本插件使用了更为前沿的语法，需要更高版本的PHP和Mysql语法支持。
解决办法：如果你想要继续使用本插件，建议切换为php8.2版本和mysql5.7版本；如果主机环境不支持，则需要手动修改菜单部分的代码。
看在主题文档都这么用心的份上，给项目点个★Star吧！
本文档最后更新于2025年1月21日，由彼岸临窗编写。