前言
種種原因,我說服 mtmatt 讓 mtmatt.page 進駐 GitHub。
提出選用 Hexo 的建議,一方面,Hexo 支援所有 GitHub Flavored Markdown 的功能;另一方面,我自己使用過一段時間,大致上的經驗是好的。
只是,日前曾經寫下的紀錄貼文,已經不知散落何方,今次只能當做是砍掉重練。
再者,後續在 mtmatt.page 上面,有幾篇貼文使用上 LaTeX,這是之前沒有做過的設定,這一次也必須一起練上來。
歷程紀錄與感想
我們將本次練功分成 3 階段。第 1 階段,先讓 Demo 版的 mtmatt 可以在 GitHub 上 On 起來;第 2 階段,處理 LaTeX;第 3 階段,盡可能地優化之前的貼文。
第 1 階段,先讓 Demo 版的 mtmatt.page 可以在 GitHub 上 On 起來
這一個階段算是最簡單的部分,原則上,我們是參考 文件 | Hexo 裡面的說明按表操課,我們選擇在 Windows 系統上處理,分別下載 Node.js 與 Git 的版本時,Node.js 選擇下載 Recommended For Most Users 的版本(即 18.17.0 LTS);Git 則是下載 Latest source Release 的版本(即 2.41.0)。
參考 Convert WordPress articles to Markdown - DAEXT 這篇貼文,將 WordPress 文章匯出後,再於本機將文章轉為單篇的 MarkDown。
設定好,讓文章在 mtmattpage.github.io 這個域名上先做一些 Demo 與測試,這個階段就算造一段落。
第 2 階段,處理 LaTeX
處理 LaTeX 是我們過去沒有的經驗,我們走了一段路,最終是使用以下的方式成功。
使用 Google 挖出不少參考文章,主要是參考 MathJax - Use Math in Hexo, Just Like Tex! (Including Common Issue Solutions) | Longing for sth New 這一篇貼文而成功。
服用上,除了安裝 hexo-math 外,幾次設定都無法順利達成。最後是把需要顯示 LaTeX 的貼文,加上下列 Code 才順利顯示 LaTeX。
<script src='https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.4/MathJax.js?config=TeX-MML-AM\_CHTML' async></script>
第 3 階段,盡可能地優化之前的貼文
這個階段,主要是我們在轉換時才發現,可能因為我們在 WordPress 安裝一些外掛,再加上文章的格式被轉來轉去,有些貼文失去本來應該要呈現的模樣。
我們決定處理的優先順序上,先把嚴重走鐘的文章(尤其是該有的 Code 變成一整坨屎的那種),行有餘力再去把之前的貼文排版做優化。
後記
本來為了 Demo 與測試用的網址:mtmattpage.github.io,在完成一定程度的轉換後,要把域名設定為 mtmatt.page,除了在 GitHub 上完成設定外,還要在本機 Hexo 下的 source 路徑底下,摸(新增)一個 CNAME 檔(檔名就是 CNAME,不需要再加副檔名),檔案的內容就寫一行 mtmatt.page,大致上就可以先收工。
事實上,我們打算慢慢地讓一個部落格網站該有的功能,例如:文章搜尋、標籤雲等都完整化。如果要把這件事也放到流程裡的話,在這一次的轉換過程,肯定是 Final Step,並且同樣是在行有餘力的時候再說。