# **宏指令** 本篇为进阶篇,通过学习本篇,你可以掌握 Alterful 的增强功能即宏指令的使用。 宏指令可以说是整个 Alterful 中相当精彩的一章,通过宏指令不仅能完成对 Alterful 自身的一些设置,还能实现许多让人感到舒爽的快捷操作,具体请看下面的详解。 --- ### 宏原型 **``@``** + **``宏指令``** + **``···``** ### 宏指令表 | 宏指令 | 功能 | | --- | --- | | @add a b | 添加启动项a,指向路径为b | | @add a b | 添加启动项a,路径为启动项b所指向的路径 | | @del a | 删除启动项a | | @add #a b | 添加常引用a,引用值为b | | @del #a | 删除常引用a | | @new file in directory | 在某位置中新建一个文件并打开(含后缀) | | @locate a | 定位到启动项a所在目录 | | @set [prop] [value] | 查看可选设置 / 查看设置值 / 设置 | | @restart | 重新启动 Alterful | | @update | 检查新版本并更新 | | @locate a b ... | 在资源管理器中定位启动项 a, b, ... | | @version | 检查本地当前版本 | ## **添加宏(@add)** - 添加启动项:`@add 自定义启动名 文件路径` 例子:`@add chrome C:\Program Files (x86)\Google\Chrome\Application\chrome.exe` 作用:将 Chrome 添加为 Alterful 启动项,启动名为 chrome。 效果:使用热键 Alt + A 唤出 Alterful 指令框,键入 chrome 回车,Chrome 被打开。 > 扩展语法: > 创建启动别名:@add 自定义启动名 源启动名 > 例子:`@add llq chrome` > 作用:创建 llq 启动名,指向 chrome 所指向的启动项路径 > 效果:在 Alterful 指令框中键入 chrome 或 llq 均可启动 Alterful - 添加常引用:`@add #常引用名 常引用内容` 例子:`@add #bing chrome/bing.com` 作用:将 chrome/bing.com 添加为 Alterful 常引用项,引用名为 bing。 效果:使用热键 Alt + A 唤出 Alterful 指令框,键入 `#bing` 回车,必应在 Chrome 中被打开。 > 常引用扩展: > 使用加号进行常引用衔接:[指令段1 + ] #常引用 [ + 指令段2] > 例子:`@add #fy chrome/fanyi.baidu.com/#zh/en/` > 使用:`#fy+键盘增强` > 效果:在 Chrome 中打开了百度翻译,并显示“键盘增强”的中译英结果 - 添加常指令:`@add 常指令名([可选参数1], [可选参数2], ..., [可选参数n])` 例子:@add CreateDirectoryC(DirName),回车后键入以下 cmd 代码,使用热键 Alt + S 确认编辑 ``` > cd c:\ > mkdir DirName ``` 作用:创建并存储自定义常指令 CreateDirectoryC,用于在 C 盘创建一个文件夹 效果:使用热键 Alt + A 唤出 Alterful 指令框,键入 CreateDirectoryC(TestDir) 回车,C 盘下创建了 TestDir 文件夹 ## **删除宏(@del)** - 删除启动项:`@del 启动名` 例子:`@del chrome` 作用:删除启动名 chrome > 扩展语法: > 同时删除多个启动名:@del 启动名1 启动名2 ... 启动名n > 例子:@del chrome llq > 作用:同时删除启动名 chrome 和 llq - 删除常引用:`@del #常引用名` 例子:`@del #bing` 作用:删除常引用 bing - 删除常指令:`@del 常指令名(\[参数签名\])` 例子:`@del CreateDirectoryC(p1)` 作用:删除带有一个参数的 CreateDirectoryC 常指令 ## **设置宏(@set)** - 查询可设置项:`@set` - 查询设置项的现行值和可选值:`@set 设置项` 例子:@set Theme 作用:查看 Alterful 可选主题及现行主题 - 设置设置项的现行值:`@set 设置项 设置值` 例子:@set Theme Docks 作用:将 Alterful 主题设置为 Docks ## **新建宏(@new)** - 创建临时文件并打开:`@new 文件名.文件扩展名` 例子:`@new Demo.docx` 作用:在 Alterful\\ATemp 文件夹下创建并打开了临时文档 Demo.docx - 在指定目录下创建临时文件并打开:`@new 文件名.文件扩展名 in 创建路径` 其中创建路径可以是具体路径,也可以是任意启动名。对于以启动名作为启动路径的,若启动项是目录则在相应目录下创建文件,若启动项是特定文件则在启动项同级目录下创建文件 例子:`@new wallpaper.psd in psd`,其中 psd 是目录启动项 作用:在 psd 目录下创建并打开了文档 wallpaper.psd ## **定位宏(@locate)** - 定位到启动项目录:`@locate 启动名1 [启动名2 ...]` ## **版本宏(@version)** - 检查当前本地版本:`@version` ## **预设指令** 尚未完成重构