Hugo 初次建立相關指令

Eddie Lu 呂英全

2024/09/03

Categories: hugo Tags: hugo 網站 筆記 終端機

hugo 有的指令,只有久久沒用,就會忘記,因此把一些已經用過的,都記錄下來!

創建新網站

hugo new site siteName

進入剛建立網站的資料夾

cd siteName

輸入指令 ls 看資料夾內容

ls
archetypes
config
data
public
static
assets
content
layouts
resources
themes

新手先知道這些:

  1. themes 是主題,要上 https://themes.gohugo.io/ 去找。
  2. content 是網頁、文章(post)擺放的地方。
  3. config 是設定整個網站的地方。
  4. static 是放圖片的地方。
  5. public 是最後生成網站的地方(你要上傳出去的檔案)。

更換主題

https://themes.gohugo.io/ 尋找,並且複製 Download 按鈕的連結。

進入 themes 資料夾

 cd themes

以 diary 主題為例

 git init
 git submodule add https://github.com/AmazingRise/hugo-theme-diary

找到 /config/_default/config.toml

打開找到 theme = “",引號中改為你的主題名稱。

創立頁面

一般頁面

把檔案建立在 content/

hugo new pageName.md

通常 About me、Contact me 這種沒時間線的會放這

文章頁面

把檔案建立在 content/post/

hugo new post/first.md

查看目前網站

顯示目前直接發佈的頁面樣子

hugo server

把所有草稿文章也顯示出來

hugo server -D

生成網站

hugo

此時會在 pubic 資料夾生成網站,接著上傳到伺服器就大工告成!

後記

hugo 其實可以玩的花樣非常多,目前本站使用 classical 的 theme,是因爲用過太多 theme 之後,最後決定反撲歸真,用超簡單的 hugo主題,未來想要什麼功能,我再慢慢研究加上去,新手一下用功能很多的主題,容易會搞不清楚 hugo 各種檔案之間的關聯!

>> Home