我記得一開始使用 Hugo 的時候是大四上,一開始在找有沒有方便好用的架站工具,結果就找到了這個。只需要選擇喜歡的網頁模板,再根據參數打上資料就好,超級方便!!但如果要加上一些額外功能還是需要自己作一些調整,這篇整理了在使用 Hugo 的過程中的一些經驗。

前情提要

因為我在做網站時有打算增加自定義 css,所以有先把 themes/<your_theme>/layouts/partials/head.html 新增到 layouts\partials\head.html

1. 增加 LaTex 數學式

Hugo 教學

這裡的步驟 90% 是參考官網的教學,可以直接使用,但我在使用時在 Step 3 遇到了問題,這樣寫實際上會造成網頁全部空白,我最後是在 /layouts/partials/head.html 新增 Step 3 的程式碼。

2. 改變 blockquote 顏色 (自定義 css)

首先在 /hugo.toml 輸入下面這一段,這邊的參數 custom.css 需要把之後新增的 css 檔案全部加進去。

[params]
    custom_css = ["/css/custom.css"]

接著在 /layouts/partials/head.html 加入下面這段,加在哪都可以。

{{ range .Site.Params.custom_css -}}
  <link rel="stylesheet" href="{{ . | absURL }}">
{{- end }}

最後到 /static/css/custom.css 新增自己要的 css 就大功告成!

3. 文字改變對齊

可以參考 這篇 的內容,但我怕他連結不見還是再這裡紀錄一次。

/layouts/shortcodes/align.html (沒有的話要自己新增) 加入下面的程式:

<!-- 文件位置:~/layouts/shortcodes/align.html -->
<p style="text-align:{{ index .Params 0 }}">{{ index .Params 1 | markdownify }}</p>

接著就可以在 markdown 檔案中加入不同文字對齊格式了!(這邊需要注意使用時要把 { 和 < 中間的空格移除)

{{ < align left "文字居左" > }}
{{ < align center "文字居中" > }}
{{ < align right "文字居右" > }}