啟動菜單改成自己的樣子)
3 步完成 Ventoy 主題定制把默認(rèn)啟動菜單改成自己的樣子【免費下載鏈接】VentoyA new bootable USB solution.項目地址: https://gitcode.com/GitHub_Trending/ve/VentoyVentoy 啟動后的第一屏是 GRUB2 渲染出的圖形菜單。默認(rèn)主題能用但背景、配色、菜單位置全是別人定的。這篇文章教你用 Ventoy 主題定制把這一屏換成自己的設(shè)計做完之后U 盤插到任何機器上開機顯示的是你畫的背景、你排的菜單、你指定的字體和顏色。先搞懂 Ventoy 的主題體系ventoy.json 和 theme.txt 各管什么Ventoy 的圖形界面構(gòu)建在 GRUB2 的 gfxmenu 之上所以主題文件就是標(biāo)準(zhǔn)的 GRUB2theme.txt格式但 Ventoy 在上面多包了一層配置入口。整個鏈路上有三個角色先分清再動手后面少走彎路ventoy.json位于 Ventoy 分區(qū)根目錄的ventoy/ventoy.json是插件總配置。theme節(jié)點在這里指定主題文件路徑、顯示模式等。theme.txtGRUB2 主題格式文件定義背景圖、菜單框位置、顏色、字體。同目錄的圖片資源背景圖、9 段式邊框圖等文件名要和theme.txt里引用的名稱完全一致區(qū)分大小寫。默認(rèn)主題就放在grub/themes/ventoy/theme.txt倉庫里也附了一份可直接參考的示例 theme.txt 和對應(yīng)的 ventoy.json。建議先打開讀一遍下面所有寫法都來自這兩份文件。第一步在 ventoy.json 里指定主題文件在ventoy/ventoy.json中寫入或修改theme節(jié)點theme: { file: /ventoy/themes/mytheme/theme.txt, display_mode: GUI }字段說明file主題文件路徑。以/開頭表示 Ventoy 分區(qū)根目錄下的絕對路徑不以/開頭時Ventoy 會自動補成/ventoy/…再查找所以寫成themes/mytheme/theme.txt也行。路徑必須真實存在否則整段配置被丟棄回落到默認(rèn)主題。display_modeGUI表示圖形模式。改成別的值會走文本菜單圖形主題完全不加載——這是主題不生效最常見的隱藏原因之一。同節(jié)點下還有g(shù)fxmode顯式指定分辨率、ventoy_left/ventoy_top/ventoy_color底部 Ventoy 狀態(tài)行文字的位置與顏色按需要添加不寫就用默認(rèn)值1024x768、5%、95%、藍色。路徑規(guī)則來自插件的解析邏輯ventoy_plugin.c先按你寫的路徑檢查文件是否存在存在才導(dǎo)出vtoy_theme環(huán)境變量grub.cfg據(jù)此加載你的主題否則使用內(nèi)置的themes/ventoy/theme.txt。第二步最小可用的 theme.txt 與百分比布局新建目錄ventoy/themes/mytheme/放入背景圖background.png1024x768 的 4:3 圖最穩(wěn)妥再寫一份theme.txt。下面是最小可運行版本desktop-image: background.png title-text: Ventoy title-color: #ffffff message-color: #f2f2f2 boot_menu { left 10% width 80% top 30% height 50% item_color #ffffff selected_item_color #f2f2f2 item_height 30 item_spacing 1 scrollbar true scrollbar_width 10 }幾個關(guān)鍵點定位用百分比。left、top、width、height都可以寫10%這種形式相對當(dāng)前顯示分辨率計算1024x768 和 1920x1080 上都不會出界。想要精調(diào)時用混合表達式官方示例里就有l(wèi)eft 30%200、top 95%-25這種百分比加減像素的寫法。顏色用十六進制。item_color普通菜單項、selected_item_color高亮項、message-color提示信息等#RRGGBB或 GRUB 支持的顏色名都行。desktop-image相對路徑相對theme.txt所在目錄解析所以背景圖、邊框圖都放同一個目錄文件名引用時不要寫路徑前綴。scrollbar trueISO 數(shù)量多時菜單溢出靠滾動條建議保留。改完這一層開機后你看到的就已經(jīng)是自定義背景 自定義菜單框了。第三步用 VTOY_* 占位符顯示動態(tài)狀態(tài)Ventoy 在 GRUB2 的 label 組件里擴展了一批占位符實現(xiàn)在 gui_label.c放進label的text里即可顯示實時信息占位符含義什么時候用VTOY_HOTKEY_TIP當(dāng)前菜單的快捷鍵提示樹狀/列表模式文案不同放在底部常駐提示行VTOY_MEM_DISK是否處于 MemDisk 模式調(diào)試加載方式時VTOY_ISO_RAW是否以原始鏡像方式啟動同上VTOY_GRUB2_MODE/VTOY_WIMBOOT_MODE對應(yīng)啟動模式狀態(tài)需要區(qū)分啟動鏈路時VTOY_ISO_UEFI_DRVISO UEFI 驅(qū)動加載狀態(tài)UEFI 問題排查這些占位符只在條件成立時顯示對應(yīng)文字不成立時顯示空格不會留出一塊難看的殘字。用法是套一個hbox容器再放label官方示例的寫法theme.txt hbox { left 30% top 95% width 10% height 25 label {text VTOY_HOTKEY_TIP color blue align left} }多個狀態(tài)行就復(fù)制幾段hbox用top 95%-25、top 95%-50向上錯位排布。除了VTOY_*GRUB2 自帶的KEYMAP_LONG、TIMEOUT_NOTIFICATION_SHORT進度條倒計時文案同樣可用。進階9 段式可伸縮圖形與滾動條想要菜單有邊框、選中項有高亮條、滾動條有滑塊不要去做一整張大圖用 9-patch九段式切圖。命名規(guī)律是同一個前綴加方位后綴菜單框menu_*.png→menu_nw.png、menu_n.png、menu_ne.png、menu_e.png、menu_c.png等九張選中條select_c.png一張橫條即可selected_item_pixmap_style滾動條滑塊slider_n.png/slider_c.png/slider_s.png終端窗口框terminal_box_*.png。theme.txt里用通配符引用整組menu_pixmap_style menu_*.png selected_item_pixmap_style select_*.png scrollbar_thumb slider_*.png terminal-box: terminal_box_*.png為什么有效GRUB2 加載時會把九段式圖片自動按菜單實際尺寸拉伸拼接——角塊不變形邊塊平鋪。這樣同一套圖在小屏和 4K 屏上都成立比按某個分辨率畫死的整屏圖適應(yīng)性好得多。倉庫自帶的這組小圖每個只有幾百字節(jié)自己畫時照著尺寸做就行。多主題、隨機切換與分辨率適配ventoy.json的theme節(jié)點還支持三種進階配置多主題數(shù)組file寫成字符串?dāng)?shù)組列出多份 theme.txt 路徑全部加載random每次啟動從數(shù)組里隨機取一份。取值boot_second同一秒內(nèi)不變、boot_day同一天固定、boot_month同一個月固定適合每天換個背景這類玩法resolution_fit: 1結(jié)合多主題數(shù)組使用按當(dāng)前顯示器實際分辨率自動挑選最匹配的主題。這是官方解決不同分辨率適配的正式手段比在 theme.txt 里做響應(yīng)式計算更直接。配置多份后菜單里按 F5 打開的診斷菜單會出現(xiàn)主題切換入口debug.cfg 中的 theme select 子菜單可以現(xiàn)場預(yù)覽每一份主題的效果不用反復(fù)重啟試錯。字體方面theme節(jié)點還接受fonts數(shù)組指向 U 盤內(nèi)的.pf2字體文件路徑支持/絕對路徑或相對/ventoy/菜單里通過item_font、label的font屬性引用。想顯示中文菜單文字這一步不能省GRUB2 默認(rèn)字體不含中文字形。主題不生效時的四項排查?? 按命中率從高到低排路徑或大小寫錯誤。ventoy.json與theme.txt都是大小寫敏感的Theme.txt和theme.txt是兩回事file里/開頭的路徑相對 Ventoy 分區(qū)根目錄漏寫一級目錄很常見。JSON 語法錯誤。多一個逗號、引號沒閉合會導(dǎo)致整個ventoy.json解析失敗所有插件配置都不生效而不會單獨報 theme 錯。display_mode不是 GUI。文本模式下 theme 根本不會被加載。theme.txt 里的圖片引用對不上。desktop-image或menu_*.png組中缺一張文件對應(yīng)元素渲染失敗。前兩項不用猜按 F5 進入診斷菜單 → JSON 檢查 → 選 theme 檢查對應(yīng)vt_check_plugin_json命令見 debug.cfgVentoy 會逐條打印每個file是OK還是NOT EXIST、字體路徑是否存在、各配置項的取值結(jié)果直接讀屏幕即可。寫在最后整套流程歸納成清單? 主題文件放ventoy/themes/名字/背景圖、theme.txt、9 段式圖同目錄?ventoy/ventoy.json的theme節(jié)點寫清file和display_mode: GUI? 布局用百分比 混合表達式狀態(tài)行用VTOY_*占位符? 改完先用 F5 診斷菜單的 theme 檢查確認(rèn)文件可達再重啟看效果? 要跨分辨率統(tǒng)一體驗用多主題數(shù)組 resolution_fit別硬寫像素。ventoy.json 配置、theme.txt 寫法這兩處是日后維護的全部入口把這兩份文件用文本編輯器版本化管理改動一目了然。【免費下載鏈接】VentoyA new bootable USB solution.項目地址: https://gitcode.com/GitHub_Trending/ve/Ventoy創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 3 步完成 Ventoy 主題定制：把默認(rèn)啟動菜單改成自己的樣子
3 步完成 Ventoy 主題定制把默認(rèn)啟動菜單改成自己的樣子【免費下載鏈接】VentoyA new bootable USB solution.項目地址: https://gitcode.com/GitHub_Trending/ve/VentoyVentoy 啟動后的第一屏是 GRUB2 渲染出的圖形菜單。默認(rèn)主題能用但背景、配色、菜單位置全是別人定的。這篇文章教你用 Ventoy 主題定制把這一屏換成自己的設(shè)計做完之后U 盤插到任何機器上開機顯示的是你畫的背景、你排的菜單、你指定的字體和顏色。先搞懂 Ventoy 的主題體系ventoy.json 和 theme.txt 各管什么Ventoy 的圖形界面構(gòu)建在 GRUB2 的 gfxmenu 之上所以主題文件就是標(biāo)準(zhǔn)的 GRUB2theme.txt格式但 Ventoy 在上面多包了一層配置入口。整個鏈路上有三個角色先分清再動手后面少走彎路ventoy.json位于 Ventoy 分區(qū)根目錄的ventoy/ventoy.json是插件總配置。theme節(jié)點在這里指定主題文件路徑、顯示模式等。theme.txtGRUB2 主題格式文件定義背景圖、菜單框位置、顏色、字體。同目錄的圖片資源背景圖、9 段式邊框圖等文件名要和theme.txt里引用的名稱完全一致區(qū)分大小寫。默認(rèn)主題就放在grub/themes/ventoy/theme.txt倉庫里也附了一份可直接參考的示例 theme.txt 和對應(yīng)的 ventoy.json。建議先打開讀一遍下面所有寫法都來自這兩份文件。第一步在 ventoy.json 里指定主題文件在ventoy/ventoy.json中寫入或修改theme節(jié)點theme: { file: /ventoy/themes/mytheme/theme.txt, display_mode: GUI }字段說明file主題文件路徑。以/開頭表示 Ventoy 分區(qū)根目錄下的絕對路徑不以/開頭時Ventoy 會自動補成/ventoy/…再查找所以寫成themes/mytheme/theme.txt也行。路徑必須真實存在否則整段配置被丟棄回落到默認(rèn)主題。display_modeGUI表示圖形模式。改成別的值會走文本菜單圖形主題完全不加載——這是主題不生效最常見的隱藏原因之一。同節(jié)點下還有g(shù)fxmode顯式指定分辨率、ventoy_left/ventoy_top/ventoy_color底部 Ventoy 狀態(tài)行文字的位置與顏色按需要添加不寫就用默認(rèn)值1024x768、5%、95%、藍色。路徑規(guī)則來自插件的解析邏輯ventoy_plugin.c先按你寫的路徑檢查文件是否存在存在才導(dǎo)出vtoy_theme環(huán)境變量grub.cfg據(jù)此加載你的主題否則使用內(nèi)置的themes/ventoy/theme.txt。第二步最小可用的 theme.txt 與百分比布局新建目錄ventoy/themes/mytheme/放入背景圖background.png1024x768 的 4:3 圖最穩(wěn)妥再寫一份theme.txt。下面是最小可運行版本desktop-image: background.png title-text: Ventoy title-color: #ffffff message-color: #f2f2f2 boot_menu { left 10% width 80% top 30% height 50% item_color #ffffff selected_item_color #f2f2f2 item_height 30 item_spacing 1 scrollbar true scrollbar_width 10 }幾個關(guān)鍵點定位用百分比。left、top、width、height都可以寫10%這種形式相對當(dāng)前顯示分辨率計算1024x768 和 1920x1080 上都不會出界。想要精調(diào)時用混合表達式官方示例里就有l(wèi)eft 30%200、top 95%-25這種百分比加減像素的寫法。顏色用十六進制。item_color普通菜單項、selected_item_color高亮項、message-color提示信息等#RRGGBB或 GRUB 支持的顏色名都行。desktop-image相對路徑相對theme.txt所在目錄解析所以背景圖、邊框圖都放同一個目錄文件名引用時不要寫路徑前綴。scrollbar trueISO 數(shù)量多時菜單溢出靠滾動條建議保留。改完這一層開機后你看到的就已經(jīng)是自定義背景 自定義菜單框了。第三步用 VTOY_* 占位符顯示動態(tài)狀態(tài)Ventoy 在 GRUB2 的 label 組件里擴展了一批占位符實現(xiàn)在 gui_label.c放進label的text里即可顯示實時信息占位符含義什么時候用VTOY_HOTKEY_TIP當(dāng)前菜單的快捷鍵提示樹狀/列表模式文案不同放在底部常駐提示行VTOY_MEM_DISK是否處于 MemDisk 模式調(diào)試加載方式時VTOY_ISO_RAW是否以原始鏡像方式啟動同上VTOY_GRUB2_MODE/VTOY_WIMBOOT_MODE對應(yīng)啟動模式狀態(tài)需要區(qū)分啟動鏈路時VTOY_ISO_UEFI_DRVISO UEFI 驅(qū)動加載狀態(tài)UEFI 問題排查這些占位符只在條件成立時顯示對應(yīng)文字不成立時顯示空格不會留出一塊難看的殘字。用法是套一個hbox容器再放label官方示例的寫法theme.txt hbox { left 30% top 95% width 10% height 25 label {text VTOY_HOTKEY_TIP color blue align left} }多個狀態(tài)行就復(fù)制幾段hbox用top 95%-25、top 95%-50向上錯位排布。除了VTOY_*GRUB2 自帶的KEYMAP_LONG、TIMEOUT_NOTIFICATION_SHORT進度條倒計時文案同樣可用。進階9 段式可伸縮圖形與滾動條想要菜單有邊框、選中項有高亮條、滾動條有滑塊不要去做一整張大圖用 9-patch九段式切圖。命名規(guī)律是同一個前綴加方位后綴菜單框menu_*.png→menu_nw.png、menu_n.png、menu_ne.png、menu_e.png、menu_c.png等九張選中條select_c.png一張橫條即可selected_item_pixmap_style滾動條滑塊slider_n.png/slider_c.png/slider_s.png終端窗口框terminal_box_*.png。theme.txt里用通配符引用整組menu_pixmap_style menu_*.png selected_item_pixmap_style select_*.png scrollbar_thumb slider_*.png terminal-box: terminal_box_*.png為什么有效GRUB2 加載時會把九段式圖片自動按菜單實際尺寸拉伸拼接——角塊不變形邊塊平鋪。這樣同一套圖在小屏和 4K 屏上都成立比按某個分辨率畫死的整屏圖適應(yīng)性好得多。倉庫自帶的這組小圖每個只有幾百字節(jié)自己畫時照著尺寸做就行。多主題、隨機切換與分辨率適配ventoy.json的theme節(jié)點還支持三種進階配置多主題數(shù)組file寫成字符串?dāng)?shù)組列出多份 theme.txt 路徑全部加載random每次啟動從數(shù)組里隨機取一份。取值boot_second同一秒內(nèi)不變、boot_day同一天固定、boot_month同一個月固定適合每天換個背景這類玩法resolution_fit: 1結(jié)合多主題數(shù)組使用按當(dāng)前顯示器實際分辨率自動挑選最匹配的主題。這是官方解決不同分辨率適配的正式手段比在 theme.txt 里做響應(yīng)式計算更直接。配置多份后菜單里按 F5 打開的診斷菜單會出現(xiàn)主題切換入口debug.cfg 中的 theme select 子菜單可以現(xiàn)場預(yù)覽每一份主題的效果不用反復(fù)重啟試錯。字體方面theme節(jié)點還接受fonts數(shù)組指向 U 盤內(nèi)的.pf2字體文件路徑支持/絕對路徑或相對/ventoy/菜單里通過item_font、label的font屬性引用。想顯示中文菜單文字這一步不能省GRUB2 默認(rèn)字體不含中文字形。主題不生效時的四項排查?? 按命中率從高到低排路徑或大小寫錯誤。ventoy.json與theme.txt都是大小寫敏感的Theme.txt和theme.txt是兩回事file里/開頭的路徑相對 Ventoy 分區(qū)根目錄漏寫一級目錄很常見。JSON 語法錯誤。多一個逗號、引號沒閉合會導(dǎo)致整個ventoy.json解析失敗所有插件配置都不生效而不會單獨報 theme 錯。display_mode不是 GUI。文本模式下 theme 根本不會被加載。theme.txt 里的圖片引用對不上。desktop-image或menu_*.png組中缺一張文件對應(yīng)元素渲染失敗。前兩項不用猜按 F5 進入診斷菜單 → JSON 檢查 → 選 theme 檢查對應(yīng)vt_check_plugin_json命令見 debug.cfgVentoy 會逐條打印每個file是OK還是NOT EXIST、字體路徑是否存在、各配置項的取值結(jié)果直接讀屏幕即可。寫在最后整套流程歸納成清單? 主題文件放ventoy/themes/名字/背景圖、theme.txt、9 段式圖同目錄?ventoy/ventoy.json的theme節(jié)點寫清file和display_mode: GUI? 布局用百分比 混合表達式狀態(tài)行用VTOY_*占位符? 改完先用 F5 診斷菜單的 theme 檢查確認(rèn)文件可達再重啟看效果? 要跨分辨率統(tǒng)一體驗用多主題數(shù)組 resolution_fit別硬寫像素。ventoy.json 配置、theme.txt 寫法這兩處是日后維護的全部入口把這兩份文件用文本編輯器版本化管理改動一目了然。【免費下載鏈接】VentoyA new bootable USB solution.項目地址: https://gitcode.com/GitHub_Trending/ve/Ventoy創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考