使用Hugo建立個人網頁

Posted by Ian Tsai on Thursday, April 30, 2020

一直有想要寫一些文章記錄生活,身為一個工程師,難免會有想要自己架設的靈魂(?, 最近發現hugo可以快速架站,除了有template以外也可以自己更改裡面的配置 ,對於一個前端小菜鳥來說,算是一大福音XD,於是開始了這條漫漫長路~

—我是短分隔線—

以下紀錄是我花了幾天時間估狗各種網站+自己一直鬼打牆後的一些心得,希望也可以讓大家少踩點雷XD 然後我是用mac的系統,所以就先介紹mac架設的方法 那就開始介紹吧!!!

  • 開始之前

首先我們可以先去HUGO的官網選擇喜歡的template,我覺得很重要,畢竟是自己要用的,自己喜歡才有動力做下去!!


  • 開始搭建你的網站

1. 打開你的terminal,安裝hugo,輸入:

brew install hugo

brew 是mac的管理套件 如果沒裝過的話 可以去這裏看看或是複製以下程式碼到你的terminal執行

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

2. 建立新網站

hugo new site project-name
cd project-name

project-name可以自訂,看你喜歡叫什麼都行!

2-1. 資料夾結構

建立好網站以後,來看看一下結構,這邊當矇逼滿久的,想說就順便記錄比較清楚

project
├── archetypes
├── content # 文章的家
├── layout # html的家
├── static # js, css 的家
├── themes # 等等template要clone下來住的家

就先把大項目列出來,他的行距實在太大,我覺得很醜,但目前找不到方法只好先加減用了QQ

(之後來研究一下Markdown好了

3. 新增Theme: 我是用Hugo Future Imperfect Slim

cd themes
git clone https://github.com/pacollins/hugo-future-imperfect-slim.git

要等待一下下,完成後你就可以到你的themes內看看你選擇的template的資料有些啥

4. 將指定資料取代根目錄資料

這邊就要將你載下來的一些檔案取代你原本空的檔案

themes/layouts 取代原本的 layouts
themes/exampleSite/static 取代原本的 static
themes/exampleSite/content 這些範例文章可以放到content內
themes/exampleSite/config.toml 取代原本的config.toml

這樣基本上你的模板就完成了

4-1. 設定config.toml

基本上整個網站的參數設定都在這,隨著每個網站的不同,設置方式會有差異,這邊就說一個最基本的設定

baseurl                 = "https://github_account.github.io/"
DefaultContentLanguage  = "zh"
title                   = "Ian Blog"

因為我們之後要部署到github,所以baseurl就先把他設定好,一定要用github的帳號,才連接的上去

5. 新增文章

hugo new content/blog/first-post.md

新增的路徑依照你的主題不同會有不同的路徑,新增完後就可以開始寫你的文章了,而文章是用Markdown語法去寫

6. 啟動server

回到你的根目錄,然後輸入:

hugo server

跑完後你會看到一行http://localhost:1313/,點下去看看,若有頁面顯示,恭喜你已經完成了你的網站了!!!


剛開始分享可能有些不清楚的地方,自己的網站也還沒說非常完整,不過就把它當做成就一步一步解,也是頗有成就感!

本來想要把部署github也寫在一起,但好像篇幅會有點長,所以就下一篇再來分享怎麼把自己的hugo推到github上吧!!


  • References

  • HUGO Doc 感謝官方文件大力贊助播出