1. 程式人生 > 實用技巧 >Hugo部落格的搭建

Hugo部落格的搭建

Hugo是由Go語言實現的靜態網站生成器。簡單、易用、高效、易擴充套件、快速部署。

昨天花了很多時間用Hugo與GitHub Page連線,搭建起了一個部落格。

與以前搭建Hexo相比,Hugo對搭建環境的要求確實較低,過程也比較簡單快速。

Hugo的安裝

Hugo的安裝相當簡單。只需要下載exe檔案,並將exe檔案所在的目錄新增到系統環境變數即可。如圖:

新增好環境變數後,在命令列輸入

hugo version

即可檢視安裝資訊。

如圖。

網站的搭建

安裝成功後,進入任意目錄,在cmd輸入

hugo new site /directory

即可在你進入cmd的目錄下建立一個directory目錄,用來存放靜態網站的原始檔。目錄的結構如下:

  ▸ archetypes/
  ▸ content/
  ▸ layouts/
  ▸ static/
    config.toml

其中 config.toml檔案中是頁面的配置資訊,決定了頁面的外觀。

安裝主題

靜態網站的檔案已經生成了,但是現在生成的網站會是空白,因此需要安裝主題。

Hugo在 https://themes.gohugo.io/ 提供了許多的主題 (雖然暫時還沒有Hexo多)。可以瀏覽該網站,選擇自己喜歡的主題。

安裝主題可以直接進入主題頁面下載壓縮包,也可以在控制檯使用 git clone命令下載。主題存放在directory/themes/ 目錄下。

主題安裝好後,進入主題資料夾中的exampleSite

目錄,複製裡面的檔案,覆蓋貼上到根目錄,這樣在生成網站時就有了模板。

生成網站

執行

hugo server

命令,在瀏覽器位址列輸入 localhost:1313可以預覽生成的網站。

部署到GitHubPage

首先,在GitHub上需要有一個名為 username.io 的倉庫(username代表GitHub使用者名稱,必須完全相同)。這樣才能獲得一個域名為username.github.io的GitHubPage。

開啟根目錄的config.toml檔案,進行如下修改:

baseUrl="https://github.com/username/username.io/"

注意最後的反斜槓一定要加上!

之後執行命令

hugo --baseUrl="http://username.github.io/"

注意,以上命令並不會生成草稿頁面,如果未生成任何文章,請去掉文章頭部的 draft=true 再重新生成。

如果一切順利,所有靜態頁面都會生成到 public 目錄,現在需要將pubilc目錄裡所有檔案 push 到剛建立的Repository的 master 分支。

$ cd public
$ git init
$ git remote add origin https://github.com/coderzh/coderzh.github.io.git
$ git add -A
$ git commit -m "first commit"
$ git push -u origin master

第一次執行過程會需要輸入GitHub的賬號和密碼,進行身份驗證。

書寫文章、更新

搭建好網站只是第一步。現在問題來了:應該怎麼更新博文呢?靜態網站發表文章遠不如線上部落格方便,而是需要本地寫好後再生成。並push到GitHubPage的倉庫裡,才能實現博文更新。

博文預設存放在\content\post目錄下。可以直接在該目錄建立md檔案,也可以在根目錄執行

hugo new post/article.md

這樣生成的markdown檔案會自動起一個標題,並生成發表時間。

寫好markdown檔案後,便可以發表了。如上面所述,先在本地生成。現在需要提交到線上:

cd public
git add -A
git commit -m "xxxx"
git push -f origin master

稍等一下再進入網站,應該就可以看到寫好的博文辣!