一、比较冷门的小技巧
1.列选按住Alt键进行列选,SI列选是框区域。
2.TODO注释高亮
Options->>Preferencess->>SyntaxFormatting,勾选Special comment styles。Options->>Style Properties,在Comment To Do条目设置代码高亮显示方式等。
二、宏
SI的宏很有意思,像C语言语法,可以设置快捷键,提高编程效率。网上有一个Quicker.em宏,比较强大。但是很多功能用不到,添加函数头注释要弹窗输入各个参数,编程时还是尽量少弹窗。自己写了一个,用着还挺舒服。如果有bug希望提出,我来改进。关于使用Quicker教程,网上可以找到。
0.使用方法
添加入Base工程
将miniMacro.em文件拷贝到C:\Users\你的用户名\Documents\Source Insight 4.0\Projects\Base路径下。打开SI软件,选择Project->>Open Project,然后选择Base工程,将miniMacro.em加入工程中即可。
设置快捷键
选择Options->>Key Assignments,搜索miniMacro,添加快捷键,我设置的是Ctrl+Enter。除此之外,我将快速注释宏(quickAnnotate)设为Alt+1,添加函数注释(addFuncHeader)设置为Alt+2,添加行注释(doxygenLineAnnotate)设置为Alt+3。
1.快速注释(quickAnnotate) 命令代码 "//" "///"
如果注释一块区域,需要先选中,然后执行操作。如果区域已经被快速注释,此操作变成去除注释。
如果注释一行,光标移到行的位置上,执行命令即可。
2.添加文件头注释(addFileHeader) 命令代码 "hd" "head" "header"
函数头注释,显示文件名,作者。如果第一次运行,会弹窗输入作者名,作者名会被写入注册表中,下次就不会弹窗了。若要修改保存的作者名,详见修改作者名命令(changeAuthor)。
3.格式化文档命令(formatFile) 命令代码 "fmt""format"
模仿着HAL库注释,添加一些固定的注释内容。自动识别文件类型,如果不是C代码文件,只添加文件头。如果是头文件,会将#ifndef部分添加进去,具体看演示。
4.添加doxygen注释(doxygenAddgroup)(doxygenDefgroup) 对应命令代码"add""addtogroup""def""defgroup"
可以选中一块区域,使用miniMacro命令,弹窗输入命令代码添加。此时选中区域会包含在这个注释里面。也可空位置执行,创建一个注释。
5.修改作者(changeAuthor)命令代码"changemyname"“author”
更改保存在注册表中的作者名。
6.函数头注释(addFuncHeader) 命令代码 "func" "function"
C语言函数定义很复杂,形参可以包含数组、指向函数的指针等等。可能有些情况我没考虑到,会导致识别错误。不过,按照一般的格式创建的函数,还是可以识别的。
7.doxygen块注释(doxygenVerbatim) 命令代码 "vbt" "verbatim"
注释块必须包含在已有的块注释内。会弹窗输出这段注释块的主题内容,自动居中显示。
8.行注释(doxygenLineAnnotate) 命令代码 "//"
行注释会自动识别位置。如果是注释左侧代码,会自动按照doxygen风格。此处没去实现自动右边界对其,因为需要弹窗输入注释,我不喜欢编程时太多弹窗。
9.其他说明
注释内容可以自行修改,命令代码也可更改。无命令代码的位置,执行miniMacro命令(ENTER+CTRL),会自动查找"&#&"并选中,直接输入注释内容即可。所有macro开头的函数都可以单独设置成快捷键。
三、Monokai主题
Options->Visual Theme->Manage Visual Themes,Import。选择主题文件,OK。
Debug Log:
1、$#$是SI内部字符,鼠标点击或者选中,软件会迅速用之前输入的内容替换这个字符串,如果不喜欢这个功能,可以打开宏原文件,把所有$#$替换成&#&即可。(2019.11.11)
2、增加复杂函数返回值注释功能,之前只能显示一个单词,现在更新为最多5个(比如 unsigned long long int **foo(void)),返回值可以写在函数名上一行。(2020.11.21)
3、感谢坛友@yumeng的提示,现将函数参数提取采用逐行分析的方式,函数体大小及参数行数不再会崩溃,只要参数不是近百个,基本上很快会处理完毕。(2020.11.21) |
Quicker.em
(139.76 KB, 下载次数: 333)
Monokai_theme.xml
(14.05 KB, 下载次数: 321)
miniMacro.em
(25.39 KB, 下载次数: 322)
|