修改Sublime的注释格式

提出问题

群里有个朋友提出这个问题.

问个问题:
使用 perl 语言开发,
当我使用 command+/ 快捷键完成注释时,
他会自动在代码前面添加一个井号和空格,
问一下我要如何修改可以让他不多加这个空格呢?

我期望的注释风格是:#warn 'hello world';

So, 将解决过程记录下来.

定位问题

  • 打开Sublime的控制台(Ctrl + `), 查看启动日志.
...
ignored_packages: ["Vintage"]
pre session restore time: 0.19431
warning: mnemonic v not found in menu caption SVN
startup time: 0.26231
first paint time: 0.26631
first paint time: 0.26731
reloading plugin Default.auto_indent_tag
reloading plugin Default.block
reloading plugin Default.comment # <-- 注意这一行
reloading plugin Default.convert_syntax
reloading plugin Default.copy_path
reloading plugin Default.delete_word
reloading plugin Default.detect_indentation
reloading plugin Default.duplicate_line
...

  • Default.comment这个就是Sublime自带的文本注释代码. 修改这个文件, 就可以达到我们的目的.

  • So, 有2个思路:

  1. 解压Default.sublime-package, 修改里面的comment.py, 再打包成Default.sublime-package, 丢回安装目录.
  2. comment.py放到Package的User目录里面.

第一种方法的缺点是麻烦, 而且版本升级的时候, Default.sublime-package有可能会被覆盖.
第二种方法是正解.

解决问题

  • *.sublime-package其实是一个zip类型的文件, 可以直接解压.

  • 找到里面的comment.py文件. 内容如下:

def advance_to_first_non_white_space_on_line(view, pt):
    ...

def has_non_white_space_on_line(view, pt):
    ...

def build_comment_data(view, pt):
    ...

class ToggleCommentCommand(sublime_plugin.TextCommand):
    def remove_block_comment(self, view, edit, comment_data, region):
        ...

    def remove_line_comment(self, view, edit, comment_data, region):
        ...

    def is_entirely_line_commented(self, view, comment_data, region):
        ...

    def block_comment_region(self, view, edit, block_comment_data, region):
        ...

    def line_comment_region(self, view, edit, line_comment_data, region):
        ...

    def add_comment(self, view, edit, comment_data, prefer_block, region):
        ...

    def run(self, edit, block=False)
        ...

1个Command类, 3个方法.

无论是注释, 还是反注释. 是行注释, 还是块注释.
研究代码之后, 可知, comment_data都是由build_comment_data这个方法构造的.
So, 修改这个函数就OK了.

def build_comment_data(view, pt):
    shell_vars = view.meta_info("shellVariables", pt)
    if not shell_vars:
        return ([], [])

    # transform the list of dicts into a single dict
    all_vars = {}
    for v in shell_vars:
        if 'name' in v and 'value' in v:
            all_vars[v['name']] = v['value']

    line_comments = []
    block_comments = []

    # transform the dict into a single array of valid comments
    suffixes = [""] + ["_" + str(i) for i in range(1, 10)]
    for suffix in suffixes:
        start = all_vars.setdefault("TM_COMMENT_START" + suffix)
        end = all_vars.setdefault("TM_COMMENT_END" + suffix)
        disable_indent = all_vars.setdefault("TM_COMMENT_DISABLE_INDENT" + suffix)

        if start and end:
            #[comment by Floyda]block_comments.append((start, end, disable_indent == 'yes'))
            block_comments.append((start.strip() + "[comment by Floyda]", end, disable_indent == 'yes'))
            block_comments.append((start.strip(), end.strip(), disable_indent == 'yes'))
        elif start:
            #[comment by Floyda]line_comments.append((start, disable_indent == 'yes'))
            line_comments.append((start.strip() + "[comment by Floyda]", disable_indent == 'yes'))
            line_comments.append((start.strip(), disable_indent == 'yes'))
    return (line_comments, block_comments)

这样, 我注释过的代码, 别人即使反注释, 也是很蛋疼的 /斜眼笑
So, 群里的朋友的问题也解决了.

最后, 把comment.py丢到Package的User目录.

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

  • Sublime Text:一款具有代码高亮、语法提示、自动完成且反应快速的编辑器软件,不仅具有华丽的界面,还支持插...
    xiaotao123阅读 13,147评论 0 27
  • Sublime Text:一款具有代码高亮、语法提示、自动完成且反应快速的编辑器软件,不仅具有华丽的界面,还支持插...
    追風逸少丶阅读 13,884评论 1 34
  • Sublime Text:一款具有代码高亮、语法提示、自动完成且反应快速的编辑器软件,不仅具有华丽的界面,还支持插...
    晚晴幽草阅读 714,738评论 149 1,114
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 136,095评论 19 139
  • 下载地址:Sublime Text 原则上收费的,但可以试用,试用期是免费的,在试用期间会提示你购买. packa...
    万物皆可搬阅读 13,238评论 2 9

友情链接更多精彩内容