一、比较冷门的小技巧
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)
| 
发表于 2019-11-8 15:16:48
发表于 2019-11-8 15:29:03
楼主
