Blog
Nothing here. Please visit the Chinese version instead.
Batch-convert file encoding
2025-06-30 於 Blog
前言 在利用 Gemini CLI 幫我整理舊專案的程式時，我發現有些被 Gemini CLI 改過的檔案，裡面的中文字會變成亂碼。這才知道它目前並未支援檔案編碼的偵測，而是一律把修改過的檔案以 UTF-8 編碼來儲存，因而導致某些原先以 Big5 編碼的檔案內的中文字變成亂碼。若要手動一個個轉檔，太耗時費力了，也容易遺漏。於是，我透過 ChatGPT 的幫助產生了兩個指令腳本來解決這個問題。 目標： 批次轉換檔案的編碼，從 Big5 轉換成 UTF-8。（稍加修改之後也能用來處理其他編碼的轉 …
網站更新：Docsy 升級至 v0.12.0
2025-06-03 於 Blog
更新日期：2025-06-03 主要更新 Docsy 從 v0.11.0 升級至 v0.12.0。詳見 Docsy changelog 0.12.0。 Hugo 從 v0.138.0 升級至 v0.147.7。詳見 Hugo News，需特別注意的是 v0.146.0，因為此版本有重大更新，而且是 breaking changes。 See also: Adapt to new template system in Hugo v0.146.0 更新細節 底下是升級過程中，對個別檔案和資料夾進行的 …
API Design-First Approach 心得筆記
2025-03-01 於 Blog
有機會近距離接觸 API design-first approach 的工作現場，這是我的一點觀察筆記和讀書心得。 專有名詞 這裡的 API 指的是 HTTP based 或 RESTful API。 這裡的 API spec 指的是採用 OpenAPI 語法所撰寫或生成的 API specification 文件。API spec 的原始檔案通常是 .yaml 或 .json 格式的檔案。API spec 檔案可透過一些現成工具直接生成 HTML 網頁，方便相關人員隨時查閱。 …
三國大傳：諸葛對司馬
2025-01-26 於 Blog
諸葛亮 如果說諸葛亮給魏延留的是一條生死間半的路，而留給楊儀的則是一條最多不過賦閒置散而已的生路。顯然，諸葛亮在死時，已下決心「拋棄」了他們，這對於二者都是一種可悲的結局，但孔明並不肯把事情做絕，他一定是認為「多行不義必自斃」，而二人果然都選擇了一條通往黃泉的道路，這也是二人咎由自取了。諸葛亮不是神，但確實是一位既能料生前，又能料死後的智絕謀高的人物。 -- 《三國大傳：諸葛對司馬》第三回，p.178 司馬懿 以下皆摘自《三國大傳：諸葛對司馬》第五回 司馬懿是一個純粹的目的論者，為了達到目的是可 …
Customizing Hugomods Icon Grid
2024-11-10 於 Blog
References Source code: hugomods/bootstrap - icon-grid.html Documents: Bootstrap Icon Grid Shortcode Hugo Icons Module Customization (todo)
Hugo Blockquote Render Hook
2024-09-09 於 Blog
Hugo supports blockquote render hooks since v0.132.0, which makes it easy to create beautiful alert boxes with the simple blockquote syntax. This is great because I don't need to use shortcodes for creating alert boxes anymore. Here are supported …
A Hugo image render hook that supports width parameter
2024-07-10 於 Blog
This post shows how I support image width with the URL query parameter width. Hugo version: 0.128.2 Requirement I want to specify a image's width via the URL query string. For example:  Rendered …
GitLab pages for different branches
2024-07-08 於 Blog
Attempt 1 Stack Overflow: Deploying GitLab pages for different branches It doesn't work because each page's URL must be ended with "index.html," which will not work with all links in the website except the home page. Attempt 2 GitLab Pages …
認識 Tailwind CSS
2024-06-26 於 Blog
Hugo 昨天（2024-06-25）發布了 v0.128.0，其 release note 提到這次加入了 TailwindCSS v4 (alpha)。我對前端技術相當陌生，以前聽過 Tailwind，但從未花時間去了解它。由於我的文件網站和部落格都使用 Hugo，所以這次花了一點時間去了解什麼是 Tailwind CSS，以及它有什麼特別之處。 首先，我從 Tailwind CSS 官網看到這句話： "Best practices" don't actually …