一直有想要寫一些文章記錄生活,身為一個工程師,難免會有想要自己架設的靈魂(?, 最近發現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 感謝官方文件大力贊助播出