(31) 試著學 Hexo - 番外篇之常見問題
前言
這一篇是完賽後的總結篇,雖然說是總結篇,但其實還是要講一些 Hexo 常見的問題。
小心關鍵字
基本上會建議你在撰寫筆記文章時,盡可能標題不要打到 Hexo 的一些關鍵字,舉例來講,這個問題是先前社群的朋友發生的狀況,他是在標題打 jQuery
這個關鍵字導致出現錯誤,原文。
1 | ## jQuery |
雖然我自己是沒出現該錯誤,目前想刻意製造關鍵字錯誤也不知道有哪些,但基本上比較常見的錯誤是雙括號(可能是撰寫 Vue 的筆記)
1 | {{}} |
如果你沒有使用程式碼區塊(上下三個頓號)而是使用程式碼片段,那麼就會出現錯誤。
但是基本上當你先前執行 hexo s
以及 hexo deploy
時沒有出現任何錯誤,只有在你新增一篇文章之後才出現一些問題,那麼不妨試試關鍵字這邊去下手。
更新文章後 404
這種狀況其實比較常見於你更改了 categories 的大小寫並且你又剛好使用 Git 做版本控制與部屬,而這個原因是 Hexo 在建立一個靜態頁面時,其實會依照 categories 來生成資料夾,而這邊剛剛好其實 Git 對於大小寫並不敏感,因此一開始你可能分類是 SCSS 後來改叫 scss,這時候你再去看編譯出來的資料夾會發現,不管怎樣都是 SCSS。
而這邊最簡單方式就是砍掉該儲存庫重新再上傳,而另一種方式則是去針對 Git 大小寫敏感去調整,這部分就不再說明,可以透過 Google 找到相關解決方式。
想刪除文章
刪除文章的方式其實非常簡單,刪除 .md 檔案並重新部署就好,除此之外也可以將文章改放到 _drafts
資料夾也可以唷。
模擬伺服器之後文章消失
這個問題算是我一直有發生的狀況,基本上如果你是在 hexo s
的狀況下去編輯文章並一邊看的話,是有一定機率會發生你當前撰寫的文章突然一片空白,至於這個問題我不太清楚原因,但基本上當發生這狀況時可以按下復原按鈕 CTRL+Z 來還原。
當然最好的方式還是避免一邊撰寫一邊使用模擬伺服器。
升級 Hexo 與主題
這個流程算是最繁瑣的一個,基本上就是必須重新建立一個 Hexo 專案,然後將相關的文章移動到新專案(不要懷疑就是這麼麻煩)就這樣。
但是流程太過繁瑣,所以就不再介紹了,之後有機會我再額外寫文章在我的部落格介紹~
部署後沒 CSS 樣式
關於這個問題的話,通常可能是你多了一層結構,例如…
1 | https://hsiangfeng.github.io/blog/ |
也有一種可能是你的使用者名稱錯誤,你的名稱是 hsiangfeng
,但你打成 hsianghexo.github.io
等各種狀況。
這一篇稍微比較短一點,主要是當作完賽的一些常見問題的補充,所以就沒規劃太多內容了哩。
下次再來找機會介紹如何更新 Hexo 與更新 NexT 囉~