使用Golang基于語雀構建獨立域名的輕博客系統(tǒng)

時間：2023-02-07 13:12:01 | 來源：建站知識

時間：2023-02-07 13:12:01 來源：建站知識

先說結論： 語雀是目前編輯體驗最好(沒有之一)的文檔平臺，對開發(fā)者和非開發(fā)者都十分友好。強大的文本編輯功能，友好的使用體驗， 更強大的markdown語法超集，流程圖、思維導圖， 多媒體資源上傳插入（再也不用勞心勞力找圖床了）。開放的API（本文的前提，這個貌似是唯一一家開放了文章內容API接口的文檔平臺）。語雀，很geek。

一、為什么還需要DIY

• 語雀的缺點：
• 個人版不支持綁定域名，且官方明確了不會支持。
• 博客體驗差， 還不能個性化的配置。想在樣式上加個東西基本沒戲。
• 與語雀生態(tài)綁定在一起， 這點不爽。

• 需求：
• 編輯功能一定要好！編輯功能一定要好！編輯功能一定要好！
• 自由：支持自定義域名，可定制程度高，博客上放什么完全我說了算。
• 極簡主義： 專注，簡單，重點要突出文章本身而不是眼花繚亂的特效和廣告。
• 現(xiàn)有的博客系統(tǒng)都不怎么喜歡：
• github pages 很好，但是太慢而且還是需要自己解決編輯工具問題， hexo等純凈態(tài)流同理
• wordpress太臃腫。
• 自動維護https證書，文章變更、新增無需build和deploy自動生效。
• 基于以上需求， 語雀提供了其文章的API可以方便的獲取知識庫和文章數(shù)據(jù)，成功點燃了我蠢蠢欲動的小火苗。

二、 設計思路

• 好的博客功能 = 好的編輯功能 + 方便的文章發(fā)布，利用語雀完美的編輯功能，通過開放接口實現(xiàn)博客的實時展示。
• 回歸專注： 專注于文章創(chuàng)作而非專注于博客本身。部署完成后只需要在語雀上寫文章就行， 寫好文章語雀發(fā)布也相當于在博客發(fā)布， 完全免運維。
• 不能把所有文章都做展示，語雀區(qū)分知識庫和文章兩級角色。通過配置指定知識庫來設置博客展示的文章范圍， 博客僅會去取指定知識庫下的文章內容并展示。
• 無數(shù)據(jù)庫，所有數(shù)據(jù)都從語雀獲取， 僅僅依賴一個config.yaml進行基礎設置。
• 考慮到屬于丟在那里會被遺忘（寫文章和編輯都只需要在語雀即可，服務端一次配置部署后就可以忘掉了）所以需要具備自動維護Https證書的能力。
• 博客的文章分類：利用語雀知識庫， 每一個分類的文章寫在一個單獨的知識庫里面。
• 文檔搜索： 利用語雀的搜索API實現(xiàn)。
• 利用acme 的golang庫實現(xiàn)自動https證書維護。
• 博客的基本功能： title，副標題，keywords、description燈通過定義配置文件實現(xiàn)， 配置文件demo：

三、踩坑指南

• 靜態(tài)資源的坑： 在寫文章時直接黏貼圖片，用高級功能畫圖到語雀是很好的體驗，在語雀上看文檔正常渲染也沒問題。問題是，當實現(xiàn)了web服務器，成功代理拿到了文章的html代碼并且返回，以為萬事大吉的時候，打開頁面發(fā)現(xiàn)所有的那些思維導圖流程圖還有帖進去的圖片全是紅叉叉，被語雀的防盜鏈干掉了。
• 代碼高亮沒有了：見語雀官方的說明：https://www.yuque.com/yuque/developer/yr938f API導出來的格式基本就是markdown轉換成html格式，代碼高亮沒了， 段落樣式也沒了，奇丑無比。

四、填坑

• 針對靜態(tài)資源的坑，通過替換html中的CDN連接，劫持到自己的博客后端來進行反向代理，成功解決, 核心代碼：

• 代碼高亮和樣式問題: 下方是語雀官方提供了樣式，但是這里的樣式只負責段落格式，代碼高亮未能解決：

• 安排了highlight.js來解決代碼高亮的問題。

五、大功告成

• 手擼html的極簡風,就喜歡這么簡單（其實是為了偷懶）， 圖中的四個分類，分別對應語雀的4個知識庫。

• 文檔列表： 列出的是語雀知識庫下的文章列表：

• 文章查看頁面

六、開源計劃

• 已開源至：

• 歡迎貢獻模板