【转】Sublime Text 编辑器插件之 "Sublime Alignment" 详解

最新推荐文章于 2024-04-11 19:49:58 发布

桦世兵权

最新推荐文章于 2024-04-11 19:49:58 发布

阅读量1.9k

点赞数

分类专栏： sublime 文章标签：编辑器 sublime text

sublime 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

转载地址：http://my.oschina.net/shede333/blog/170536

作者：shede333
主页：http://my.oschina.net/shede333
版权声明：原创文章，版权声明：自由转载-非商用-非衍生-保持署名 | [Creative Commons BY-NC-ND 3.0][]

Sublime Text 编辑器插件之

“Sublime Alignment” 详解

Sublime Alignment 主要用于代码对齐，最新版据说已经集成了这个插件。
下载地址：

插件安装方式、以及较好的插件推荐，如下：

Sublime Text 2 入门及技巧 | Lucifr

编码神器 Sublime Text 包管理工具及扩展大全 - 开源中国社区

Mac上的设置文件位置：
左上角Sublime Text -> Preferences -> Package Settings ->Alignment
如果没有最后的"Alignment"选项，说明你还没有安装此插件。

这里面有5个选项：

Settings- Default
Settings- User
Settings- Syntax Specific - User
Key Bildings - Default
Key Bildings - User

带有后缀Default的，为默认设置，每次升级插件都会重置这里的设置。所以尽量不要修改这里，否则升级会丢失你原先的设置。

带有后缀User的，为用户自定义设置，你可以把Default里面的设置全部复制一份到这里，然后再修改，这里存在的设置选项会覆盖Default里面的，即User的优先级更高。

Key Bildings为快捷键设置，默认的快捷键很有可能因为和其他快捷键冲突而无效，
所以及可以在Key Bildings - User里重新设置（格式可以仿照Default里的写法）。
此快捷键是用来实现对齐的。

这个插件的默认设置Settings- Default如下：

 
        { 
       
        // If the indent level of a multi-line selection should be aligned 
       
        "align_indent" 
        :  
        true 
        , 
       
        // If indentation is done via tabs, set this to true to also align 
       
        // mid-line characters via tabs. This may cause alignment issues when 
       
        // viewing the file in an editor with different tab width settings. This 
       
        // will also cause multi-character operators to be left-aligned to the 
       
        // first character in the operator instead of the character from the 
       
        // "alignment_chars" setting. 
       
        "mid_line_tabs" 
        :  
        false 
        , 
       
        // The mid-line characters to align in a multi-line selection, changing 
       
        // this to an empty array will disable mid-line alignment 
       
        "alignment_chars" 
        : [ 
        "=" 
        ], 
       
        // If the following character is matched for alignment, insert a space 
       
        // before it in the final alignment 
       
        "alignment_space_chars" 
        : [ 
        "=" 
        ], 
       
        // The characters to align along with "alignment_chars" 
       
        // For instance if the = is to be aligned, there are a number of 
       
        // symbols that can be combined with the = to make an operator, and all 
       
        // of those must be kept next to the = for the operator to be parsed 
       
        "alignment_prefix_chars" 
        : [ 
       
        "+" 
        ,  
        "-" 
        ,  
        "&" 
        ,  
        "|" 
        ,  
        "<" 
        ,  
        ">" 
        ,  
        "!" 
        ,  
        "~" 
        ,  
        "%" 
        ,  
        "/" 
        ,  
        "*" 
        ,  
        "." 
       
        ] 
       
        }

参数详解

下面为原始测试数据

1

2

3

4

“align_indent”:

开关量，默认为true,

true，则把选择的多行的不同缩进级别也变成相同的缩进（最大的缩紧级别），结果如下：

1

2

3

4

flase，只是对齐，不改变缩进级别

1

2

3

4

 
        int 
         aa            =  
        1 
        ; 
       
 
             
        char 
         bb       =  
        'a' 
        ; 
       
 
                 
        float 
         fff =  
        2 
        ; 
       
 
        unsigned  
        int 
         d    =  
        1 
        ; 
       

“mid_line_tabs”

开关量，默认为false。
如果你的文本是使用Tab键缩进排版，设置该变量为true时，那么该插件在对齐文本的时候也使用Tab键来对齐缩进。
但是这样可能会出现问题，因为Tab键在不同的编辑器上代表的空格数可能不同（Sublime 是代表4个空格），
当你使用别的编辑器打开该文件时，简而言之，就是排版可能就不是对齐的了。

“alignment_chars”

即对齐字符

这是一个数组，可以这样设置多个字符：alignment_chars": ["=","*","a"]
默认只有“＝”字符，即alignment_chars": ["="]
数组里面的字符就是放在中线对齐的字符。
如下面都把“＝”排成一列中线对齐

1

2

3

4

 
        int 
         aa         =  
        1 
        ; 
       
 
                 
        char 
         bb        =  
        'a' 
        ; 
       
 
                 
        float 
         fff      =  
        2 
        ; 
       
 
                 
        unsigned  
        int 
         d =  
        1 
        ; 
       

例如设置里增加“*”号，即：alignment_chars": ["=","*"]
结果如下：

原文：

1

2

3

4

排列对齐后：(把“*”号排成对齐的一列)

1

2

3

4

“alignment_space_chars”

和“alignment_chars”一样，也是数组格式
默认值包含“＝”号，即：alignment_space_chars": ["*","="]

就是这个数组包含上面“alignment_chars”里的字符，
对齐后，在其前面增加一个空格。
如果这里不包含“alignment_chars”里的字符，对齐后，在其前面没有空格。

可以这样说，
“alignment_space_chars”数组是“alignment_chars”数组的子集。

原文还在文章的起始处，这里设置包含“＝”，
即alignment_space_chars": ["="]，
结果如下：

1

2

3

4

 
        int 
         aa         =  
        1 
        ; 
       
 
                 
        char 
         bb        =  
        'a' 
        ; 
       
 
                 
        float 
         fff      =  
        2 
        ; 
       
 
                 
        unsigned  
        int 
         d =  
        1 
        ; 
       

这里设置不包含任何字符，
即alignment_space_chars": []，
结果如下：

1

2

3

4

 
        int 
         aa        =  
        1 
        ; 
       
 
                 
        char 
         bb       =  
        'a' 
        ; 
       
 
                 
        float 
         fff     =  
        2 
        ; 
       
 
                 
        unsigned  
        int 
         d=  
        1 
        ; 
       

“alignment_prefix_chars”

即：前缀字符
默认设置：
"alignment_prefix_chars": ["+", "-", "&", "|", "<", ">", "!", "~", "%", "/", "*", "."]

对齐字符（即alignment_chars"里的字符）,可以拥有前缀字符。
例如”=“号字符前可以拥有以上字符作为前缀。

原文设置如下：（这里的前缀字符有 “!“、“<“符号）

1

2

3

4

对齐后如下：（即把前缀字符+对齐字符一起当作对齐字符来对待）

1

2

3

4

 
        int 
         aa         =  
        1 
        ; 
       
 
                 
        char 
         bb        !=  
        'a' 
        ; 
       
 
                 
        float 
         fff      <=  
        2 
        ; 
       
 
                 
        unsigned  
        int 
         d =  
        1 
        ; 
       