0%

讓 mtmatt 上線 GitHub feat. Hexo

前言

種種原因讓 mtmatt 進駐 GitHub。

選用 Hexo 的原因,一方面,Hexo 支援所有 GitHub Flavored Markdown 的功能;另一方面,則是曾有過一段使用經驗,印象是好的。

只是,日前曾經寫下的紀錄貼文,已經不知散落何方,今次只能當做是砍掉重練。再者,後續在 mtmatt 上面,有幾篇貼文使用上 LaTeX,這是之前沒有做過的設定,這一次也必須一起練上來。


歷程紀錄與感想

我們將本次練功分成 3 階段。第 1 階段,先讓 Demo 版的 mtmatt 可以在 GitHub 上 On 起來;第 2 階段,處理 LaTeX;第 3 階段,盡可能地優化之前的貼文。

第 1 階段,先讓 Demo 版的 mtmatt 可以在 GitHub 上 On 起來

  1. 這一個階段算是最簡單的部分,原則上,我們是參考 文件 | Hexo 裡面的說明按表操課,我們選擇在 Windows 系統上處理,分別下載 Node.js 與 Git 的版本時,Node.js 選擇下載 Recommended For Most Users 的版本(即 18.17.0 LTS);Git 則是下載 Latest source Release 的版本(即 2.41.0)。
  2. 參考 Convert WordPress articles to Markdown - DAEXT 這篇貼文,將 WordPress 文章匯出後,再於本機將文章轉為單篇的 MarkDown。
  3. 設定好,讓文章在 mtmatt.github.io 這個域名上先做一些 Demo 與測試,這個階段就算造一段落。

第 2 階段,處理 LaTeX

  1. 處理 LaTeX 是我們過去沒有的經驗,我們走了一段路,最終是使用以下的方式成功。
  2. 使用 Google 挖出不少參考文章,主要是參考 MathJax - Use Math in Hexo, Just Like Tex! (Including Common Issue Solutions) | Longing for sth New 這一篇貼文而成功。
  3. 服用上,除了安裝 hexo-math 外,幾次設定都無法順利達成。最後是把需要顯示 LaTeX 的貼文,加上下列 Code 才順利顯示 LaTeX。
    1
    <script src='https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.4/MathJax.js?config=TeX-MML-AM\_CHTML' async></script>

第 3 階段,盡可能地優化之前的貼文

  1. 這個階段,主要是我們在轉換時才發現,可能因為我們在 WordPress 安裝一些外掛,再加上文章的格式被轉來轉去,有些貼文失去本來應該要呈現的模樣。
  2. 我們決定處理的優先順序上,先把嚴重走鐘的文章(尤其是該有的 Code 變成一整坨屎的那種),行有餘力再去把之前的貼文排版做優化。

後記

  1. 本來為了 Demo 與測試用的網址:mtmatt.github.io,在完成一定程度的轉換後,要把域名設定為 mtmatt,除了在 GitHub 上完成設定外,還要在本機 Hexo 下的 source 路徑底下,摸(新增)一個 CNAME 檔(檔名就是 CNAME,不需要再加副檔名),檔案的內容就寫一行 mtmatt,大致上就可以先收工。
  2. 事實上,我們打算慢慢地讓一個部落格網站該有的功能,例如:文章搜尋、標籤雲等都完整化。如果要把這件事也放到流程裡的話,在這一次的轉換過程,肯定是 Final Step,並且同樣是在行有餘力的時候再說。