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服務。

