WinRar自解压注释命令

图形界面 RAR 和 ZIP 自解压模块(Default.SFX 和 Zip.SFX)
    使用这两种模块你可以创建 GUI (图形模式) 自解压文件 的 32 位 Windows 版本(Windows 95
    ，98，NT 等等)，这些模块无法在 Windows 3.1 或 DOS 下运行。
    使用 Default.SFX 模块于 RAR 压缩文件 以及 Zip.SFX 给 ZIP 压缩文件。
    这些模块均支持简易的 Setup 命令，你可以将 Setup 命令叙述添加到自解压 压缩文件注释 
    中。下面是 Setup 命令的叙述，在命令上单击可获得详细描述。
    Delete 解压前先删除文件
    License 显示程序的许可协议
    Overwrite 选择文件的覆盖模式
    Path 设置默认目标路径
    Presetup 指定解压前运行的程序
    SavePath 存储目标路径
    Setup 指定解压后运行的程序
    Shortcut 创建解压文件的快捷方式
    Silent 跳过开始时的对话框
    TempMode 解压压缩文件到临时文件夹
    Text 添加文本到自解压对话框文本窗口
    Title 设置自解压对话框标题
    这里你可以查看 完整安装脚本的简易示例。
    注意
    在自解压模块包含的 Windows 资源是允许修改成你所需要的样子的。例如，你可以在起始对话框中显示你希望的位图。自解压模块已经使用 UPX 工具压缩过，并且在编辑资源后它们是无法运行的，因此未压缩过的自解压模块在 [url]http://www.rarlab.com[/url] 的压缩文件 UnpSFX.rar 
    里。
    WinRAR 并不提供修改资源的工具或是文件，如果你要如此做的时候，你必须有资源编辑器，并知道要如何使用它们来工作。但如果标准的自解压对话框即可满足你的话，你就不需要再修改资源了。
    
    Delete=<文件名>
    在解压到目标文件夹之前删除指定的文件，允许数个 Delete 命令。
    如果在此指定的文件被锁定而无法删除，自解压模块在解压前会试着将它临时重命名，并在 Windows 重新启动时删除它，这能不能成功则取决于 Windows 版本的差异。
    示例:
    Delete=winrar95.exe
    Delete=rarlng.dll
    当运行自解压文件时显示指定的作为软件许可协议文本。用户既可以接受它并继续解压或者拒绝它并退出。
    许可可以包含HTML 或者纯文本格式。在以后的处理过程中，为了使字符串和对话框匹配，自解压模块将合并和重新格式化指定的字符串。所以如果你希望重新产生一个新的段落，你需要在它前面放一个空的字符串。
    你可以使用 HTML 来控制颜色，字体和显示的格式。HTML 语法的描述可以在 The World Wide Web Consortium 站点找到。也可以使用网页编辑程序来产生 HTML 文本。
    示例:
    License=最终用户许可协议书
    {
    所有版权于 RAR 均属于作者所专有。
    此程序是共享软件，任何人在测试期限内均可以使用此软件。
    在测试期限过后，你“必须”注册。
    }
    Overwrite=[n]
    如果[n]为 0，在覆盖文件之前用户将会被先询问。这是 覆盖 命令的默认动作，可以不需要指定。如果[n]不存在或是等于[1]，文件将在没有确认的状况下全部覆盖。如果[n]等于[2]，所有已存在的文件将不会被覆盖。
    示例:
    Overwrite=1
    Path=<路径>
    设置默认的目标路径。路径的绝对使用起始点在不更改的情况下为<驱动器号>:，如果 <路径> 
    只包含了名称，它将会被附加到“Program Files”文件夹下，如果你希望关闭如此的作用，请从“.\
    ”字符开始定义起始 <路径>。
    示例:
    a) 设置“Calc 3.05 beta”为文件夹名，位置在“Program Files”下，当成默认路径:
    Path=Calc 3.05 beta
    b) 设置“C:\Calc”当作默认路径:
    Path=C:\Calc
    c) 设置“Calc”在根目录下当作默认路径:
    Path=.\Calc
    Presetup=<程序>
    自解压在解压之前将试着运行 <程序>，在运行 <程序> 之前必须先指定目标文件夹。你可以使用此命令，比如说，当安装新版本于旧版本上面时，用以删除先前的程序版本。如果程序名包含空格，它必须包含在引号之内。
    示例:
    Presetup=uninstall.exe /clean
    SavePath
    这个命令允许自解压程序在注册表中存储用户输入的目标路径，并在自解压文件下一次运行时恢复相同的 Path。原来的 Path 命令内容被放在输入目标路径区域的列表下拉菜单中，所以用户可以在以前输入的和原始路径中选择。
    当安装新版本或更新一些软件到同样的目录时，这个功能可能很便利。它允许只改变一次目标路径，而不需要每次都输入。
    SavePath 命令只能和 Path 命令一起使用一次。
    示例:
    Path=Calc 3.05
    SavePath
    Setup=<程序>
    在成功解压之后自解压将会试着运行 <程序>。在运行 <程序> 之前，包含已解压文件的文件夹将会设为当前文件夹
    示例:
    Setup=setup.exe
    注意
    1) 如果你在使用自解压运行 InstallShield setup.exe 有问题的话，请试着运行 “setup.exe /SMS” 
    来代替简洁的 “setup.exe”。此开关允许自解压检测安装程序的退出。
    2) 全部在自解压命令行所指定的参数都会从 Setup=<程序> 命令提交给程序，自解压它自己则只认得 -s 开关，也就是强制缄默安装模式而不显示开始对话框。
    3) 自解压模块在启动安装程序前设置 sfxname 环境变量。这个变量包含自解压模块的名字，所以安装程序可以在需要这样的信息时读取它。
    shortcut=<目标类型>,<源名>,<目标文件夹>,<描述>,<快捷方式名>
    为解压的文件常见一个快捷方式。
    目标类型 是一个一个字符宽的区域，可以有下列值：
    D 在桌面创建快捷方式
    S 在开始菜单创建快捷方式
    P 在开始菜单/程序中创建快捷方式
    T 在启动菜单中创建快捷方式
    源名 是压缩文件名。
    目标文件夹 是创建快捷方式的文件夹，如果它不存在，它将被自解压文件创建。
    描述 是描述快捷方式的字符串。
    快捷方式名是由自解压创建的 .lnk(快捷方式)文件的文件名。
    所有参数用逗号分隔。如果你需要添加逗号字符在参数内，镶入整个参数引用。如果你需要在字符串中插入一个引用标记，要输入两次引号。只有 目标类型 和 源名 是必需的，其它参数可眩
    例子
    在桌面创建在 WinRAR 文件夹中连接到 winrar.exe 的快捷方式，带有“WinRAR 可执行文件”的描述和“WinRAR 压缩文件管理器”的名称：
    Shortcut=D，winrar.exe，WinRAR，“WinRAR 可执行文件”，“WinRAR 压缩文件管理器”
    Silent[=参数]
    开始解压时不显示开始对话框。 
    参数 可以是 1 或 2。如果 参数 是 1，开始解压对话框会完全隐藏，包含进程指示和文件名。如果 
    参数 是 2，则跳过开始解压的确认，但用户仍然可以看到压缩文件的解压进程。
    示例:
    Silent=2
    TempMode=[问题叙述][@窗口标题文本]
    此命令强制自解压创建一个临时目录，将全部文件解压至此，然后开始运行 Setup 命令所指定的程序，并在完成 Setup 程序之后将临时目录中的内容全部清除。当运行这些操作时，自解压会自动设置为 缄默模式。如果 TempMode 命令存在的话，叙述中将有 Setup 命令且不得使用 path 命令。
    TempMode 命令可以有字符串参数的选项，在解压之前可用以定义问题和问题的标题。这样的例子，仅在当用户选择了“是” 按钮时才会开始解压。
    示例:
    a) TempMode
    b) TempMode=你希望继续安装 Calculator 3.05 吗?, Calculator 安装程序
    此命令支持两种语法版本:
    a)
    Text=<字符串>
    b)
    Text
    {
    字符串 1
    字符串 2
    ...
    }
    它在自解压模块的输出窗口添加指定纯文本或HTML字符串。当自解压模块第一次遇到 Text 命令，在添加<字符串>前，它重设这个窗口默认内容。其后的命令追加<字符串>到已经存在的文本后。
    依赖于使用的语法，这个命令可以一次添加一个或者数个字符串。
    对于纯文本的过程中，为了使字符串和对话框匹配，自解压模块将合并和重新格式化指定的字符串。所以如果你希望重新产生一个新的段落，你需要在它前面放一个空的字符串。
    你可以使用 HTML 来控制颜色，字体和显示的格式。HTML 语法的描述可以在 The World Wide Web Consortium 站点找到。也可以使用网页编辑程序来产生 HTML 文本。
    示例:
    a) 添加单个字符串到对话框窗口
    Text=这是我的新程序
    b) 添加指定文本到对话框窗口“Text
    {
    此程序最有趣的特性是:
    - 支持 Windows 剪贴板;
    - 每一个处理的文件大小最大为 10KB;
    }
    
    Title=<标题>
    设置自解压的窗口标题。
    示例:
    Title==Calculator，版本 3.05
    自解压命令: 脚本范例
    下面脚本设置对话框标题为“Calculator 3.05”，更改对话框的显示文本，设置默认的解压路路径为“Program Files\Calculator”，启用覆盖现有文件并在解压所有文件后运行 Setup.exe。
    Title=Calculator 3.05
    Text
    {
    Calculator 是共享软件，任何人都可在 40 天
    的评估试用期间内使用此软件。
    在超过测试期限之后，如果你希望继续使用
    Calculator 的话，你“必须”注册。
    }
    Path=Calculator
    Overwrite=1
    Setup=setup.exe