Hugo設定檔的簡單介紹，這設定會直接影響整個網站的運作。

一般來說模板套用的config只要把網址改成自己的就可以直接使用，這邊記錄一些自己有去調整的部分，這些可能比較容易會用到。

Hugo讀取的設定

預設使用config.toml, config.yaml, config.json做為網站的設定檔。
如果有準備多個不同環境的設定，可以在產生的時候使用–config選擇使用哪一個設定檔來使用。

hugo --config debugconfig.toml
hugo --config a.toml,b.toml,c.toml

基本設定

baseURL = “網址”

languageCode = “語言”
繁中的話這邊設定為"zh-tw"

title = “網站標題”

theme = “使用模板的資料夾”

posts = “文章網址格式”
常見的設定為"/:year/:month/:title/"，這樣子發出的文章就會照檔案裡Front Matter裡面的資料，以/年/月/文章標題來產生網址。
由於這邊的文章應該是以中文為主，但是不想要使用中文來當作網址的緣故，改設定成"/:year/:month/:slug/"，這樣子就可以在Front Matter中加入slug來設定文章的英文當網址使用，如果設定了:slug 但 Front Matter 格式內卻沒給 slug 的值時，預設會使用 title 替代 slug。

favicon = “瀏覽器Tab上的小圖案路徑”

enableEmoji = true “true的話可以在文章中使用emoji符號”

類別

預設提供了以下兩種 Taxonomy，只要佈景的layout有設定就可以在網址/{taxonomy}中顯示該類別全部文章

• categories：使用者可於 Front Matter 中，指定文章類別
• tags：使用者可於 Front Matter 中，指定文章標籤

如果不想使用預設分類可以通過設定來關閉

• 自訂分類 taxonomies，不想使用的分類不要列出就可以關閉，也能自行增加非關鍵字使用

[taxonomies]  
  tag = "tags"
  category = "categories"
  product = "products"

• 關閉分類 disableKinds

disableKinds = ["taxonomy", "term"]

sitemap

SEO優化使用，可以參考官方範例
https://gohugo.io/templates/sitemap-template/#configure-sitemapxml
不特別調整的話加入下方這段並更改更新頻率就好

[sitemap]
  changefreq = "monthly"
  filename = "sitemap.xml"
  priority = 0.5

頻率參數可參考https://www.sitemaps.org/zh_TW/protocol.html

Google Analytics

Hugo已整合GA，加入GA參數就好
googleAnalytics = "GA的ID"

嵌入iframe

如果需要嵌入其他頁面的話需要設定這個選項，預設的安全性會把iframe排除掉，將安全性關閉即可。

[markup.goldmark.renderer]
  unsafe = true