About Path Matching

Some plugins of Ventoy need configuration related to file paths. For example auto install plugin:

{
    "auto_install": [
        {
            "image": "/ISO/CentOS/CentOS-7-x86_64-DVD-1810.iso",
            "template": "/ventoy/script/centos_kickstart.cfg"
        }
    ]
}

You need to specify the full path of the ISO file by image option. In addition to a fixed path, here you can also use * for fuzzy matching.
Attention: For simplicity, the * fuzzy matching here is much different with our common usage.

  • A * is fixed to match only 1 character, if you want to match multiple characters, you need to write multiple *
  • For Chinese or other wide characters, the number of * corresponds to the number of bytes in UTF-8 encoding (e.g. 1 Chinese usually requires 3 *)
  • * can only be used in the file name and cannot be used in the path part.
  • It can only be used if it is clearly stated in the documentation of the plugin.

For example: abc*.iso can match abc1.iso/abcx.iso... but cannot match abc.iso/abc12.iso/abcxxx.iso...
In fact, it is still a comparison character by character , but now it is considered to be a match when encountering *, so the length of the string must be equal.


Sample

{
    "auto_install": [
        {
            "image": "/ISO/CentOS/CentOS-7-x86_64-DVD-****.iso",
            "template": "/ventoy/script/centos7_kickstart.cfg"
        },
        {
            "image": "/ISO/CentOS/CentOS-8-***************.iso",
            "template": "/ventoy/script/centos8_kickstart.cfg"
        }
    ],
    
    "auto_memdisk": [
        "iKuai8****************************.iso"
    ],
    
    "menu_alias": [
        {
            "image": "/ISO/Ubuntu-20.**-desktop-amd64.iso",
            "alias": "Ubuntu 20"
        },
        {
            "image": "/ISO/Ubuntu-21.**-desktop-amd64.iso",
            "alias": "Ubuntu 21"
        },
        {
            "image": "/ISO/MX-19.*_x64.iso",
            "alias": "MX 19 ISO file For me"
        }
    ],
    
    "password": {
        "menupwd": [
            {
                "file":"/ISO/MX-****_x64.iso",
                "pwd":"md5#e10adc3949ba59abbe56e057f20f883e"
            }
        ]
    }
    
}