Ventoy 全局控制插件-软件库

本插件用来配置一些Ventoy的全局设置。比如默认显示模式等。

Json 配置

关于 ventoy.json 的位置以及相关说明，请首先参考插件入口（*必读）
在镜像分区 /ventoy/ventoy.json 中定义了一个 control 数组来描述本插件，数组中的每个成员都是有一个字符串类型的键值对。
注意你不需要对这里列出来的每一项都做配置，可以只对其中的一项或几项做特殊配置，其他的会使用默认值.

{
    "control": [
        { "VTOY_DEFAULT_MENU_MODE": "0" },
        { "VTOY_TREE_VIEW_MENU_STYLE": "0" },
        { "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" },
        { "VTOY_SORT_CASE_SENSITIVE": "0" },
        { "VTOY_MAX_SEARCH_LEVEL": "max" },
        { "VTOY_DEFAULT_SEARCH_ROOT": "/ISO" },        
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "/ISO/debian_netinstall.iso" },
        { "VTOY_FILE_FLT_EFI": "1" },
        { "VTOY_DEFAULT_KBD_LAYOUT": "QWERTY_USA" }
    ]
}

关键字	类型	描述
`VTOY_DEFAULT_MENU_MODE`	`STRING`	默认显示模式，”0″:列表模式 “1”:TreeView 模式
`VTOY_TREE_VIEW_MENU_STYLE`	`STRING`	TreeView模式下的菜单风格，”0″:显示DIR和文件大小 “1”:不显示DIR和文件大小默认是 “0”
`VTOY_FILT_DOT_UNDERSCORE_FILE`	`STRING`	过滤以 ._ 开头的文件。当使用苹果系统时，有时拷贝文件会产生一些 ._ 开头的文件，可以通过此选项过滤掉。 “0”: 不过滤 “1”:过滤
`VTOY_SORT_CASE_SENSITIVE`	`STRING`	在菜单排序时是否大小写敏感。默认是 “0” （大小写不敏感） “0”:大小写不敏感 “1”:大小写敏感
`VTOY_MAX_SEARCH_LEVEL`	`STRING`	最大搜索子目录的层数，取值为：`max` `0` `1` `2` `3` `...` 默认值为：`max` 默认Ventoy会递归搜索磁盘上的所有目录和子目录，不管目录结构有多深都会搜索到底。你可以通过这个参数来控制搜索时的路径深度。 `max` : 最大层数，也就是搜索所有子目录的意思。这也是 Ventoy 的默认值。 `0` : 搜索0层子目录，只列出根目录下的文件，不去搜索任何一个子目录。 `1` : 搜索1层子目录，除了根目录下的文件以外，再搜索根目录下的1级子目录。但是不再搜索1级子目录下的子目录（2级子目录）。 `2` : 搜索2层子目录，除了根目录下的文件以外，再搜索根目录下的1级子目录以及1级子目录下的子目录（2级子目录）。 `3` : 搜索3层子目录，…… `...` 注意，如果 `VTOY_DEFAULT_SEARCH_ROOT` 参数也同时设置了的话，则就以 `VTOY_DEFAULT_SEARCH_ROOT` 指定的目录作为根目录开始计算。
`VTOY_DEFAULT_SEARCH_ROOT`	`STRING`	指定搜索ISO文件的根目录。默认Ventoy会搜索U盘上的所有目录和子目录，当你U盘上有海量的文件时，这个过程会很慢。这种情况下你可以把ISO文件单独放在某个目录下，然后通过这个变量来指定搜索路径，此时Ventoy就只会搜索该目录及其子目录。
`VTOY_MENU_TIMEOUT`	`STRING`	菜单倒计时（秒）。默认不设置，设置之后，比如设置为10，则在倒计时10秒之后，会自动选择启动第1个镜像文件。在倒计时的过程中按任意键会停止倒计时，等待用户操作。
`VTOY_DEFAULT_IMAGE`	`STRING`	正常情况下默认选中的是第1个镜像文件。通过这个选项可以设置默认选中的镜像文件，一般和 VTOY_MENU_TIMEOUT 一起使用。可以设置为 WIM/VHD/IMG 等支持的文件，必须是以 / 开始的全路径，ListView模式和TreeView模式都支持。注意，当同时设置了 VTOY_DEFAULT_SEARCH_ROOT 以后，VTOY_DEFAULT_IMAGE 对应的文件必须位于 VTOY_DEFAULT_SEARCH_ROOT 对应的目录下，否则不会生效。除此之外，还可以设置为一些特殊值，参考本页特殊 VTOY_DEFAULT_IMAGE 值。
`VTOY_VHD_NO_WARNING`	`STRING`	“0”: 启动Windows VHD(x)时，如果U盘分区不是NTFS格式，则显示告警信息 “1”: 不显示告警信息默认是 “0”，即显示告警信息
`VTOY_DEFAULT_KBD_LAYOUT`	`STRING`	默认键盘布局，默认是 `QWERTY_USA` 支持的键盘布局有： `QWERTY_USA` `AZERTY` `CZECH_QWERTY` `CZECH_QWERTZ` `DANISH` `DVORAK_USA` `FRENCH` `GERMAN` `ITALIANO` `JAPAN_106` `LATIN_USA` `PORTU_BRAZIL` `QWERTY_UK` `QWERTZ` `QWERTZ_HUN` `QWERTZ_SLOV_CROAT` `SPANISH` `SWEDISH` `TURKISH_Q` `VIETNAMESE`
`VTOY_FILE_FLT_ISO`	`STRING`	“0”: 不过滤 .iso 文件 “1”: 过滤掉 .iso 文件。默认值是 “0”，即不过滤。
`VTOY_FILE_FLT_WIM`	`STRING`	“0”: 不过滤 .wim 文件 “1”: 过滤掉 .wim 文件。默认值是 “0”，即不过滤。
`VTOY_FILE_FLT_EFI`	`STRING`	“0”: 不过滤 .efi 文件 “1”: 过滤掉 .efi 文件。默认值是 “0”，即不过滤。
`VTOY_FILE_FLT_IMG`	`STRING`	“0”: 不过滤 .img 文件 “1”: 过滤掉 .img 文件。默认值是 “0”，即不过滤。
`VTOY_FILE_FLT_VHD`	`STRING`	“0”: 不过滤 .vhd(x) 文件 “1”: 过滤掉 .vhd(x) 文件。默认值是 “0”，即不过滤。
`VTOY_FILE_FLT_VTOY`	`STRING`	“0”: 不过滤 .vtoy 文件 “1”: 过滤掉 .vtoy 文件。默认值是 “0”，即不过滤。

特殊 VTOY_DEFAULT_IMAGE 值

你可以使用一些的特殊的 VTOY_DEFAULT_IMAGE 值来实现一些特殊功能。例如：
VTOY_EXIT: Ventoy 在超时之后会自动退出
Fn>xx>xx: Ventoy 自动执行 Fn 热键内的子菜单，比如 F4>Search and boot Windows

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "VTOY_EXIT" }
    ]
}

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F2>Halt" }
    ]
}

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F4>Search and boot Windows" }
    ]
}

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F4>Boot the 1st local disk" }
    ]
}

{
    "control": [
        { "VTOY_MENU_TIMEOUT": "10" },
        { "VTOY_DEFAULT_IMAGE": "F5>Check plugin json configuration (ventoy.json)>Check theme plugin configuration" }
    ]
}