GRUB2 主題製作與視覺排版深度指南

當我們想要為 GRUB2 打造自訂主題時，必須建立標準目錄結構，並告訴系統主題組態檔案的絕對路徑。以下是完整的標準建立步驟：

1. 建立主題目錄與設定檔

建議將新主題放置於 /boot/grub2/themes/（或某些發行版的 /boot/grub/themes/）目錄下：

# 建立主題目錄
sudo mkdir -p /boot/grub2/themes/my_theme/

# 建立核心主題檔案 theme.txt
sudo touch /boot/grub2/themes/my_theme/theme.txt

2. 修改 /etc/default/grub 設定檔

在 /etc/default/grub 檔案中指定 GRUB_THEME 變數為主題設定檔的完整路徑：

# 指定 GRUB2 主題檔案之絕對路徑（注意：同一個參數不可重複出現多次）
GRUB_THEME="/boot/grub2/themes/my_theme/theme.txt"

3. 重新產生開機設定檔 (update-grub2)

變更 /etc/default/grub 後，必須重新產生引導組態 /boot/grub2/grub.cfg：

# 若系統具備 update-grub2 腳本（需 root 權限）：
sudo update-grub2

# 若系統沒有 update-grub2，則執行標準指令：
sudo grub2-mkconfig -o /boot/grub2/grub.cfg

GRUB2 預定義元素類型 (Types of Elements)

九宮格圖形切片（9-Slice Scaling）原理

在 GRUB2 中，所有具有邊框裝飾的元素（例如按鈕 button_*.png、選單框 menu_*.png、控制台外框 inbox_*.png）都採用 9 個區域（Zones） 拼接：

📐 選單精密高度計算公式 (boot_menu Height Formula)

在 GRUB2 中，boot_menu 是最關鍵的組件。然而許多主題作者常遇到「選單最後一項的高亮裝飾被截斷」或「滾動條底部與選中項目邊框無法齊平」的嚴重跑版問題。

原作者 Vladimir Testov 透過閱讀原始碼，推導出選單總高度（height）與可視項目數量（$N \ge 3$）之間的唯一絕對正確精準公式：

選單其他重要參數規範

progress_bar 元件專門用來視覺化倒數剩餘時間。若要啟用倒數連動，必須將其 id 設定為特殊常數 __timeout__。

環形指示器透過在圓周圍繪製一圈刻度圖片（tick_bitmap）並環繞中心背景圖片（center_bitmap）來展示倒數。這其中有幾個極為特殊的渲染限制：

1. 座標越界與數值自動修復演算法

當我們在 theme.txt 中設定的座標或尺寸超出父容器範圍時，GRUB2 引擎會依循以下防呆修復規則（令父容器寬高為 parent_width 與 parent_height）：

💡 實用技巧：這項特性可以善用在多螢幕解析度自適應上，讓右緣或底緣自動對齊父容器或螢幕邊界！

2. 字型符號回退替換機制 (Fallback)

若在 theme.txt 中指定的字型未找到，或該字型缺少某些特定字元（例如終端機邊框符號、特殊符號），GRUB2 會自動從主題目錄中存在的其他字型中挑選最適合的符號補上。 因此，若在螢幕上看到邊框變成問號（?）或虛線，即代表當前字型缺少該字元，需補充適當的字型檔。

GRUB2 無法直接讀取標準 TrueType 字型，必須透過官方工具 grub2-mkfont 轉為專屬的點陣字型格式 .pf2。 GRUB2 不支援字距微調（Kerning）。

GRUB2 開機引導程式的設定檔解析器極度嚴苛。只要一個全域選項誤用了等號 =，或選單高度未依據官方精確公式計算，就可能導致開機畫面直接黑屏、破圖或退回文字救援模式。

本校驗器在瀏覽器前端進行深度靜態語法健檢，支援即時分析錯誤行號、違規原因並提供精準的綠色修復代碼建議。