試用 Hugo Hiruko 主題

今天在爲新站點尋找主題的時候，發現了 Hiruko 這個蠻有意思的主題。主要是作者給出的 預覽截圖 比較吸引大家，這種支持豎排並公開發佈的主題確實不多見，雖然這只是主題的一個功能罷了，它的主頁還是只能橫排的。我一開始也是有點想用這個主題的，但考慮到中西混排的時候豎排會比較奇怪，所以爲了「兼容」只好放棄了。

不過這個主題因爲年代久遠，外加作者並未在 GitHub Repo 中給出安裝指南或示例站點，所以不止一人 表示 自己無法安裝。實際上作者在自己的博客裏給出了簡單的 安裝說明，但很顯然並沒有什麼特別的地方，實際操作下來肯定是不行的，具體報錯如下。

hugo v0.112.5-48e33e10af2feb2a0e1c32d04880ed016619f2d8+extended windows/amd64 BuildDate=2023-05-29T07:27:36Z VendorInfo=gohugoio
ERROR 2023/06/04 23:06:03 render of "home" failed: "C:\Users\Long\Documents\GitHub\longyin\themes\hiruko\layouts\index.html:6:20": execute of template failed: template: index.html:6:20: executing "index.html" at <.Paginate>: error calling Paginate: 'pager size' must be a positive integer
ERROR 2023/06/04 23:06:03 render of "term" failed: "C:\Users\Long\Documents\GitHub\longyin\themes\hiruko\layouts\_default\list.html:7:21": execute of template failed: template: _default/list.html:7:21: executing "_default/list.html" at <.Paginate>: error calling Paginate: 'pager size' must be a positive integer

這兩處錯誤都和分頁功能有關，檢查相關的代碼後可以發現，必須要在配置文件中指定每頁的數目，這是該方法的必要參數。

[params]
  paginate = 10
  ArchivePaginate = 10

在配置文件中補充以上設置後即可正常渲染所有頁面。¹

接下來還有一個問題，打開頁面後會發現缺失了很多靜態文件，主要是因爲作者把幾乎所有用到的外部庫都設置成了支持 CDN 的鏈接，但並未指定默認使用的本地路徑，因此需要在配置文件裏面逐一手動補全，以 Bootstrap 爲例，如下。²

[params]
  CDN.Bootstrap.Path = "/js/libs"
  CDN.Bootstrap.Version = "3.3.7"