Frank's Doc

在寫了一段時間的 blog 之後想要簡化這一流程:

• 目前: 寫完 blog –> hexo g -d –> git commit… –> git push… (私有的 repo)
• 目標: 寫完 blog –> git commit… –> git push… (私有的 repo) –> CI/CD 自動佈署

要達成這一目的就不得不提到 Github Action ，一個 github 內建的 自動化工具。

vim 是一個古老的”文字編輯器”，其特點就是只使用鍵盤就可以寫 code ，這種手不離鍵盤的開發方式可以大幅加快開發速度。

但直接使用 vim 開發會相當於放棄 vscode 的各種方便功能，因此本篇文章採用 vscodevim 這一 extension 讓 vscode 可以支援 vim 的各種指法，目標是在開發時盡可能不要用到滑鼠，以下是我的設定。

在 windows -- Docker -- vscode 中有提到使用 docker & vscode 的開發流程，因此本篇文章會將 hexo blog 也轉換成 container 的形式，方便本機的環境管理和專案的可攜帶性。

結果

1. 專案從 github 拉下來: git clone ....
2. vscode 彈出可以開啟 container，點選 reopen in container
3. nodejs 和 hexo 的開發環境被建立起來了，可以開始寫 blog 了。

3 步驟建立好開發環境，不用裝 nodejs、不用裝 hexo-cli、不用下 npm install，只要將專案 pull 下來並透過 vscode 開啟就可以直接開發。

目前使用 wsl2 的 docker 加上 vscode 的開發流程有一段時間了，因此寫下這篇紀錄環境的安裝，目前使用過的語言和框架:

• python、tensorflow-gpu
• c/c++、java

為什麼想使用 docker 來開發?

Docker 是一種容器(container)化的技術，將該技術用作 開發 有許多的好處:

1. 用各種語言開發時不用將所有的環境都安裝在 pc 上，減少環境設定的衝突 (ex: py3.6, py3.8, nodejs, ….)。
2. 多台電腦 (or 換新電腦) 開發時不用每一台都設定一次環境，從 repo 拉下來就可直接參與開發。
3. 方便管理環境，並環境一但變動所有人都可拿到最新的可運行的環境(延伸第 2 點)。

p.s. 再加上使用 vscode 產生 container 只需點按幾下就可產生各種環境和所需的各種 extension，方遍、快速、好管理。

本文章使用的 Hexo Theme NexT 版本為 v7.8.0。

如何查看 NexT 版本

可以在 themes/next 內的 package.json 查看

使用以下指令，hexo 就會自動生成 md 檔，接下來直接寫 Markdown 語法就可以完成部落格，就是這麼簡單。

1

hexo new <your md file name>

Hexo 是一個寫 blog 的網頁框架，選取需要的主題、設定_config.yml 和使用 npm 安裝套件，在撰寫文章時只要專注於 Markdown 的語法即可。

GitHub Pages

GitHub Pages 本身是使用 GitHub 作為網頁的儲存空間，有以下的限制:

• 網站大小不能超過 1 GB
• 網站每月流量不能超過 100 GB
• 一小時內的網站更新不得超過 10 次
• 只能架設「靜態網站」