花了一些時(shí)間用hugo重新搭建了貓狗窩，托管在github page上，又利用github action實(shí)現(xiàn)了CI/CD。非常省心！做到了專(zhuān)注寫(xiě)文，直接發(fā)布的效果。本篇記錄就是寫(xiě)一點(diǎn)發(fā)布一點(diǎn)，陸續(xù)成文。
下面就把這一次趟坑的過(guò)程總結(jié)一下，本系列包括三部分：
本篇為第一部分——搭建本地服務(wù)
為什么重建
19年的時(shí)候，用leanote做私有筆記服務(wù)，這樣可以直接把筆記發(fā)成web頁(yè)面，省去很多維護(hù)公共平臺(tái)賬號(hào)之類(lèi)的雜事。但個(gè)人站點(diǎn)隨之而來(lái)的維護(hù)工作，又讓我陷入繁瑣，違背了使用leanote是為了專(zhuān)注在寫(xiě)作上的初心。最終個(gè)人站還是荒廢了。
今年決定重啟blog，作為記錄和寫(xiě)作的練習(xí)地。
為了避免又一次陷入泥潭，這次的筆記方案要滿(mǎn)足以下幾個(gè)需求：
- 支持md，并且要保證將來(lái)可以方便的遷移
- 可實(shí)現(xiàn)服務(wù)托管
- 源文件和站點(diǎn)文件都能夠完全掌控
- 框架要有良好的社區(qū)支持
框架選擇
基于希望專(zhuān)注寫(xiě)作的考慮，首先排除了wordpress，因?yàn)樗亓耍峁┑墓芾矸?wù)太靈活了，非常容易讓人分心。我需要的博客引擎，一定要提供最簡(jiǎn)單的寫(xiě)作體驗(yàn)。
一番尋找之后，鎖定了三個(gè)引擎：jekyll、hexo、hugo，這是目前碼農(nóng)最喜歡用的三個(gè)博客生成器。下面就對(duì)它們做個(gè)簡(jiǎn)單的對(duì)比。
| 對(duì)比維度 | Jekyll | Hexo | Hugo |
|---|---|---|---|
| 社區(qū)支持(2022年09月25日,github上star數(shù)目) | 45.3k | 35.4k | 62.5k |
| 開(kāi)發(fā)語(yǔ)言 | ruby | nodejs | go |
| 編譯速度(這里 提供了585篇文章的生成時(shí)長(zhǎng)) | 15.90s | 兩者之間 | 4.90s |
| 其他方面 | Jekyll 有g(shù)ithub支持，可以將markdown文件直接放到git倉(cāng)庫(kù)，github會(huì)自動(dòng)生成網(wǎng)頁(yè)文件。（Github一直是一個(gè)親ruby的社區(qū)） | Hexo提供了方便的部署命令，可以做到一條命令部署到github上。 | Hugo的官方文檔寫(xiě)的非常好，部署簡(jiǎn)潔。前兩者部署時(shí)需要安裝很多依賴(lài)，而hugo可以直接提供二進(jìn)制文件運(yùn)行，甚至不需要root權(quán)限。 |
關(guān)于編譯速度的差別，原因在于Hugo使用go語(yǔ)言開(kāi)發(fā)，go是一種編譯型語(yǔ)言，執(zhí)行速度非常快。而Jekyll使用ruby，Hexo使用nodejs，這兩種語(yǔ)言都是解釋型語(yǔ)言，執(zhí)行效率比go低很多。而nodejs又比ruby快一些。從上面的數(shù)據(jù)可以看到，Hugo比Jekyll快了近10倍，完全不是一個(gè)量級(jí)的比較。
最終，我選擇了Hugo。雖然上手可能需要一點(diǎn)時(shí)間，但幾乎所有維度的比較，都讓Hugo成為我的第一選擇。
本地搭建
下面就開(kāi)始Hugo的探索之旅。
安裝hugo
非常簡(jiǎn)單的安裝。我使用的是 macOS，官方推薦用 homebrew 方式。
brew install hugo
完成后，可使用以下命令進(jìn)行驗(yàn)證：
hugo version
創(chuàng)建站點(diǎn)
要?jiǎng)?chuàng)建一個(gè)新的web站點(diǎn)，可通過(guò)執(zhí)行hugo new site 給博客起個(gè)名字命令來(lái)實(shí)現(xiàn)。
執(zhí)行后會(huì)創(chuàng)建一個(gè)文件夾，與命令中的名字同名，包括以下內(nèi)容:
.
├── archetypes
│ └── default.md
├── config.toml
├── content
├── data
├── layouts
├── static
└── themes
其中
config.toml: hugo配置文件
content: md文件和html
static: 靜態(tài)資源
themes: 主題
其他的可先不管。
選擇主題
Hugo沒(méi)有默認(rèn)主題，所以需要自己安裝主題。我使用的是hugo-theme-cleanwhite 。官網(wǎng)主題庫(kù)：Hugo Themes
$ mkdir themes
$ git submodule add https://github.com/zhaohuabing/hugo-theme-cleanwhite.git themes/hugo-theme-cleanwhite
啟動(dòng) Hugo 服務(wù)器，在 http://localhost:1313/ 將會(huì)看到由主題生成的示例網(wǎng)站
$ hugo serve -t hugo-theme-cleanwhite
或只需要
hugo server
即可。
配置hugo
配置文件在網(wǎng)站根目錄下 config.toml , 根據(jù)自身需求進(jìn)行修改。在 hugo-theme-cleanwhite 主題下的 exampleSite 文件夾中的文件可作為參考。默認(rèn)的文章將存儲(chǔ)在 ./content/post 中，每當(dāng)寫(xiě)完文章，運(yùn)行 hugo 命令，Hugo 將自動(dòng)生成靜態(tài)網(wǎng)站到 public 文件夾中，我們只需要將該文件夾的內(nèi)容發(fā)布在網(wǎng)絡(luò)上即可。
更多關(guān)于主題的配置可以參考 hugo-theme-cleanwhite README.md
更詳細(xì)的配置規(guī)則，可參考Hugo官方文件
寫(xiě)作
現(xiàn)在可以創(chuàng)建一篇文章了。執(zhí)行命令hugo new post/hello-world.md，會(huì)在content/post/下新增一個(gè)名為hello-world.md的文件。我們將頭部自動(dòng)生成的部分進(jìn)行修改后，就可以在下面寫(xiě)自己的筆記或博文了。
---
title: "Hello World"
date: 2022-09-25T16:00:21+08:00
categories:
- "Blog"
tags:
- "Hugo"
draft: true
---
# Hello World.
Post example
本地部署
本地調(diào)試命令，執(zhí)行它，就可以直接通過(guò) http://localhost:1313 地址訪(fǎng)問(wèn)本地預(yù)覽網(wǎng)頁(yè)。
hugo server
本地發(fā)布命令，執(zhí)行它，就能在public/目錄下生成整套靜態(tài)網(wǎng)站，可以直接復(fù)制到web服務(wù)器中。
hugo
至此，Hugo本地方案的搭建過(guò)程完成！
本作品由 IvyWooo 采用知識(shí)共享署名-非商業(yè)性使用-相同方式共享 4.0 國(guó)際許可協(xié)議 進(jìn)行許可，轉(zhuǎn)載請(qǐng)注明出處。
本文鏈接
參考文章
- 《靜態(tài)博客框架jekyll、hexo和hugo三者之間的區(qū)別與差異》，https://zhuanlan.zhihu.com/p/368407566
- 《淺談我為什么從 HEXO 遷移到 HUGO》，https://sspai.com/post/59904
- 《從 Jekyll 轉(zhuǎn)移到 Hugo 心得》，https://blog.yeshuanova.com/2018/07/from-jekyll-to-hugo/
- 《Hugo + GitHub Action，搭建你的博客自動(dòng)發(fā)布系統(tǒng)》，https://www.pseudoyu.com/zh/2022/05/29/deploy_your_blog_using_hugo_and_github_action/
- 《使用 Hugo 搭建個(gè)人網(wǎng)站（博客、個(gè)人主頁(yè)）并發(fā)布到 Github 上》，https://zhuanlan.zhihu.com/p/417259374
